SPList.GetItemByIdSelectedFields-Methode
Ruft das Listenelement mit dem angegebenen Bezeichner (ID) und die Werte der angegebenen Felder enthält.
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
Public Function GetItemByIdSelectedFields ( _
id As Integer, _
ParamArray fields As String() _
) As SPListItem
'Usage
Dim instance As SPList
Dim id As Integer
Dim fields As String()
Dim returnValue As SPListItem
returnValue = instance.GetItemByIdSelectedFields(id, _
fields)
public SPListItem GetItemByIdSelectedFields(
int id,
params string[] fields
)
Parameter
id
Typ: System.Int32Eine Kennung des Artikels. Der Wert dieses Parameters entspricht nicht den Index des Objekts innerhalb der Auflistung von Elementen für die Liste, sondern den Wert der ID -Eigenschaft des Listenelements.
fields
Typ: []Eine durch Trennzeichen getrennte Liste von Feldnamen für das Abrufen von Werten. Um den Wert der ContentType -Eigenschaft des Listenelements abzurufen, müssen Sie auch die ContentTypeId -Eigenschaft des Elements angeben. Um alle Werte abzurufen, verwenden Sie die GetItemByIdAllFields(Int32) -Methode.
Rückgabewert
Typ: Microsoft.SharePoint.SPListItem
Das Listenelement, einschließlich Daten aus den angegebenen Feldern. Wenn Sie versuchen, den Wert eines Felds zuzugreifen, das nicht zurückgegeben wird, weil er nicht angegeben wurde, werden SharePoint Foundation einen Roundtrip in der Datenbank des Artikels Feldwerte außer für User oder benutzerdefinierte Lookup Felder abgerufen.
Ausnahmen
Ausnahme | Bedingung |
---|---|
ArgumentNullException | fields ist Null . |