Compartilhar via


SPListItemCollection.Add method

Cria um item, mas exige o método SPListItem.Update , na verdade, adicionar um item à lista.

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

Syntax

'Declaração
Public Function Add As SPListItem
'Uso
Dim instance As SPListItemCollection
Dim returnValue As SPListItem

returnValue = instance.Add()
public SPListItem Add()

Valor retornado

Type: Microsoft.SharePoint.SPListItem
O novo item.

Comentários

Para adicionar um item a uma lista, chame o método Add para criar um item de lista de nonfolder na raiz da lista com um nome gerado automaticamente e atribuir o valor de retorno para um objeto SPListItem . Usar indexadores nesse objeto para cada campo para atribuir valores específicos e então chamar o método Update em um item para alterações de efeito no banco de dados.

Use list.RootFolder.Files.Add para adicionar arquivos à biblioteca de documentos, onde list é um objeto SPList .

Esse método retorna uma exceção System.Exception se aplicada a uma biblioteca de documentos.

Examples

O exemplo a seguir adiciona um novo item em uma lista especificada.

Imports System
Imports Microsoft.SharePoint

Module Test

    Sub Main()
        Using site As SPSite = New SPSite("https://localhost")
            Using web As SPWeb = site.OpenWeb()

                Dim list As SPList = web.GetList("/lists/announcements")
                Dim items As SPListItemCollection = list.Items

                Dim item As SPListItem = items.Add()
                item(SPBuiltInFieldId.Title) = "A new item!"
                item(SPBuiltInFieldId.Body) = "This item was added by a call to the Add method."
                item(SPBuiltInFieldId.Expires) = DateTime.Now.AddHours(1)
                item.Update()

                Dim id As Guid = item.UniqueId
                Console.WriteLine(items(id).Title)

            End Using
        End Using
        Console.ReadLine()
    End Sub

End Module
using System;
using Microsoft.SharePoint;

namespace Test
{
    class Program
    {
        static void Main(string[] args)
        {
            using (SPSite site = new SPSite("https://localhost"))
            {
                using (SPWeb web = site.OpenWeb())
                {
                    SPList list = web.GetList("/lists/announcements");
                    SPListItemCollection items = list.Items;

                    SPListItem item = items.Add();
                    item[SPBuiltInFieldId.Title] = "A new item!";
                    item[SPBuiltInFieldId.Body] = "This item was added by a call to the Add method.";
                    item[SPBuiltInFieldId.Expires] = DateTime.Now.AddHours(1);
                    item.Update();

                    Guid id = item.UniqueId;
                    Console.WriteLine(items[id].Title);
                }
            }
            Console.ReadLine();
        }
    }
}

Ver também

Referência

SPListItemCollection class

SPListItemCollection members

Add overload

Microsoft.SharePoint namespace