Partager via


SPListCollection.Add - Méthode (String, String, SPListTemplateType)

Crée une liste avec le titre spécifié, la description et le type de définition de liste.

Espace de noms :  Microsoft.SharePoint
Assembly :  Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
Public Overridable Function Add ( _
    title As String, _
    description As String, _
    templateType As SPListTemplateType _
) As Guid
'Utilisation
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
)

Paramètres

  • description
    Type : System.String

    Chaîne qui contient la description.

Valeur renvoyée

Type : System.Guid
System.Guid qui identifie la nouvelle liste.

Remarques

Cette surcharge de la méthode Add s'applique uniquement aux modèles liste Microsoft SharePoint Foundation par défaut qui sont représentés par l'énumération Microsoft.SharePoint.SPListTemplateType . Pour créer des listes basées sur les autres modèles de liste, utilisez une des autres surcharges de méthode Add .

Exemples

L'exemple de code suivant crée une liste de Contacts dans tous les sites au sein de la collection de sites actuelle.

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);
    }
}

Notes

Certains objets implémentent l'interface IDisposable , et vous devez éviter de conserver ces objets dans la mémoire après que qu'ils ne sont plus nécessaires. Pour plus d'informations sur les bonnes pratiques de codage, consultez Disposing Objects.

Voir aussi

Référence

SPListCollection classe

SPListCollection - Membres

Add - Surcharge

Microsoft.SharePoint - Espace de noms