Compartilhar via


Lists.AddList Method

Cria uma lista no site atual com base no nome especificado, descrição e lista modelo identificação.

Web Service: ListsWeb Reference: http://<Site>/_vti_bin/Lists.asmx

Syntax

'Declaração
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/AddList", RequestNamespace:="https://schemas.microsoft.com/sharepoint/soap/", ResponseNamespace:="https://schemas.microsoft.com/sharepoint/soap/", Use:=SoapBindingUse.Literal, ParameterStyle:=SoapParameterStyle.Wrapped)> _
PublicFunctionAddList ( _
    listNameAsString, _
    descriptionAsString, _
    templateIDAsInteger _
) AsXmlNode
'Uso
DiminstanceAsListsDimlistNameAsStringDimdescriptionAsStringDimtemplateIDAsIntegerDimreturnValueAsXmlNodereturnValue = instance.AddList(listName, description, templateID)
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/AddList", RequestNamespace="https://schemas.microsoft.com/sharepoint/soap/", ResponseNamespace="https://schemas.microsoft.com/sharepoint/soap/", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped)] 
publicXmlNodeAddList (
    stringlistName,
    stringdescription,
    inttemplateID
)

Parameters

  • listName
    Uma seqüência de caracteres que contém o título da lista.
  • description
    Uma seqüência de caracteres que contém uma descrição para a lista.
  • templateID
    Um inteiro que especifica o modelo Lista para usar 32-bit. A tabela a seguir mostra os valores possíveis para a identificação.

    Nome de exibição Lista

    Tipo

    Anúncios

    104

    Contatos

    105

    Lista personalizada

    100

    Lista personalizada no modo de folha de dados

    120

    DataSources

    110

    Quadro de Discussão

    108

    Biblioteca de Documentos

    101

    Eventos

    106

    Formulário de biblioteca

    115

    Problemas

    1100

    Links

    103

    Biblioteca de Imagem

    109

    Pesquisa

    102

    Tarefas

    107

Return Value

Um fragmento em Colaboração aplicativos Markup Language (CAML) na forma a seguir que contém informações sobre a nova lista e que podem ser atribuídos a um objeto System.Xml.XmlNode.

<List DocTemplateUrl="" DefaultViewUrl="/Site_Name/Lists/List_Name/AllItems.aspx" 
   ID="{6A823AF7-F9BD-45CB-B94E-8D37B343FB82}" Title="MyNewList" 
   Description="This was made with the AddList method" 
   ImageUrl="/_layouts/images/itgen.gif" 
   Name="{6A823AF7-F9BD-45CB-B94E-8D37B343FB82}" BaseType="0" 
   ServerTemplate="100" 
   Created="20030619 07:11:30" Modified="20030619 07:11:30" 
   LastDeleted="20030619 07:11:30" 
   Version="0" Direction="none" ThumbnailSize="0" WebImageWidth="0" 
   WebImageHeight="0" 
   Flags="4096" ItemCount="0" AnonymousPermMask="0" 
   RootFolder="Lists/MyNewList" ReadSecurity="1" 
   WriteSecurity="1" Author="1" EventSinkAssembly="" EventSinkClass="" 
   EventSinkData="" 
   EmailInsertsFolder=""
   AllowDeletion="True"
   AllowMultiResponses="False"
   EnableAttachments="True"
   EnableModeration="False"
   EnableVersioning="False"
   Hidden="False" 
   MultipleDataList="False" 
   Ordered="False"
   ShowUser="True" 
   xmlns="https://schemas.microsoft.com/sharepoint/soap/">
   <Fields>
      <Field ColName="tp_ID" ReadOnly="TRUE" Type="Counter" Name="ID" 
         PrimaryKey="TRUE" 
         DisplayName="ID" FromBaseType="TRUE" />
      <Field Type="Text" Name="Title" DisplayName="Title" 
         Required="TRUE" FromBaseType="TRUE" 
         ColName="nvarchar1" />
         ...
   </Fields>
   <RegionalSettings>
      <Language>1033</Language>
      <Locale>1033</Locale>
      <AdvanceHijri>0</AdvanceHijri>
      <CalendarType>1</CalendarType>
      <Time24>False</Time24>
      <TimeZone>480</TimeZone>
      <SortOrder>2070</SortOrder>
      <Presence>True</Presence>
   </RegionalSettings>
</List>

Example

O exemplo de código a seguir adiciona uma lista personalizada para o site atual.

Esse exemplo requer que um using (Visual C#) ou Imports (Visual Basic) diretiva estar incluído para o namespace System.Xml.

Dim listService As New Web_Reference_Folder.Lists()
listService.Credentials = System.Net.CredentialCache.DefaultCredentials

Dim ndList As XmlNode = listService.AddList("List_Name", "Description", 100)

MessageBox.Show(ndList.OuterXml)
Web_Reference_Folder.Lists listService = new Web_Reference_Folder.Lists();
listService.Credentials= System.Net.CredentialCache.DefaultCredentials;

XmlNode ndList = listService.AddList("List_Name","Description",100);

MessageBox.Show(ndList.OuterXml);

See Also

Reference

Lists Class
Lists Members
Lists Web Service