ListCollection.Add método

Artigo
05/11/2016

Cria uma nova lista ou biblioteca de documentos.

Namespace: Microsoft.SharePoint.Client
Assemblies: Microsoft.SharePoint.Client.Silverlight (em Microsoft.SharePoint.Client.Silverlight.dll); Microsoft.SharePoint.Client.Phone (em Microsoft.SharePoint.Client.Phone.dll) Microsoft.SharePoint.Client (em Microsoft.SharePoint.Client.dll)

Sintaxe

'Declaração
Public Function Add ( _
    parameters As ListCreationInformation _
) As List
'Uso
Dim instance As ListCollection
Dim parameters As ListCreationInformation
Dim returnValue As List

returnValue = instance.Add(parameters)

public List Add(
    ListCreationInformation parameters
)

Parâmetros

parameters
Tipo: Microsoft.SharePoint.Client.ListCreationInformation

Um objeto de ListCreationInformation que representa informações associadas a lista ou biblioteca de documentos.

Ele não deve ser uma referência nula (Nothing no Visual Basic).

Valor retornado

Tipo: Microsoft.SharePoint.Client.List
Retorna uma instância de List que representa a criação de lista ou biblioteca de documentos.

Exceções

Exceção	Condição
MetadataObjectNotFoundException	ListCreationInformation.Url não é válido.
[Microsoft.BusinessData.MetadataModel.MetadataObjectNotFoundException]	Entidade especificada em ListCreationInformation.DataSourceProperties ou o SpecificFinder especificado não existe no servidor. Código de erro: -1.
[Microsoft.SharePoint.SPException]	Entidade especificada em ListCreationInformation.DataSourceProperties não tem um modo de exibição com o SpecificFinder especificado. Código de erro:-2146232832.
SPException	O local de lista não existir, o usuário atual tem permissões suficientes para executar a operação, ListCreationInformation.Title é uma referência nula (Nothing no Visual Basic), ListCreationInformation.Url não é válido ou outra lista com o título já existe no site. Código de erro:-2130575342.
[Microsoft.SharePoint.SPException]	Modelo de lista de servidor não é válido. Código de erro:-2130575237.
[Microsoft.SharePoint.SPException]	Recurso não existe. Código de erro:-2130246262.
UnauthorizedAccessException	O modelo de servidor de lista não é válido. O usuário atual tem permissões suficientes. Código de erro: -2147024891.

Exemplos

Este exemplo de código cria duas novas listas de anúncios e os adiciona à coleção de lista do site da web atual.

using System;
using Microsoft.SharePoint.Client;

namespace Microsoft.SDK.SharePointFoundation.Samples
{
    class ListCollection_AddExample

    {
        static void Main()
        {
            string siteUrl = "http://MyServer/sites/MySiteCollection";

            ClientContext clientContext = new ClientContext(siteUrl);
            Web site = clientContext.Web;
            ListCollection collList = site.Lists;

            ListCreationInformation lci1 = new ListCreationInformation();
            lci1.Title = "New Announcements";
            lci1.TemplateType = (int)ListTemplateType.Announcements;
            site.Lists.Add(lci1);

            ListCreationInformation lci2 = new ListCreationInformation();
            lci2.Title = "Old Announcements";
            lci2.TemplateType = (int)ListTemplateType.Announcements;
            site.Lists.Add(lci2);

            clientContext.Load(collList);
            clientContext.ExecuteQuery();

            Console.WriteLine("Lists on the current site:\n\n");
            foreach (List targetList in collList)
               Console.WriteLine(targetList.Title);

        }
    }
}

Ver também

Referência

ListCollection classe

ListCollection membros

Microsoft.SharePoint.Client namespace

Compartilhar via