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
title
Type : System.StringChaîne qui contient le titre.
description
Type : System.StringChaîne qui contient la description.
templateType
Type : Microsoft.SharePoint.SPListTemplateTypeValeur d'énumération qui spécifie le type de définition de liste.
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.