SPList.AddItem-Methode (String, SPFileSystemObjectType)

Artikel
05/06/2015

Erstellt ein Element eines angegebenen Typs in den angegebenen Ordner in der Liste.

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

Syntax

'Declaration
Public Function AddItem ( _
    folderUrl As String, _
    underlyingObjectType As SPFileSystemObjectType _
) As SPListItem
'Usage
Dim instance As SPList
Dim folderUrl As String
Dim underlyingObjectType As SPFileSystemObjectType
Dim returnValue As SPListItem

returnValue = instance.AddItem(folderUrl, _
    underlyingObjectType)

public SPListItem AddItem(
    string folderUrl,
    SPFileSystemObjectType underlyingObjectType
)

Parameter

folderUrl
Typ: System.String

Die serverrelative URL des Ordners ein, in dem das Element der Liste erstellt werden soll. Die URL muss mit einem Schrägstrich beginnen; beispielsweise /sites/mysite/subweb/Lists/mylist/myfolder.

underlyingObjectType
Typ: Microsoft.SharePoint.SPFileSystemObjectType

Einer der Enumerationswerte, der den Typ des Dateisystemobjekt angibt, die das neue Listenelement darstellt. Die einzige gültigen Typen sind File und Folder. Wenn ein anderer Wert übergeben wird, wird eine Ausnahme ausgelöst, wenn Sie die Update -Methode für das SPListItem -Objekt aufrufen.

Rückgabewert

Typ: Microsoft.SharePoint.SPListItem
Das neue Element.

Hinweise

Diese Methode ruft die Methode AddItem(String, SPFileSystemObjectType, String) , folderUrl, underlyingObjectTypeund Null .

Um ein Element zu einer Liste hinzuzufügen, rufen Sie zunächst die AddItem -Methode, um ein Element des angegebenen Typs im angegebenen Ordner mit einem automatisch generierten Namen zu erstellen. Können Sie Indexer für das Objekt zurückgegebenen SPListItem weisen bestimmte Werte für die einzelnen Felder des Elements. Rufen Sie abschließend die Update -Methode auf, um die Änderungen an die Datenbank übergeben.

Wichtig

Das neue Element wird der Liste nicht hinzugefügt werden, bevor Sie mit der Inhaltsdatenbank gespeichert, indem die SPListItem.Update -Methode.