SPList.GetItems-Methode (String[])
Gibt eine Auflistung von Elementen aus der Liste, jedoch nur die angegebenen Werte enthält.
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
Public Function GetItems ( _
ParamArray fields As String() _
) As SPListItemCollection
'Usage
Dim instance As SPList
Dim fields As String()
Dim returnValue As SPListItemCollection
returnValue = instance.GetItems(fields)
public SPListItemCollection GetItems(
params string[] fields
)
Parameter
fields
Typ: []Eine Variable Anzahl von Feldnamen für das Abrufen von Werten. Wenn alle Felder abgerufen werden sollen, verwenden Sie stattdessen die Items -Eigenschaft.
Rückgabewert
Typ: Microsoft.SharePoint.SPListItemCollection
Eine Auflistung von Listenelementen.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentNullException | fields ist Null . |
Hinweise
Diese Methode erstellt ein neues SPQuery -Objekt aus den angegebenen Feldern und ruft die GetItems(SPQuery) -Methode mit diesem neuen Objekt der Elemente abgerufen.
Diese Methode ist effizienter als der Zugriff auf die Items -Eigenschaft, da es nur für die angegebenen Felder die Werte abruft.
Beispiele
Im folgende Beispiel ist eine Konsolenanwendung, die Feldwerte für die zurückzugebenden Elemente aus einer Liste abgerufen angibt. Nach dem Abrufen der Daten, druckt die Anwendung einen einfachen Bericht an die Konsole.
Imports System
Imports Microsoft.SharePoint
Module ConsoleApp
Sub Main()
Using site As SPSite = New SPSite("https://localhost")
Using web As SPWeb = site.OpenWeb()
' Get data from a list.
Dim listUrl As String = web.ServerRelativeUrl + "/lists/tasks"
Dim list As SPList = web.GetList(listUrl)
Dim items As SPListItemCollection = list.GetItems("LinkTitle", "AssignedTo", "DueDate", "Status")
' Print a report header.
Console.WriteLine("{0,-25} {1,-20} {2,-25} {3}", _
"Assigned To", "Task", "Due Date", "Status")
' Print the details.
Dim item As SPListItem
For Each item In items
Console.WriteLine("{0,-25} {1,-20} {2,-25} {3}", _
item("AssignedTo"), item("LinkTitle"), item("DueDate"), item("Status"))
Next item
End Using
End Using
Console.ReadLine()
End Sub
End Module
using System;
using Microsoft.SharePoint;
namespace Test
{
class ConsoleApp
{
static void Main(string[] args)
{
using (SPSite site = new SPSite("https://localhost"))
{
using (SPWeb web = site.OpenWeb())
{
// Get data from a list.
string listUrl = web.ServerRelativeUrl + "/lists/tasks";
SPList list = web.GetList(listUrl);
SPListItemCollection items = list.GetItems("LinkTitle", "AssignedTo", "DueDate", "Status");
// Print a report header.
Console.WriteLine("{0,-25} {1,-20} {2,-25} {3}",
"Assigned To", "Task", "Due Date", "Status");
// Print the details.
foreach (SPListItem item in items)
{
Console.WriteLine("{0,-25} {1,-20} {2,-25} {3}",
item["AssignedTo"], item["LinkTitle"], item["DueDate"], item["Status"]);
}
}
}
Console.ReadLine();
}
}
}