SPListCollection class

發行項
05/05/2015

表示SPList物件的集合。

Inheritance hierarchy

System.Object
  Microsoft.SharePoint.Administration.SPAutoSerializingObject
    Microsoft.SharePoint.SPBaseCollection
      Microsoft.SharePoint.SPListCollection

Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'宣告
Public Class SPListCollection _
    Inherits SPBaseCollection
'用途
Dim instance As SPListCollection

public class SPListCollection : SPBaseCollection

備註

使用SPWeb類別的Lists屬性來傳回SPListCollection物件，表示集合的清單在網站中，或使用SPList類別的Lists屬性來傳回SPListCollection物件，表示清單的父清單集合。若要建立清單，使用其中一個SPListCollection的Add方法。

若要從集合傳回單一清單中使用索引子。例如，假設集合指派給變數，名為collLists，使用在 C# 的collLists[index]或collLists(index) Visual Basic，其中index是在集合中，清單的顯示名稱清單的索引編號，或清單的 GUID。

如果正在執行的程式碼的使用者具有完整權限清單，但並沒有權限到站台，使用 GUID 索引子，傳回清單的網站中的清單集合。否則，因此使用者不允許列舉集合的清單，如同您使用名稱索引子時，會傳回拒絕存取」錯誤訊息。GUID 索引子可讓項目直接存取，因為 GUID 清單的資料庫資料表的Microsoft SharePoint Foundation的主索引鍵。

Examples

下列程式碼範例會逐一查看的網站集合中的所有網站的所有清單，並顯示每個清單和網站的名稱。此範例假設包含一個標籤控制項的.aspx 網頁的存在。

這個範例要求using指示詞 (在 Visual Basic 的Imports ) 的Microsoft.SharePoint和Microsoft.SharePoint.Utilities命名空間。

Dim site As SPSite = SPControl.GetContextSite(Context)
Dim allSites As SPWebCollection = site.AllWebs
Dim subSite As SPWeb

For Each subSite In  allSites

    Dim allSiteLists As SPListCollection = subSite.Lists
    Dim subSiteList As SPList

    For Each subSiteList In  allSiteLists

        Label1.Text += SPEncode.HtmlEncode(subSite.Name) & " :: " & _
           SPEncode.HtmlEncode(subSiteList.Title) & "<BR>"

    Next subSiteList

Next subSite

SPSite oSiteCollection = SPContext.Current.Site;
using(SPWebCollection collWebs = oSiteCollection.AllWebs)
{
    foreach (SPWeb oWebsite in collWebs)
    {
        SPListCollection collSiteLists = oWebsite.Lists;
        foreach (SPList oList in collSiteLists)
        {
            Label1.Text += SPEncode.HtmlEncode(oWebsite.Name) + " :: " +
                SPEncode.HtmlEncode(oList.Title) + "<BR>";
        }
        oWebsite.Dispose();
    }
}

注意事項
某些物件實作IDisposable介面，並且您必須避免之後不再需要保留這些物件在記憶體中。良好的程式碼撰寫方式的相關資訊，請參閱Disposing Objects。