Compartilhar via


SPListCollection.Add method (String, String, SPListTemplate)

Cria uma lista com o título especificado, a descrição e o objeto modelo de lista.

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

Syntax

'Declaração
Public Overridable Function Add ( _
    title As String, _
    description As String, _
    template As SPListTemplate _
) As Guid
'Uso
Dim instance As SPListCollection
Dim title As String
Dim description As String
Dim template As SPListTemplate
Dim returnValue As Guid

returnValue = instance.Add(title, description, _
    template)
public virtual Guid Add(
    string title,
    string description,
    SPListTemplate template
)

Parâmetros

  • title
    Type: System.String

    Uma seqüência de caracteres que contém o título.

  • description
    Type: System.String

    Uma seqüência de caracteres que contém a descrição.

Valor retornado

Type: System.Guid
Um GUID que identifica a nova lista.

Examples

O exemplo de código a seguir cria uma lista em cada um dos sites de um conjunto de sites. A lista baseia-se no modelo para obter uma lista de contatos.

Dim oSiteCollection As SPSite =  SPContext.Current.Site 
Dim collWebsites As SPWebCollection = oSiteCollection.AllWebs
For Each oWebsiteAs SPWeb In collWebsites
    Dim collList As SPListCollection =  oWebsite.Lists 
    collList.Add("New_List_Name", "List_Description", SPListTemplateType.Contacts)
    oWebsite.Dispose()
Next
SPSite oSiteCollection = SPContext.Current.Site;
SPWebCollection collWebsites = oSiteCollection.AllWebs
foreach (SPWeb oWebsite in collWebsites)
{
    SPListCollection collList = oWebsite.Lists;
    collList.Add("New_List_Name", "List_Description", SPListTemplateType.Contacts);
    oWebsite.Dispose();
}

Dica

Determinados objetos implementam a interface IDisposable , e você deve evitar reter esses objetos na memória depois que eles não são mais necessários. Para obter informações sobre boas práticas de codificação, consulte Disposing Objects.

Ver também

Referência

SPListCollection class

SPListCollection members

Add overload

Microsoft.SharePoint namespace