WSS 3.0 对象模型

1.SPWebApplication包含网站集，是网站集的容器。
获取当前系统下所有Web应用程序的集合：
SPWebApplicationCollection
webs =
SPWebService.ContentService.WebApplications;

2.SPSite和SPWeb
(1).SPSite:WebApplication下的网站集。SPSite的RootWeb代表网站集的顶级网站（首要网站）。
(2).SPWeb:代表网站集下的每个站点和子站点。访问站点的内容从SPWeb开始。
(3).关系:网站集SPSite是SPWeb的集合。
(4).获取网站
SPSite
site = new
SPSite("http://yang:9000");

使用AllWebs得到知识库子站点kb：
SPWeb
web =
site.AllWebs['kb'];

使用OpenWeb得到知识库子站点kb：
SPWeb
web =
site.OpenWeb("kb");
注意：OpenWeb方法中的参数是一个相对的地址。
(5).当在SharePoint环境中开发时，可以使用Http当前上下文Context来取得当前URL所对应的站点：
利用SPControl控件的上下文：
SPWeb
web =
SPControl.GetContextWeb(Context);

利用WSS对象的上下文SPContext
SPWeb
web =
SPContext.Current.Web;

顶级网站（首要网站）访问子网站kb下的KB列表：
string
listname = "KB";
SPWeb web =
SPControl.GetContextWeb(Context).Webs["kb"];
SPList
treeList =
web.Lists[listname];

子站点访问顶级网站（首要网站）下的tree分类列表：
string
sourceTreeList = "tree";
SPWeb rootweb =
SPControl.GetContextSite(Context).RootWeb;
SPList
treeList =
rootweb.Lists[sourceTreeLis];

3.列表对象
对象
说明
SPList
列表对象
SPListCollection
列表集合。SPWeb.Lists返回网站所有列表的集合
SPListItem
列表的项
SPListItemCollection
列表项的集合。SPList.Items返回列表的所有列表项
SPViewCollection
视图集合对象
SPViewFieldCollection
视图字段集合
SPView
视图对象
SPDocumentLibrary
特殊的列表-文档库对象
SPField
列表字段
SPFieldCollection
列表字段集合

(1).获取列表Case
SPWeb
web = SPControl.GetContextWeb(Context);
SPList list
= web.Lists["Case"];

(2).添加列表
SPWeb web
= SPControl.GetContextWeb(Context);
SPList list =
web.Lists["Case"];
SPListItemCollection lists =
list.Items;
SPListItem listItem =
list.Items.Add();
listItem["标题"] =
this.txtTitel.Text;
listItem["分类"] =
getTypeName();
listItem.Update();

(3).得到列表项
SPWeb
web = SPControl.GetContextWeb(Context);
SPList list
=
web.Lists["Case"];
//得到列表项的ID
Int
ID=1;
SPListItem listItem =
list.Items.GetItemById(ID);
if(listItem["分类"]
!=null)
{
this.Label1.Text
=
listItem["分类"].ToString();
}

(4).列表循环输出
SPSite
site = new SPSite("http://yang:9000");
SPWeb spweb =
site.OpenWeb();

SPList list =
spweb.Lists["Case"];
SPListItemCollection listitems
= list.Items;
foreach(SPListItem listitem in
listitems)
{
this.textbox1.Text
+= listitem["标题"].ToString() +
Environment.NewLine;
}

(5).删除列表
SPSite
site = new SPSite("http://yang:9000");
SPWeb web =
site.OpenWeb();
SPListCollection lists =
web.Lists;
//删除Case列表
SPList
list = lists["case"];
System.Guid listGuid =
list.ID;
lists.Delete(listGuid);

(6).操作视图
SPSite
site = new SPSite("http://yang:9000");
SPWeb spweb =
site.OpenWeb();
SPList list =
spweb.Lists["Case"];

//Case列表下的所有视图
SPViewCollection
listitems =
list.Views;
MessageBox.Show(listitems.Count.ToString());

//列出标题
foreach(SPView
oViewSrc in
listitems)
{
this.textbox1.Text
+= oViewSrc.Title +
Environment.NewLine;
}

//得到单个视图的信息
Guid
viewguid = list.Views["我的日常工作"].ID;
SPView
sv=list.GetView(viewguid);

SPListItemCollection
collItemsSrc =
list.GetItems(sv);
SPViewFieldCollection
collViewFields =
sv.ViewFields;

foreach(SPListItem oItemSrc in
collItemsSrc)
{
for(int
intIndex=0; intIndex<collViewFields.Count;
intIndex++)
{
this.textbox1.Text
+= collViewFields[intIndex].ToString() + "::" +
oItemSrc[collViewFields[intIndex]].ToString() +
Environment.NewLine;;
}
}

(7).列表到DataTable
a.使用SPListItemCollection列表项的集合对象的GetDataTable方法
private
DataTable
GetData()
{
string
sourceTreeList = "tree";
SPWeb
rootweb =
SPControl.GetContextSite(Context).RootWeb;
SPList
treeList =
rootweb.Lists[sourceTreeList];
SPListItemCollection
Items = treeList.Items;
return
Items.GetDataTable();
}

b.自定义实现列表对象转化为DataTable
string[]
pSourceSPListFields =
{"ClassID","ClassName","ParentID"};

private
DataTable _sourceDataTable;
private DataTable
ListToDataTable()
{
//构造表头
this._sourceDataTable
=
this.ColumnNameDataTable();
SPWeb
web =
SPControl.GetContextWeb(Context);
SPList
treeList =
web.Lists[sourceTreeList];
DataTable
dt = new
DataTable();
SPListItemCollection
caseItems =
treeList.Items;

foreach(SPListItem
caseItem in
caseItems)
{
try
{
DataRow
rowNew=
_sourceDataTable.NewRow();
for(int
intI=0;intI<this.pSourceSPListFields.Length;intI++)
{
if(caseItem[pSourceSPListFields[intI]]
!=
null)
{
if(treeList.Fields[this.pSourceSPListFields[intI]].FieldValueType.ToString()
==
"Microsoft.SharePoint.SPFieldUserValue")
{
string
createUserName =
caseItem[this.pSourceSPListFields[intI]].ToString();
int
index =
createrUserName.Indexof(';');
int
createrUserID=
Convert.ToInt32(createUserName.Substring(0,index));
SPUser
createrUser =
web.AllUsers.GetByID(creater.UserID);
rowNew[pSourceSPListFields[intI]]
=
createrUser.Name;
}
else
{
Object
columnType=
_sourceDataTable.Columns[this.pSourceSPListFields[intI]].DataType;
rowNew[pSourceSPListFields[intI]]
=
caseItem[pSourceSPListFields[intI]];
}
}
}
_sourceDataTable.Rows.Add(rowNew);
}
catch
{
}
return
this._sourceDataTable;
}
}

构造表头
public DataTable
ColumnNameDataTable()
{
SPWeb web =
SPControl.GetContextWeb(Context);
SPList treeList =
web.Lists[sourceTreeList];
DataTable dt = new
DataTable();
SPListItemCollection castItems =
treeList.Items;

for(int intI=0;
intI<pSourceSPListFields.Length;intI++)
{
DataColumn
columnNew = new
DataColumn();

columnNew.ColumnName =
pSourceSPListFields[intI];
dt.Columns.Add(columnNew);
}
return
dt;
}

调用过程
private
DataTable
GetData()
{
return
ListToDataTable();
}

4.操作文档库
文档库具有列表的所有属性，但是作为文档库又具有文件格式的所有属性。列表中每个项目可以使用SPListItem对象来操作。文档库中的项目则可以使用SPFile对象来操作。
SPSite
site = new SPSite("http://yang:9000/kb");
SPWeb spweb =
site.OpenWeb();
SPFolder myFolder =
spweb.GetFolder("kb");
SPFileCollection myFiles =
myFolder.Files;

FileStream fStream =
File.OpenRead(@"c:/aaa.txt");
byte[] contents = new
byte[fStream.Length];
fStream.Read(contents,0,(int)fStream.Length);
fStream.Close();

string
path = site.Url + "/kb/KB/";
string filename=
DateTime.Now.ToString().Replace(" ","").Replace(":","")+".txt";
SPFile file =
myFile.Add(path+filename,contents);
file.Item["知识库标题"] =
"测试知识库";
file.Item["分类"] = 4;
file.Item.Update();

使用SPFolder
myFolder=spweb.GetFolder("kb")代码段来得到文档库KB的文件夹。
之后使用SPFileCollection myFiles =
myFolder。Files来得到文件集合。然后使用myFiles.Add对象来添加一个文本文件，这里可以为任意文件。最后通过file对象的item来赋值并完成更新操作。

当然，还可以用操作列表的方法来操作文档库。通过file对象能够获取文件的版本、大小等信息。

5.操作用户和用户组

用户和用户组的对象模型
对象
说明
SPUSer
用户对象、域用户或者表单验证用户
SPUserCollection
用户对象的集合
SPGroup
用户组
SPGroupCollection
用户组的集合

(1).得到站点下所有的用户
SPSite
site = new SPSite("http://yang:9000");
SPWeb web=
site.OpenWeb();
foreach(SPUser user in
web.SiteUsers)
{
this.textbox1.Text += user.Name +
Environment.NewLine;
}

(2).得到站点小所有的用户组
SPSite site = new
SPSite("http://yang:9000");
SPWeb web= site.OpenWeb();
foreach(SPGroup
group in web.Groups)
{
this.textbox1.Text += group.Name +
Environment.NewLine;
}

6.查询
通过SPQuery类来完成对列表的查询操作。

SPQuery类的属性说明
属性
说明
ViewFields
查询结果中要显示的字段。这个属性的设置如：<FieldRef
Name="Title" />
Query
查询条件包括分组与排序条件
RowLimit
返回结果的行数

其中查询条件的设置需要满足CAML（协作应用程序标记语言）的语法标准。
CAML语言的操作符说明
操作符
说明
Geq
>=
EQ
=
Gt
>
Lt
<
Neq
!=
Contains
包含

使用CAML查询有一点需要清楚，在CAML语法中使用的字段名并不是创建的字段名，而是MOSS系统内部的名称InternalName，代码如下：
SPSite
site = new SPSite("http://yang:9000");
SPWeb spweb =
site.OpenWeb();
SPList list= spweb.Lists["case"];

SPListItemCollection
myItems = list.Items;
SPListItem item = myItems[0];
for(int
i=0;i<item.Fields.Count;i++)
{
this.textbox1.Text +=
item.Fields[i].Title + ":" + itme.Fields[i].InternalName +
Environment.NewLine;
}

通过运行结果，看到前面的正是MOSS中创建的字段，而冒号之后的则是系统内部处理的名称。如果把一个栏删除，再添加同样的栏，相应的InternalName会发生变化，需要重新获取。
接下来进行CAML的查询，从列表Case的标题中找到包含“计算机”的记录，并且显示5条。
在界面上增加了一个dataGridView表格控件。代码如下：
SPSite
site = new SPSite("http://yang:9000");
SPWeb spweb =
site.OpenWeb();
SPList list = spweb.Lists["case"];

SPQuery query = new
SPQuery();
query.ViewFields= "<FieldRef Name='Title'/><FieldRef
Name='_x95ee_x9898_x89e3_x51b3_x65'/><FieldRef
Name='Created'/>";
query.Query="<Where><Contains><FieldRef
Name='Title'/><Value
Type='Text'>计算机</Value></Contains></Where>";
query.RowLimit=5;

SPListItemCollection
myItems = list.GetItems(query);
this.dataGridView1.DataSource =
myItems.GetDataTable();

注意这个表格显示了标题、故障情况说明和创建时间。其中_x6545_x969c_x60c5_x51b5_x8b是故障情况说明字段的InternalName。如果把代码中<FieldRef
Name='Title'/>改成<FieldRef
Name='标题'/>,即：
query.Query="<Where><Contains><FieldRef
Name='标题'/><Value
Type='Text'>计算机</Value></Contains></Where>";
则系统会报告一个错误，如下：
一个或多个域类型未正确安装。请转到类表列表设置页删除这些域。