Élément List (List)

S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | SharePoint En ligne | SharePoint Server 2013

Élément de niveau supérieur qui contient la définition d'une liste.

<List
  BaseType = "Integer" | "Text"
  Default = "TRUE" | "FALSE"
  DefaultItemOpen = "Integer"
  Description = "Text"
  Direction = "Text"
  DisableAttachments = "TRUE" | "FALSE"
  DraftVersionVisibility = "Integer"
  EnableContentTypes = "TRUE" | "FALSE"  EnableMinorVersions = "TRUE" | "FALSE"  EnableThumbnails = "TRUE" | "FALSE"
  EventSinkAssembly = "Text"
  EventSinkClass = "Text"
  EventSinkData = "Text"
  FolderCreation = "TRUE" | "FALSE"
  Id = "GUID"
  ModeratedList = "TRUE" | "FALSE"
  ModerationType = "TRUE" | "FALSE"
  Name = "Text"
  OrderedList = "TRUE" | "FALSE"
  PrivateList = "TRUE" | "FALSE"
  QuickLaunchUrl = "URL"
  RootWebOnly = "TRUE" | "FALSE"
  ThumbnailSize = "Integer"
  Title = "Text"
  Type = "Integer"
  Url = "URL"
  URLEncode = "TRUE" | "FALSE"
  VersioningEnabled = "TRUE" | "FALSE" 
  WebImageHeight = "Integer"
  WebImageWidth = "Integer">
</List>

Éléments et attributs

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut Description
BaseType
Text facultatif. L'attribut BaseType peut être défini sur Integer, qui stocke des valeurs en tant qu'entiers ou défini sur Text (par défaut), qui stocke des valeurs en tant que texte. Notez qu'il n'est pas possible de créer des champs de choix de type entier.
Par défaut
Facultatif Boolean. TRUE pour spécifier que la liste référencée dans le fichier Onet.xml doit être créée à chaque fois qu'un site est créé. Dans le cas contraire, la liste n'est pas créée lors de la création du site mais elle est disponible pour une instanciation ultérieure.
DefaultItemOpen
Boolean facultatif. 1 pour spécifier que les applications qui génèrent des transformations des éléments de la liste ouvrent les éléments dans un navigateur plutôt que dans une application côté client distincte ; sinon, valeur 0.
Description
Facultatif Text. Fournit la description de la liste. Cet attribut doit être spécifié dans une configuration dans un fichier Onet.xml lorsque vous ajoutez une définition de liste personnalisée à une définition de site. La valeur de cet attribut remplace la valeur contenue par l'élément DefaultDescription d'un fichier Schema.xml.
Direction
Obligatoire Text. Spécifie le sens dans lequel lire la liste. Les valeurs possibles sont notamment RTL (de droite à gauche), LTR (de gauche à droite) ou none (aucun).
DisableAttachments
Facultatif Boolean. TRUE pour désactiver les pièces jointes dans la liste.
DraftVersionVisibility
Integer facultatif. Spécifie les droits requis pour afficher les brouillons.

Les valeurs suivantes sont possibles :
- 1 Droits de modification
- 2 Droits d’approbation
- Toutes les autres valeurs Droits de lecture
EnableContentTypes
Boolean facultatif. TRUE pour activer la gestion des types de contenu dans les listes créées via la définition de liste.
EnableMinorVersions
Facultatif Boolean.
EnableThumbnails
Boolean facultatif. TRUE pour spécifier que les analyseurs de documents de cette liste génèrent des fichiers de miniatures qui correspondent aux documents enregistrés dans cette liste. Cet attribut s'applique uniquement aux bibliothèques de documents.
EventSinkAssembly
Texte facultatif. Cette option est spécifiée uniquement pour les schémas mis à niveau Windows SharePoint Services 2.0. Spécifie le nom fort d’un fichier dans le Global Assembly Cache (GAC) qui fournit un handler d’événements pour les événements de bibliothèque de documents.

Par exemple, Microsoft.SharePoint, Version=11.0.0.0, Culture=Neutral, PublicKeyToken=71e9bce111e9429c

Cet attribut a été supprimé dans SharePoint Foundation.
EventSinkClass
Texte facultatif. Spécifie le nom complet et sensible à la cas d’une classe qui définit un handler d’événements pour les événements de bibliothèque de documents sous la forme Namespace_Name.Class_Name. Cet attribut a été supprimé dans SharePoint Foundation.
EventSinkData
Facultatif Text. Contient une chaîne arbitraire qui doit être utilisée par un gestionnaire d'événements de bibliothèque de documents. Cet attribut a été supprimé dans SharePoint Foundation.
FolderCreation
Facultatif Boolean. TRUE pour afficher la commande Nouveau dossier dans le menu Nouveau.
Id
Facultatif GUID. Spécifie le GUID de la liste.
ModeratedList
Facultatif Boolean. TRUE pour demander l'approbation du contenu pour les éléments envoyés.
ModerationType
Boolean facultatif. TRUE pour indiquer que la modération est activée pour la liste, ce qui nécessite un processus d'approbation lors de la création ou de la modification du contenu.
Nom
Obligatoire Text. Nom interne d'une liste.
OrderedList
Facultatif Boolean.TRUE pour spécifier que l'option qui autorise les utilisateurs à réorganiser les éléments dans la liste est disponible, pour la liste, sur la page Modifier l'affichage.
PrivateList
Facultatif Boolean. TRUE pour spécifier que la liste est privée.
QuickLaunchUrl
Text facultatif. Spécifie l'URL de la page d'affichage pour ouvrir la liste par le biais du volet de navigation Lancement rapide.
RootWebOnly
Facultatif Boolean. TRUE pour spécifier que la liste créée à partir de la définition existe uniquement dans le site web racine d’une collection de sites.
ThumbnailSize
Facultatif Integer. Spécifie la largeur des miniatures à afficher dans les bibliothèques d'images.
Title
Text facultatif. Le nom complet générique de la liste.
Type
Integer facultatif. Spécifie le type de modèle de liste.

Les valeurs suivantes représentent les types de modèles de liste par défaut.

100 liste générique
101 Bibliothèque de documents
Enquête 102
103 Liste de liens
Liste 104 Annonces
105 Liste de contacts
106 Liste d’événements
107 Liste de tâches
108 Forum de discussion
109 Bibliothèque d’images
110 Sources de données
111 Galerie de modèles de sites
112 Liste d’informations utilisateur
113 Galerie de sites Web
114 Galerie de modèles de liste
115 Bibliothèque de formulaires XML
116 Galerie de pages maîtres
117 flux No-Code flux de travail
118 Processus de flux de travail personnalisé
119 Bibliothèque de pages Wiki
120 Grille personnalisée pour une liste
130 Bibliothèque de connexions de données
140 Historique des flux de travail
Liste 150 tâches du Gantt
Liste des séries de réunions 200
Liste de l’ordre du jour de la réunion 201
Liste des participants à la réunion 202
204 Liste des décisions de réunion
Liste des objectifs de réunion 207
Zone de texte 210 Réunion
211 Éléments de réunion à mettre en liste
Liste des pages d’espace de travail de réunion 212
Liste des billets de blog 301
Liste de commentaires de blog 302
Liste des catégories de blog 303
1100 Suivi des problèmes
1200 Liste de tâches d’administrateur

Cet attribut correspond à l'attribut Type de l'élément ListTemplate.
Url
Texte facultatif. Spécifie le chemin d’accès à la racine du répertoire qui contient les fichiers ASPX à laquelle la définition de liste s’applique, par rapport à l’URL racine du site web.
URLEncode
Facultatif Boolean. TRUE pour convertir des caractères spéciaux, tels que des espaces, au format UTF-8, par exemple% c3%ab pour le caractère ë.
VersioningEnabled
Facultatif Boolean.TRUE pour spécifier dans un fichier Schema.xml que le suivi de version doit être activé par défaut pour les bibliothèques de documents créées à l'aide la définition de liste. La définition de cet attribut n'a aucune incidence sur les bibliothèques de documents existantes. Si cet attribut prend la valeur TRUE, le suivi de version peut toujours être désactivé pour une bibliothèque de documents spécifique dans la page Nouvelle bibliothèque de documents lorsque la bibliothèque est en cours de création.
WebImageHeight
Facultatif Integer. Spécifie la hauteur, en pixels, d'une image dans une bibliothèque d'images.
WebImageWidth
Facultatif Integer. Spécifie la largeur, en pixels, d'une image dans une bibliothèque d'images.

Éléments enfants

Éléments parents

Aucun

Occurrences

  • Minimum : 0
  • Maximum : 1

Remarques

Lorsqu’il est utilisé comme élément racine dans le fichier de schéma pour une liste, l’élément List doit contenir la déclaration d’espace de noms Microsoft SharePoint Foundation ows: . Les lignes suivantes illustrent l'ouverture d'un fichier Schema.xml pour des bibliothèques de documents :

<List 
  xmlns:ows="Microsoft SharePoint" 
  Name="Documents" 
  Title="$Resources:shareddocuments_Title;" 
  Direction="$Resources:Direction;" 
  Url="Shared Documents" 
  BaseType="1">

Dans un schéma de liste, l'élément MetaData contient les différentes parties de la définition de liste. Utilisez un élément De liste vide ( <List /> ) pour renvoyer le titre de la liste actuelle.

Dans une définition de site (Onet.xml), l'élément List ne contient pas de section MetaData, mais il peut contenir une section Data par laquelle spécifier des valeurs de colonne par défaut pour le type de liste donné.