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.