Cette documentation est archivée et n’est pas conservée.

ID de type de contenu

Windows SharePoint Services 3

Les ID de type de contenu identifient de façon unique le type de contenu et sont récursifs. L'ID de type de contenu encapsule le lignage de ce type de contenu, ou la ligne de types de contenu parent à partir desquels hérite le type de contenu. Chaque ID de type de contenu contient l'ID du type de contenu parent, qui à son tour contient l'ID du parent de ce type de contenu, et ainsi de suite, jusqu'à l'ID de type de contenu System. En analysant l'ID du type de contenu, vous pouvez déterminer de quels types de contenu le type de contenu hérite, et comment deux types de contenu sont liés.

Windows SharePoint Services utilise ces informations pour déterminer la relation entre les types de contenu et pour les opérations de propagation.

Vous pouvez construire un ID de type de contenu valide à l'aide de l'une des deux conventions :

  • ID de type de contenu parent + deux valeurs hexadécimales (ces deux valeurs ne peuvent pas être « 00 »)

  • ID de type de contenu parent + « 00 » + GUID hexadécimal

Un cas particulier, le type de contenu System, a l'ID de type de contenu « 0x ». Le type de contenu System est le type de contenu sealed à partir duquel tous les autres types de contenu héritent.

Pour tous les autres types de contenu, vous devez utiliser l'une des méthodes précédentes afin de construire un ID de type de contenu valide.

Remarque Remarque :

Un ID de type de contenu doit être unique dans une collection de sites.

En règle générale, la première technique de génération d'ID de type de contenu met l'accent sur la concision dans la mesure où elle n'utilise que deux chiffres hexadécimaux pour désigner un nouveau type de contenu. La deuxième approche souligne l'unicité car elle inclut un GUID pour signaler le nouveau type de contenu. Chaque approche est adaptée à des situations spécifiques.

ID de type de contenu parent + deux valeurs hexadécimales

Windows SharePoint Services utilise cette convention pour générer des ID de type de contenu pour les types de contenu par défaut qui sont inclus avec la plateforme. Par exemple, l'ID du type de contenu de base Item est 0x01. Cela indique que le type de contenu Item est un enfant direct du type de contenu System. L'ID de type de contenu Document est 0x0101, et l'ID du type de contenu Folder est 0x0120. En analysant ces ID de type de contenu, vous pouvez déterminer que Document et Folder sont des enfants directs d'Item, qui à son tour hérite directement de System, comme le montre l'illustration suivante.

ID du type de contenu du document

Cette convention vous permet de déterminer non seulement les types de contenu hérités par un type de contenu, mais aussi le point auquel deux types de contenu ont des ancêtres communs.

La figure suivante illustre la relation entre les quatre types de contenu décrits précédemment. Dans chacun d'eux, la partie unique de l'ID du type de contenu est représentée par le texte en bleu.

Exemple de hiérarchie d’ID de type de contenu par défaut

ID de type de contenu parent + « 00 » + GUID hexadécimal

Windows SharePoint Services utilise cette convention de génération d'ID de type de contenu lors de la création d'ID de type de contenu pour les éléments suivants :

  • Les types de contenu de site que vous créez basés sur d'autres types de contenu

  • Les types de contenu de liste, qui sont copiés dans une liste lorsque vous ajoutez un type de contenu de site à cette liste

Par exemple, si vous avez un type de contenu avec un ID de type de contenu « 0x010100D5C2F139516B419D801AC6C18942554D », vous savez que le type de contenu était l'un des suivants :

  • Un type de contenu de site qui est un enfant direct du type de contenu Document

  • Un type de contenu de liste créé lorsque le type de contenu de site Document a été ajouté à une liste

Nous vous recommandons d'utiliser l'approche GUID pour identifier les types de contenu qui sont des enfants directs de types de contenu que vous n'avez pas créés. Utilisez l'approche GUID si le type de contenu parent est l'un des suivants :

  • Un type de contenu par défaut inclus dans Windows SharePoint Services, tel que Document.

  • Un type de contenu développé par un tiers. De cette façon, vous êtes assuré que l'ID du type de contenu est unique et ne sera pas dupliqué ultérieurement par le développeur du type de contenu parent.

Cependant, après avoir identifié de manière unique un type de contenu à l'aide de l'approche GUID, vous pouvez utiliser la première méthode pour identifier les enfants de ce type de contenu. Le GUID utilisé dans votre type de contenu peut agir comme un espace de noms pour votre type de contenu. Tous les enfants basés sur ce type de contenu peuvent être identifiés par deux chiffres hexadécimaux. Étant donné que la longueur maximale d'un ID de type de contenu est définie, cette approche permet d'optimiser le nombre de « générations » de types de contenu autorisées.

Longueur des ID de type de contenu

La longueur maximale des ID de type de contenu est 512 octets. Étant donné que deux caractères hexadécimaux peuvent tenir dans chaque octet, chaque ID de type de contenu a une longueur maximale réelle de 1 024 caractères.

Par exemple, supposez que vous créez un nouveau type de contenu, myDocument, basé sur le type de contenu par défaut Document de Windows SharePoint Services. Pour l'ID du type de contenu myDocument, vous commencez par l'ID du type de contenu Document, 0x0101, et ajoutez 00 et un GUID. Cela identifie le type de contenu myDocument, et vous êtes assuré que Windows SharePoint Services n'ajoutera aucun autre type de contenu par défaut ultérieurement portant le même ID de type de contenu (ce qui serait possible, si vous ajoutez uniquement deux chiffres hexadécimaux). Cependant, pour générer des ID de types de contenu que vous dérivez de myDocument, vous pouvez simplement ajouter deux chiffres hexadécimaux à l'ID de type de contenu myDocument. Cela permet de maintenir la longueur d'ID de type de contenu au minimum, et d'optimiser le nombre de « générations » de type de contenu autorisées.

La figure suivante illustre ce scénario. La partie unique de chaque ID de type de contenu est représentée par le texte en bleu.

Exemple de hiérarchie d’ID de type de contenu

Pour obtenir la liste des types de contenu par défaut inclus dans Windows SharePoint Services 3.0 et leurs ID, voir Hiérarchie des types de contenu de base.

Voir aussi

Afficher: