SPListCollection.Add method (String, String, SPListTemplateType)

Creates a list with the specified title, description, and list definition type.

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

Syntax

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

Parameters

• title
  Type: System.String

  A string that contains the title.

• description
  Type: System.String

  A string that contains the description.

• templateType
  Type: Microsoft.SharePoint.SPListTemplateType

  An enumeration value that specifies the type of list definition.

Return value

Type: System.Guid
A System.Guid that identifies the new list.

Remarks

This overload of the Add method applies only to the default Microsoft SharePoint Foundation list templates that are represented by the Microsoft.SharePoint.SPListTemplateType enumeration. To create lists based on other list templates, use one of the other Add method overloads.

Examples

The following code example creates a Contacts list in every site within the current site collection.

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

See also

Reference

SPListCollection class

SPListCollection members

Add overload

Microsoft.SharePoint namespace