SPList.AddItem-Methode (String, SPFileSystemObjectType, String)

Artikel
05/06/2015

Erstellt ein Element des angegebenen Typs mit einem angegebenen Dateinamen im 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, _
    leafName As String _
) As SPListItem
'Usage
Dim instance As SPList
Dim folderUrl As String
Dim underlyingObjectType As SPFileSystemObjectType
Dim leafName As String
Dim returnValue As SPListItem

returnValue = instance.AddItem(folderUrl, _
    underlyingObjectType, leafName)

public SPListItem AddItem(
    string folderUrl,
    SPFileSystemObjectType underlyingObjectType,
    string leafName
)

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.

leafName
Typ: System.String

Der Dateiname einschließlich der Dateinamenerweiterung; beispielsweise mydoc.doc. Weitere Informationen finden Sie unter der Name -Eigenschaft.

Rückgabewert

Typ: Microsoft.SharePoint.SPListItem
Das neue Listenelement.

Ausnahmen

Ausnahme	Bedingung
ArgumentOutOfRangeException	underlyingObjectType ist weder File noch Folder.

Hinweise

Um ein Element zu einer Liste hinzuzufügen, rufen Sie zunächst die AddItem -Methode, um ein Element des angegebenen Typs mit dem angegebenen Dateinamen im angegebenen Ordner zu erstellen. Können Sie Indexer für das Objekt zurückgegebenen SPListItem weisen bestimmte Werte für die einzelnen Felder des Elements. Schließlich rufen Sie die Methode Update auf das SPListItem -Objekt, die Änderungen in die Datenbank schreiben.

Wichtig

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