Procédure : créer une définition de liste personnalisée

Article
09/24/2014

Dernière modification : vendredi 9 juillet 2010

S’applique à : SharePoint Foundation 2010

Dans cet article
Créer la définition de champ
Créer le type de contenu
Créer la définition de liste à partir du type de contenu
Déployer la définition de liste

Cette tâche montre comment créer un Composant fonctionnel de modèle de liste personnalisé à l’aide des Outils de développement SharePoint dans Microsoft Visual Studio 2010. La meilleure pratique consiste à créer un type de contenu et à baser une définition de liste sur ce type de contenu.

Créer la définition de champ

Une définition de champ définit les colonnes qui apparaissent dans le modèle de liste. Pour plus d’informations sur le XML permettant de définir un type de champ, voir Types champs XML.

Pour créer la définition de champ

Démarrez Microsoft Visual Studio 2010.
Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Projet.
Dans Types de projets, sous Visual Basic ou C#, sélectionnez Projet SharePoint vide.
Tapez ListeCouleursFavorites comme nom de projet. Cliquez sur OK.
Dans l’Assistant Personnalisation de SharePoint, choisissez Déployer en tant que solution bac à sable (sandbox). Cliquez sur Terminer.
Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet ListeCouleursFavorites, sélectionnez Ajouter, puis Nouvel élément.
Dans la boîte de dialogue Ajouter un nouvel élément, choisissez le modèle Élément vide et tapez ListeCouleursFavorites dans la zone Nom. Cliquez sur Ajouter.

Insérez le XML suivant dans l’élément Elements. Ce XML définit un champ pour le type de contenu.

Important

Vous devez remplacer FieldId dans l’attribut ID par un GUID. Pour générer un GUID, cliquez sur Outils, puis cliquez sur Create GUID.

<Field ID="FieldId" Type="Choice" Name="FavoriteColor" DisplayName="Favorite Color" ShowInDisplayForm="TRUE" ShowInNewForm="TRUE" ShowInEditForm="TRUE">
  <CHOICES>
    <CHOICE>Red</CHOICE>
    <CHOICE>Green</CHOICE>
    <CHOICE>Blue</CHOICE>
    <CHOICE>Purple</CHOICE>
    <CHOICE>Magenta</CHOICE>
  </CHOICES>
</Field>

Créer le type de contenu

Un type de contenu définit une collection d’éléments à utiliser dans la liste. Pour plus d’informations sur les types de contenus, voir Types de contenu.

Pour créer le type de contenu

Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet ListeCouleursFavorites, sélectionnez Ajouter, puis Nouvel élément.
Dans la boîte de dialogue Ajouter un nouvel élément, choisissez le modèle Type de contenu et tapez TypeContenuCouleursFavorites dans la zone Nom. Cliquez sur Ajouter.
Dans la boîte de dialogue Choisir les paramètres de type de contenu, choisissez Élément dans la zone de liste déroulante De quel type de contenu de base ce type de contenu doit-il hériter ?. Cliquez sur Terminer.
Dans l’élément FieldRefs, vous devez ajouter un élément FieldRef qui référence le champ que vous avez précédemment défini. Le XML suivant ajoute une référence au champ.

Important

L’attribut ID de l’élément FieldRef doit correspondre à l’attribut ID de l’élément Field.
```
<FieldRef ID="FieldId" Name="FavoriteColor" />
```

Créer la définition de liste à partir du type de contenu

Pour créer la définition de liste à partir du type de contenu

Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet ListeCouleursFavorites, sélectionnez Ajouter, puis Nouvel élément.
Dans la boîte de dialogue Ajouter un nouvel élément, choisissez le modèle Définition de liste du type de contenu et tapez DéfinitionListeCouleursFavorites dans la zone Nom. Cliquez sur Ajouter.
Dans la boîte de dialogue Choisir les paramètres de définition de liste, vérifiez que TypeContenuCouleursFavorites est sélectionné dans la zone de liste déroulante Quel type de contenu voulez-vous utiliser pour la définition de liste ?.
Activez la case à cocher Ajouter une instance de liste pour cette définition de liste. Cliquez sur Terminer.
Ensuite, ouvrez le fichier Schema.xml précédemment créé.
Dans l’élément ViewFields, ajoutez le même élément FieldRef que vous avez ajouté au type de contenu. Le XML suivant ajoute une référence au champ.

Important

L’attribut ID de l’élément FieldRef doit correspondre à l’attribut ID de l’élément Field.
```
<FieldRef ID="FieldId" Name="FavoriteColor" />
```

Déployer la définition de liste

Pour déployer la définition de liste

Appuyez sur la touche F5 pour déployer la solution.
Lorsque le navigateur est ouvert, cliquez sur ListeCouleursFavorites - InstanceListe1 dans le volet de navigation de gauche.
Une fois la liste ouverte, vous pouvez constater la présence d’un champ Couleur favorite. Cliquez sur Ajouter un nouvel élément.
Le champ Couleur favorite apparaît dans le formulaire.