SPList.AddItem method (String, SPFileSystemObjectType)

Artigo
05/12/2015

Cria um item de lista de um tipo 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 _
) As SPListItem
'Uso
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
)

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. Os únicos tipos válidos são File e Folder. Se você passar um valor de outro, uma exceção é acionada quando você chama o método Update no objeto SPListItem .

Valor retornado

Type: Microsoft.SharePoint.SPListItem
O novo item.

Comentários

Este método chama o método AddItem(String, SPFileSystemObjectType, String) com folderUrl, underlyingObjectTypee null .

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

Importante

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