首先介绍关于SharePoint对象模型的开发简单的入门
SharePoint对象模型概述
一些基本对象
Farm, Service, Web Application, Site, Web
List, View, Field, Item
几个主要功能
文件结构
权限系统
查询
集合(Collection)
很多对象都有集合
SPWeb–SPWebCollection
SPList - SPListCollection
…
操作
Get:xxCollection[idx], xxCollection.GetxxxByxxx
Add: xxCollection.Add
Del: xxCollection.Delete, xx.Delete, xx.Recycle
Update: xx.Update
集合(Collection)
向下访问
site.AllWebs
web.Lists
list.Views
…
向上访问
web.Site
list.ParentWeb
view.ParentList
…
四种Url
absolute url
http://moss/sites/myweb/doc/folder/file.doc
server-relative url
/sites/myweb/doc/folder/file.doc
xx.ServerRelativeUrl
site-relative url
doc/folder/file.doc
xx.Url
relative url
file.doc (base = folder)
服务器场
SPFarm
SPFarm.Local 当前服务器场
内容服务
SPWebService
SPWebService.ContentService 当前内容服务
webService.WebApplications
Web应用程序
SPWebApplication
webApp.Sites
网站的获取
通过SPSite的构造函数获取网站集
使用absolute url
site.AllWebs[idx]
site.RootWeb
site.OpenWeb()
顶级站点与子站点
SPContext.Current
在Context环境下使用
最经常用到的容器
列表:web.Lists
文件:web.Files
文件夹:web.Folders
用户:web.Users
组:web.Groups
回收站:web.RecycleBin
SPList
SharePoint中最主要的数据容器
内容
list.Items
list.Views
list.Fields
list.Folders(*)
SPList
几个属性
BaseType和BaseTemplate
RootFolder
列表的获取
web.Lists[idx]
web.GetList()
server-relative url
web.GetListFromUrl()
web.GetListFromWebPartPageUrl()
site-relative url
web.GetListsOfType()
SPView
显示的渠道
视图包含
Query:筛选和排序
ViewFields:显示的字段
SchemaXml:基本设置
ViewBody等:显示样式
Url:视图的地址
SPView
获取
list.Views[idx]
Guid, index, name
list.GetView()
Guid
web.GetViewFromUrl()
server-relative url
SPField
SPField (Base Class)
SPFieldText
SPFieldComputed
SPFieldMultiChoice
SPFieldChoice
SPFieldLookup
SPFieldUser
…
SPField
几个属性
Title(显示名称)和InternalName(内部名称)
Type:类型
SchemaXml:基本设置
获取
fields[idx]
index, display name
fields.GetField()
fields.GetFieldByInternalName()
SPListItem
获取
items[idx]
items.GetItemById(), list.GetItemById()
list.GetItemByUniqueId()
list.GetItems()
新建
items.Add() -> modify -> item.Update()
SPFile和SPFolder
获取
web.GetFile(), web.GetFolder()
web.RootFolder, list.RootFolder(*)
folder.Files, folder.SubFolders
foreach遍历需要“浏览目录”权限
特殊的列表SPDocumentLibrary
继承自SPList
属性
IsCatalog:默认的一些模版库、Web部件库、母版库
下面介绍一个简单的Demo
访问文档库遍历里面所有的文件和文件夹
SPWeb web = (new SPSite("http://moss/sites/hello")).OpenWeb();
SPDocumentLibrary doclib = (SPDocumentLibrary)web.Lists["共享文档"];
doclib.Lists.IncludeRootFolder = true;
GoThroughDocLib(doclib, doclib.RootFolder, 0);
static void GoThroughDocLib(SPDocumentLibrary doclib, SPFolder folder, int level)
{
SPListItemCollection items = doclib.GetItemsInFolder(doclib.DefaultView, folder);
if (items.Count == 0)
return;
for (int i = 0; i < level; i++)
Console.Write(" ");
foreach (SPListItem item in items)
{
if (item.FileSystemObjectType == SPFileSystemObjectType.Folder)
{
Console.WriteLine("[{0}]", item.Name);
GoThroughDocLib(doclib, item.Folder, level + 1);
}
else
Console.WriteLine(item.Name);
}
}