SPList.AddItem method (String, SPFileSystemObjectType, String)

Artigo
05/12/2015

Cria um item de lista de um tipo especificado com um nome de arquivo especificado na pasta especificada na lista.

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

Syntax

'Declaração
Public Function AddItem ( _
    folderUrl As String, _
    underlyingObjectType As SPFileSystemObjectType, _
    leafName As String _
) As SPListItem
'Uso
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
)

Parâmetros

folderUrl
Type: System.String

A URL relativa de servidor da pasta onde o item de lista deve ser criado. A URL deve começar com uma barra invertida; Por exemplo, /sites/mysite/subweb/Lists/mylist/myfolder.

underlyingObjectType
Type: Microsoft.SharePoint.SPFileSystemObjectType

Um dos valores de enumeração que especifica o tipo de objeto de sistema de arquivos que representa o novo item de lista.

leafName
Type: System.String

O nome de arquivo, incluindo a extensão de arquivo; Por exemplo, mydoc.doc. Para obter mais informações, consulte a propriedade Name .

Valor retornado

Type: Microsoft.SharePoint.SPListItem
O novo item de lista.

Exceptions

Exception	Condition
ArgumentOutOfRangeException	underlyingObjectType não é File nem Folder.

Comentários

Para adicionar um item a uma lista, primeiro chame o método AddItem para criar um item de lista do tipo especificado com o nome de arquivo especificado na pasta especificada. Use os indexadores no objeto retornado SPListItem para atribuir valores específicos para cada campo do item. Finalmente, chame o método Update no objeto SPListItem para gravar as alterações no banco de dados.

Importante

O novo item não é realmente adicionado à lista até que você salvá-lo no banco de dados de conteúdo ao chamar o método SPListItem.Update .