PropertySchema, élément (Types de champs)

Article
09/24/2014

Dernière modification : vendredi 9 avril 2010

S’applique à : SharePoint Foundation 2010

Dans cet article
Attributs
Éléments enfants
Éléments parents

Important

Cette rubrique décrit le marquage qui était utilisé dans une méthode obsolète de rendu des propriétés de type de champ personnalisé. Elle est fournie uniquement pour faciliter le débogage des propriétés de type de champ personnalisé développées par rapport aux versions antérieures de SharePoint Foundation. Pour plus d’informations sur la méthode recommandée, voir Rendu des propriétés de type de champ personnalisés.

Représente le schéma de certaines propriétés de variables spéciales d'un type de champ personnalisé, avec chaque propriété définie sous la forme d'un élément Field.

<PropertySchema>
</PropertySchema>

Attributs

Attribut	Description
None

Éléments enfants

Fields, élément (schéma de propriétés des types de champs)

Éléments parents

FieldType, élément (types de champ)

Remarques

Les types de champs personnalisés peuvent avoir des propriétés spéciales dont la valeur varie d'une colonne basée sur le type de champ à une autre colonne basée sur le même type de champ. Prenons par exemple un type de champ personnalisé d'expression régulière qui est destiné à contenir des valeurs String correspondant à une certaine expression régulière, telle que ^(\d{3})\d{3}-\d{4}$ pour les numéros de téléphone américains. Au lieu de créer des types de champs d'expression régulière personnalisés pour les numéros de plaques d'immatriculation britanniques, les numéros de sécurité sociale américains, les numéros de téléphone chinois, etc., il est plus efficace de créer un type de champ d'expression régulière unique et permettre aux utilisateurs qui créent des colonnes basées sur le type champ de définir l'expression régulière qui doit être mise en correspondance sur une base colonne par colonne. Par exemple, un utilisateur qui crée une colonne « numéro de téléphone américain » peut définir l'expression régulière de la colonne selon la chaîne ci-dessus. Un autre utilisateur, qui crée une colonne « Boîte postale brésilienne » définirait l'expression régulière de sa colonne à ^\d{5}\-\d{3}$.

Pour ce faire, le champ personnalisé doit avoir une propriété RegularExpression qui est restituée dans un contrôle modifiable de l’interface utilisateur (IU) lorsqu’une nouvelle colonne est créée. Dans SharePoint Foundation, cette option se trouve dans la section Paramètres de colonne supplémentaires de la page Nouvelle colonne de site et de la page Créer une colonne. L’élément PropertySchema dans le fichier fldtypes*.xml est l’emplacement où ces propriétés de variables sont déclarées et reçoivent un schéma de rendu par défaut.

Notes

Si vous définissez les propriétés variables du type de champ personnalisé dans l’élément PropertySchema, SharePoint Foundation affiche automatiquement ces propriétés en fonction du schéma.

Exemple

L'exemple suivant définit un schéma de propriété pour un type de champ personnalisé appelé « RegularExpressionMatch ». Le schéma déclare un champ pour une utilisation par les créateurs de colonnes lorsqu'ils basent une colonne sur le type de champ. La raison d'être du champ est de permettre à un créateur de colonnes de définir une expression régulière différente pour chaque colonne basée sur le type de champ RegularExpressionMatch.

DisplayName et un champ modifiable Text apparaissent dans la section Paramètres de colonne supplémentaires de la page Nouvelle colonne de siteet de la page Créer une colonne. L'attribut MaxLength définit la longueur maximale, en caractères, de l'expression régulière et DisplaySize définit la taille du champ qui la contient. Les utilisateurs peuvent faire défiler le champ pour voir le reste de l'expression régulière si elle est plus longue que DisplaySize.

Aucune valeur par défaut n'a été définie dans cet exemple. Cependant, si le développeur du type de champ sait que dans la plupart des cas elle peut être utilisée pour créer des colonnes contenant des numéros de téléphone américains, il peut définir la valeur par défaut en tant que <Default>^(\d{3})\d{3}-\d{4}$</Default>.

Remarque : l'exemple de code suivant a été modifié pour plus de clarté.

<FieldType>
  <Field Name="TypeName">RegularExpressionMatch</Field>
  …
  <PropertySchema>
    <Fields>
      <Field Name="RegularExpression" 
             DisplayName="Regular Expression To Match" 
             MaxLength="500" 
             DisplaySize="100" 
             Type="Text">
        <Default></Default>
      </Field>
    </Fields>
  </PropertySchema>
  …
</FieldType>

Voir aussi

Concepts

Types de champ personnalisés

Procédure : créer une classe de champ personnalisé

Rendu des propriétés de type de champ personnalisés

Procédure : créer une définition de type de champ personnalisé

Partager via