Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

SPList-Klasse

SharePoint 2013

Stellt eine Liste auf einer Website Microsoft SharePoint Foundation .

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

public class SPList : SPSecurableObject

Eine Liste enthält Elemente oder Zeilen und Spalten oder Felder, die Daten enthalten. Die Items -Eigenschaft gibt die Auflistung von Elementen in der Liste, und die Fields -Eigenschaft gibt die Auflistung der Felder in der Liste. Zur Verbesserung der Leistung ist es empfehlenswert, eine der GetItem* -Methoden verwenden, um eine gefilterte Auflistung von Elementen in der Liste zurück.

Verschiedene SPList -Eigenschaften ParentList Eigenschaften und andere Eigenschaften oder Methoden für Klassen im Namespace Microsoft.SharePoint Zurückgeben einer Liste oder einer Auflistung von Listen in einem bestimmten Kontext. Verwenden Sie andernfalls die Lists -Eigenschaft der SPWeb oder die SPList -Klasse ein SPListCollection -Objekt, das entweder die Sammlung von Listen in einer Website oder einer Auflistung von übergeordneten Listen eine Liste zurückgeben. Verwenden Sie Indexer, um eine einzelne Liste aus der Auflistung zurückzugeben. Verwenden Sie z. B., wenn die Auflistung in eine Variable namens collListszugewiesen wird, 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.

Im folgenden Codebeispiel gibt und zeigt Elemente aus einer angegebenen Liste, wobei die Werte im Feld "ProjectedValue" größer als 500 sind. 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 .

SPSite oSiteCollection = SPContext.Current.Site;
SPList oList = oSiteCollection.AllWebs["Site_Name"].Lists["List_Name"];

SPQuery oQuery = new SPQuery();
oQuery.Query = "<Where><Gt><FieldRef Name='ProjectedValue'/>" +
    "<Value Type='Number'>500</Value></Gt></Where>";
SPListItemCollection collListItems = oList.GetItems(oQuery);

foreach (SPListItem oListItem in collListItems)
{
    Label1.Text += "Item: " + 
        SPHttpUtility.HtmlEncode(oListItem["Title"].ToString()) + 
        "::" + "Value: " +   
        SPHttpUtility.HtmlEncode(oListItem["Investment"].ToString()) +
        "::" + "Calculated: " + 
        SPHttpUtility.HtmlEncode(oListItem["ProjectedValue"].ToString()) + 
        "<BR>";
    }
}

Nach der Instanziierung eines Objekts SPQuery , verwendet das Beispiel Collaborative Application Markup Language (CAML) zum Definieren von Kriterien für die Abfrage, der als Parameter in der GetItems -Methode übergeben wird. Informationen über CAML finden Sie unter Collaborative Application Markup Language.

HinweisHinweis

Informationen dazu, wie Sie Abfragen (Language-Integrated Query, LINQ) verwenden, um Listenelemente in SharePoint Foundationabzurufen finden Sie unter Managing Data with LINQ to SharePoint.

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