Lists.AddList - Méthode
Crée une liste dans le site actuel en fonction du nom spécifié, une description et un ID de modèle de liste.
Espace de noms : WebSvcLists
Assembly : STSSOAP (dans STSSOAP.dll)
Syntaxe
'Déclaration
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/AddList", RequestNamespace := "https://schemas.microsoft.com/sharepoint/soap/", _
ResponseNamespace := "https://schemas.microsoft.com/sharepoint/soap/", _
Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
Public Function AddList ( _
listName As String, _
description As String, _
templateID As Integer _
) As XmlNode
'Utilisation
Dim instance As Lists
Dim listName As String
Dim description As String
Dim templateID As Integer
Dim returnValue As XmlNode
returnValue = instance.AddList(listName, _
description, templateID)
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/AddList", RequestNamespace = "https://schemas.microsoft.com/sharepoint/soap/",
ResponseNamespace = "https://schemas.microsoft.com/sharepoint/soap/",
Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
public XmlNode AddList(
string listName,
string description,
int templateID
)
Paramètres
listName
Type : System.StringChaîne qui contient le titre de la liste.
description
Type : System.StringChaîne qui contient une description pour la liste.
templateID
Type : System.Int32Entier 32 bits qui spécifie le modèle de liste à utiliser. Le tableau suivant indique les valeurs possibles pour le code.
Valeur renvoyée
Type : System.Xml.XmlNode
Un fragment de Langue CAML (Collaborative Application Markup Language) dans l'écran suivant qui contient des informations sur la nouvelle liste et qui peut être affecté à un objet System.Xml.XmlNode .
<List DocTemplateUrl="" DefaultViewUrl="/Site_Name/Lists/List_Name/AllItems.aspx"
ID="{6A823AF7-F9BD-45CB-B94E-8D37B343FB82}" Title="MyNewList"
Description="This was made with the AddList method"
ImageUrl="/_layouts/images/itgen.gif"
Name="{6A823AF7-F9BD-45CB-B94E-8D37B343FB82}" BaseType="0"
ServerTemplate="100"
Created="20030619 07:11:30" Modified="20030619 07:11:30"
LastDeleted="20030619 07:11:30"
Version="0" Direction="none" ThumbnailSize="0" WebImageWidth="0"
WebImageHeight="0"
Flags="4096" ItemCount="0" AnonymousPermMask="0"
RootFolder="Lists/MyNewList" ReadSecurity="1"
WriteSecurity="1" Author="1" EventSinkAssembly="" EventSinkClass=""
EventSinkData=""
EmailInsertsFolder=""
AllowDeletion="True"
AllowMultiResponses="False"
EnableAttachments="True"
EnableModeration="False"
EnableVersioning="False"
Hidden="False"
MultipleDataList="False"
Ordered="False"
ShowUser="True"
xmlns="https://schemas.microsoft.com/sharepoint/soap/">
<Fields>
<Field ColName="tp_ID" ReadOnly="TRUE" Type="Counter" Name="ID"
PrimaryKey="TRUE"
DisplayName="ID" FromBaseType="TRUE" />
<Field Type="Text" Name="Title" DisplayName="Title"
Required="TRUE" FromBaseType="TRUE"
ColName="nvarchar1" />
...
</Fields>
<RegionalSettings>
<Language>1033</Language>
<Locale>1033</Locale>
<AdvanceHijri>0</AdvanceHijri>
<CalendarType>1</CalendarType>
<Time24>False</Time24>
<TimeZone>480</TimeZone>
<SortOrder>2070</SortOrder>
<Presence>True</Presence>
</RegionalSettings>
</List>
Exemples
L'exemple de code suivant ajoute une liste personnalisée pour le site actuel.
Cet exemple suppose qu'une directive de Imports (Visual Basic) soit incluse pour l'espace de noms System.Xml ou de using (Visual c#).
Dim listService As New Web_Reference_Folder.Lists()
listService.Credentials = System.Net.CredentialCache.DefaultCredentials
Dim ndList As XmlNode = listService.AddList("List_Name", "Description", 100)
MessageBox.Show(ndList.OuterXml)
Web_Reference_Folder.Lists listService = new Web_Reference_Folder.Lists();
listService.Credentials= System.Net.CredentialCache.DefaultCredentials;
XmlNode ndList = listService.AddList("List_Name","Description",100);
MessageBox.Show(ndList.OuterXml);