Freigeben über


SPListCollection-Klasse

Stellt eine Auflistung von SPList -Objekten dar.

Vererbungshierarchie

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

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

Syntax

'Declaration
Public Class SPListCollection _
    Inherits SPBaseCollection
'Usage
Dim instance As SPListCollection
public class SPListCollection : SPBaseCollection

Hinweise

Verwenden Sie die Lists -Eigenschaft der SPWeb -Klasse, um ein SPListCollection -Objekt zurückzugeben, das die Auflistung von Listen auf einer Website darstellt, oder verwenden Sie die Lists -Eigenschaft der SPList -Klasse, um ein SPListCollection -Objekt zurückzugeben, das die Auflistung der übergeordneten Listen für eine Liste darstellt. Um eine Liste zu erstellen, verwenden Sie eine der Methoden des SPListCollectionAdd .

Verwenden Sie Indexer, um eine einzelne Liste aus der Auflistung zurückzugeben. Vorausgesetzt, die Auflistung z. B. eine Variable namens collListszugeordnet ist, verwenden Sie collLists[index] in C# oder collLists(index) in Visual Basic, wobei index die Indexnummer der Liste in der Auflistung der angezeigte Name der Liste ist, oder die GUID der Liste.

Wenn Benutzer, die den Code Vollzugriff für die Liste haben nicht, die Website berechtigt sind jedoch verwenden Sie den GUID Indexer, eine Liste aus der Auflistung der Listen in der Website zurückzugeben. Andernfalls wird eine Fehlermeldung Zugriff verweigert zurückgegeben, da der Benutzer nicht berechtigt ist, zum Enumerieren der Auflistung von Listen, wie ausgeführt wird, wenn der Indexer Name verwendet wird. GUID des Indexers können direkten Zugriff auf das Element, da die GUID der Primärschlüssel in der Tabelle Listen der Microsoft SharePoint Foundation -Datenbank ist.

Beispiele

Im folgenden Codebeispiel durchläuft alle Listen aller Websites in einer Websitesammlung und zeigt den Namen der einzelnen Listen- und Websiteinhaltstypen. Das Beispiel setzt das Vorhandensein einer ASPX-Seite, die ein Label-Steuerelement enthält.

Dieses Beispiel erfordert using Richtlinien (Imports in Visual Basic) für die Namespaces Microsoft.SharePoint und 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();
    }
}

Hinweis

Bestimmte Objekte, die IDisposable -Schnittstelle implementieren, und müssen Sie vermeiden, diese Objekte im Arbeitsspeicher beibehalten, nachdem sie nicht mehr benötigt werden. Informationen zu bewährten Programmierpraktiken finden Sie unter Disposing Objects.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.

Siehe auch

Referenz

SPListCollection-Member

Microsoft.SharePoint-Namespace