?

本節(jié)將會介紹SharePoint中最為常用的一些對象模型，以及如何使用這些對象模型來訪問和操作網(wǎng)站中的數(shù)據(jù)。幾乎所有的SharePoint服務(wù)器端開發(fā)都會涉及到這些內(nèi)容，因此應(yīng)著重掌握本節(jié)中所介紹的基本對象模型的使用方法。由于篇幅所限，在介紹每種對象的時候只能闡述一些最為常用和重要的屬性及方法，以及一些容易混淆或出錯的內(nèi)容。更加完整的屬性、方法的定義、介紹和代碼示例片段，請參考SDK中類庫索引中相關(guān)章節(jié)。

網(wǎng)站中一些常用對象的結(jié)構(gòu)大概如下圖所示（從SharePoint 2003起，這部分內(nèi)容在結(jié)構(gòu)上未曾發(fā)生根本性的變動）：

??

（一）網(wǎng)站集（SPSite）和網(wǎng)站（SPWeb）

網(wǎng)站是SharePoint基本對象模型之一，由于SharePoint的數(shù)據(jù)基本上全部都容納在網(wǎng)站中，因此絕大多數(shù)的SharePoint程序都要先從獲取網(wǎng)站開始。

SPSite 對應(yīng)的是站點集 （sitecollection）,站點集只能總管理中心創(chuàng)建, 從某種程度上來說，也可以理解為根站點；
SPWeb對應(yīng)的是站點(Site)， 站點是從當(dāng)前站點創(chuàng)建的，站點下面還可以包括站點；
如果你是學(xué)習(xí)開發(fā)，那么這段代碼是你常用的：
using(SPSite oSiteCollection = new SPSite("http://Server_Name"))
{
? ? using(SPWeb oWebsite = oSiteCollection.OpenWeb("Website_URL"))
? ? {
? ? ? ? SPList list=oWebsite.Lists["mylist"];
? ...
? ? }
}
更多的內(nèi)容請參考 SDK：http://msdn.microsoft.com/zh-cn/library/microsoft.sharepoint.spsite.aspx

1、網(wǎng)站集和網(wǎng)站的關(guān)系

網(wǎng)站集（Site Collection）顧名思義，是網(wǎng)站的集合，每個網(wǎng)站集中必須有一個頂級網(wǎng)站（或稱為首要網(wǎng)站），而每個網(wǎng)站可以有0至多個子網(wǎng)站，從而構(gòu)成一棵網(wǎng)站結(jié)構(gòu)樹，在這棵樹上的所有網(wǎng)站構(gòu)成了整個網(wǎng)站集。在SharePoint中，網(wǎng)站集幾乎只是一個被架空的概念，其作用只是將一個相對完整的整體性應(yīng)用集中組織起來，控制應(yīng)用中的母版頁、Web部件、網(wǎng)站集功能等配置。網(wǎng)站集這個本身不儲存任何數(shù)據(jù)，諸如Web部件、母版頁、列表模板、網(wǎng)站模板、網(wǎng)站集解決方案等均存儲在網(wǎng)站集的頂級網(wǎng)站中。在SharePoint對象模型中，網(wǎng)站集使用SPSite對象表示，SPSiteCollection（SPSiteCollection包含在Microsoft.SharePoint.Administration這個命名空間中，而本節(jié)涉及到的其他類均包含在Microsoft.SharePoint命名空間中）表示網(wǎng)站集的集合。

網(wǎng)站是SharePoint中最經(jīng)常使用到的對象模型之一，網(wǎng)站中包含的列表、文檔庫、文件等內(nèi)容都是在SharePoint開發(fā)過程中最經(jīng)常涉及到的對象。網(wǎng)站使用SPWeb對象表示，SPWebCollection表示網(wǎng)站的集合。請注意在對象模型中“網(wǎng)站的集合”（SPWebCollection）與“網(wǎng)站集”（SPSite）這幾個概念的關(guān)系和區(qū)別。

?

2、網(wǎng)站集的獲取

在控制臺程序等運行在服務(wù)器上的客戶端程序中，由于沒有IIS的上下文（Context）環(huán)境，必須要通過絕對路徑獲取網(wǎng)站集對象，再獲得其中的網(wǎng)站對象。

網(wǎng)站集的獲取使用SPSite的構(gòu)造函數(shù)進行，一般來說，經(jīng)常使用的一個重載如下（假設(shè)我們的網(wǎng)站地址為：http://sp2010/book，一個子網(wǎng)站）：

1: SPSite site = new SPSite("http://sp2010/book");

在該構(gòu)造函數(shù)中，必須要使用完整的絕對Url路徑，但該Url不一定要限制為網(wǎng)站的根路徑，可以為該網(wǎng)站下的任何一個路徑（甚至是不存在的文件地址），例如使用Url：“http://sp2010/book/chapters/part1/ch02.docx”作為參數(shù)，同樣可以返回同一個網(wǎng)站集，即使后面的文檔庫、文件夾或文件都不存在也沒有關(guān)系（但并不建議這樣使用）。

?

3、網(wǎng)站的獲取

當(dāng)獲取到一個網(wǎng)站集的SPSite對象之后，有三種方式獲取到其中的網(wǎng)站：（1）RootWeb屬性；（2）AllWebs屬性；（3）OpenWeb方法。

（1）RootWeb屬性返回網(wǎng)站集中的根網(wǎng)站，即頂級網(wǎng)站。

（2）AllWebs屬性是SPWebCollection類型，返回網(wǎng)站集中的所有網(wǎng)站。當(dāng)要獲取到其中某一個網(wǎng)站的時候，可以使用3種索引器：

• AllWebs[idx]：int型索引器，根據(jù)下標(biāo)順序獲取，幾乎很少使用這種方式；
• AllWebs[id]：Guid型索引器，根據(jù)網(wǎng)站Guid獲取；
• AllWebs[url]：string型索引器，根據(jù)網(wǎng)站的相對路徑（相對根網(wǎng)站的路徑）獲取。

（3）OpenWeb方法按照參數(shù)類型不同的重載，也有如下的使用方式：

• OpenWeb()：無參數(shù)。返回構(gòu)造SPSite時所使用的Url所對應(yīng)的網(wǎng)站，這是一種比較常用的方法，如果使用的是頂級網(wǎng)站的Url構(gòu)造SPSite，則該方法返回的就是頂級網(wǎng)站；如果使用的是子網(wǎng)站的Url構(gòu)造SPSite，則該方法返回的就是相應(yīng)的子網(wǎng)站。
• OpenWeb(Guid id)：使用網(wǎng)站的Guid返回網(wǎng)站。
• OpenWeb(string url)：使用網(wǎng)站的相對路徑（相對服務(wù)器路徑或相對頂級網(wǎng)站的路徑）返回網(wǎng)站。

例如，可以使用如下的方法來獲取網(wǎng)站：

1: SPSite site1 = new SPSite("http://sp2010/book"); 2: SPWeb web1 = site1.OpenWeb(), 3: theSameAsWeb1 = site1.AllWebs["book"]; 4:? 5: SPSite site2 = new SPSite("http://sp2010"); 6: SPWeb web2 = site2.OpenWeb(), 7: theSameAsWeb2 = site1.RootWeb, 8: anotherWeb1 = site2.OpenWeb("book");

（這部分代碼并不完整，詳見后面的說明）

?

4、特殊的網(wǎng)站和網(wǎng)站集獲取方法

之前所介紹的一些獲取方法可以隨時使用，但是當(dāng)程序運行在IIS進程中時（比如Web頁面、Web部件、一些類型的事件處理程序、工作流等），由于有上下文（Context）的存在，可以很方便的獲取到程序所在的當(dāng)前網(wǎng)站集和當(dāng)前網(wǎng)站：

1: SPSite currentSite = SPContext.Current.Site; 2: SPWeb currentWeb = SPContext.Current.Web;

?

?

5、網(wǎng)站集和網(wǎng)站的常用屬性

SPSite的常用屬性：

名稱	類型	說明
AllWebs	SPWebCollection	網(wǎng)站集中的所有網(wǎng)站
RootWeb	SPWeb	網(wǎng)站集的根網(wǎng)站（頂級網(wǎng)站）
Url	string	網(wǎng)站集的絕對路徑（實際上就是頂級網(wǎng)站的絕對路徑）

?

SPWeb的常用屬性：

名稱	類型	說明
RootFolder	SPFolder	網(wǎng)站的根目錄
Site	SPSite	網(wǎng)站所在的網(wǎng)站
Title	string	網(wǎng)站標(biāo)題
Name	string	相對父網(wǎng)站的Url（不是網(wǎng)站名稱，不要被這個屬性的名字迷惑）
Url	string	網(wǎng)站的絕對路徑
Webs	SPWebCollection	網(wǎng)站的子網(wǎng)站（不包含孫網(wǎng)站）

?

由于幾乎所有常用的對象模型都是依附于網(wǎng)站的，這些對象的訪問也基本都以SPWeb作為起點，因此涉及到SPWeb中包含的其他對象操作訪問的屬性和方法，將在后文具體介紹到相應(yīng)對象的時候再做詳細說明。

?

6、網(wǎng)站集和網(wǎng)站的釋放

由于SPSite和SPWeb的一些內(nèi)部屬性中，使用到了非托管資源，而這些非托管資源不受.NET的垃圾回收機制控制，因此在使用完SPSite和SPWeb對象之后，一個良好的習(xí)慣是手動將其釋放掉，釋放的方法是調(diào)用其Dispose方法。例如：

1: SPSite site = new SPSite("http://sp2010/book"); 2: SPWeb web = site.OpenWeb(); 3: // use the web and site 4: web.Dispose(); 5: site.Dispose();

當(dāng)然，更方便的一種方式是使用C#中的using關(guān)鍵字，從而在使用完之后自動調(diào)用其Dispose方法。因此，一般而言，常用的寫法是下面這種形式：

1: using(SPSite site = new SPSite("http://sp2010/book")) 2: { 3: using(SPWeb web = site.OpenWeb()) 4: { 5: // use the web and site 6: } 7: }

在SharePoint應(yīng)用中，幾乎所有返回的SPSite和SPWeb對象都需要上述釋放過程。但是使用SPContext.Current方式獲取的SPSite和SPWeb不可以釋放！否則會觸發(fā)一些意外情況，SharePoint運行時會自動控制這兩個對象的生命周期。

總結(jié)

以上是生活随笔為你收集整理的【转】2.1 SharePoint服务器端对象模型 之 访问网站和列表数据（Part 1）的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。