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

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.

  • 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.

Siehe auch

Referenz

SPList Klasse

SPList-Member

AddItem-Überladung

Microsoft.SharePoint-Namespace

FileSystemObjectType

Url

Name