Метод SPList.AddItem (String, SPFileSystemObjectType, String)

Статья
05/13/2015

Создает элемент списка, указанного типа с именем указанного файла в определенной папке в списке.

Пространство имен: Microsoft.SharePoint
Сборка: Microsoft.SharePoint (в Microsoft.SharePoint.dll)

Синтаксис

'Декларация
Public Function AddItem ( _
    folderUrl As String, _
    underlyingObjectType As SPFileSystemObjectType, _
    leafName As String _
) As SPListItem
'Применение
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
)

Параметры

folderUrl
Тип: System.String

Относительный к серверу URL-адрес папки, в котором должен быть создан элемент списка. URL-адрес должен начинаться с косой черты; Например, /sites/mysite/subweb/Lists/mylist/myfolder.

underlyingObjectType
Тип: Microsoft.SharePoint.SPFileSystemObjectType

Одно из значений перечисления, которое указывает тип объекта файла системы, представляющий новый элемент списка.

leafName
Тип: System.String

Имя файла, включая расширение файла; Например, mydoc.doc. Для получения дополнительных сведений см Name .

Возвращаемое значение

Тип: Microsoft.SharePoint.SPListItem
Новый элемент списка.

Исключения

Исключение	Условие
ArgumentOutOfRangeException	underlyingObjectType не является ни File , ни Folder.

Замечания

Чтобы добавить элемент в список, сначала вызовите метод AddItem для создания элемента списка, указанного типа с именем указанного файла в указанной папке. Затем используйте индексаторы в объекте возвращенные SPListItem назначение определенного значения полей элемента. И, наконец вызовите метод Update объекта SPListItem для записи изменений в базу данных.

Важно!

Новый элемент не добавлен фактически в списке только после его сохранения в базе данных путем вызова метода SPListItem.Update .