Compartilhar via


SPListCollection.Add method (String, String, SPListTemplateType)

Cria uma lista com o título especificado, a descrição e o tipo de definição 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, _
    templateType As SPListTemplateType _
) As Guid
'Uso
Dim instance As SPListCollection
Dim title As String
Dim description As String
Dim templateType As SPListTemplateType
Dim returnValue As Guid

returnValue = instance.Add(title, description, _
    templateType)
public virtual Guid Add(
    string title,
    string description,
    SPListTemplateType templateType
)

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 System.Guid que identifica a nova lista.

Comentários

Essa sobrecarga do método Add aplica-se somente para os modelos de lista de Microsoft SharePoint Foundation padrão que são representados pela enumeração Microsoft.SharePoint.SPListTemplateType . Para criar listas com base em outros modelos de lista, use uma das outras sobrecargas de método de Add .

Examples

O exemplo de código a seguir cria uma lista de contatos em todos os sites no conjunto de sites atual.

Dim site As SPSite = SPControl.GetContextSite(Context)
Dim destSites As SPWebCollection = site.AllWebs
Dim destSite As SPWeb

For Each destSite In  destSites

    Dim destLists As SPListCollection = destSite.Lists

    destLists.Add("New_List_Name", "List_Description", 
        SPListTemplateType.Contacts) 

Next destSite 
SPSite oSiteCollection = SPContext.Current.Site;
using(SPWebCollection collWebsites = oSiteCollection.AllWebs)
{
    foreach (SPWeb oWebsite in collWebsites)
    {
        SPListCollection collList = oWebsite.Lists;
        collList.Add("New_List_Name", "List_Description",
            SPListTemplateType.Contacts);
    }
}

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