Élément PropertySchema (Types de champs)

Article
04/08/2023

S’applique à : | SharePoint 2016 SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013

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>

Importante

Cette rubrique décrit le balisage utilisé dans une méthode obsolète de rendu des propriétés de type de champ personnalisé. Il est fourni uniquement pour faciliter le débogage des propriétés de type de champ personnalisé développées sur des versions antérieures de SharePoint Foundation. Pour plus d’informations sur la méthode recommandée, consultez Custom Field Type Property Rendering.

Éléments et attributs

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

Attributs

Aucun

Éléments enfants

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

Éléments parents

FieldType, élément (Types de champs)

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 l’exemple d’un type de champ d’expression régulière personnalisé conçu pour contenir des valeurs string qui correspondent à une certaine expression régulière, comme ^(\d{3})\d{3}-\d{4}$ pour les numéros de téléphone américains.

Plutôt que de créer des types de champs d’expression régulière personnalisés distincts pour les numéros de plaque de licence britannique, les numéros de sécurité sociale américaine, les numéros de téléphone chinois, etc., il est plus efficace de créer un seul type de champ d’expression régulière et de permettre aux utilisateurs qui créent des colonnes basées sur le type de champ de définir l’expression régulière qui doit être mise en correspondance 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 « Brazilian Post Box » définit l’expression régulière de sa colonne sur ^\d{5}\-\d{3}$.

Pour ce faire, le champ personnalisé doit avoir une propriété RegularExpression qui est affichée dans un contrôle modifiable sur l’interface utilisateur (IU) lors de la création d’une colonne. Dans SharePoint Foundation, il se trouve dans la section Paramètres de colonne supplémentaire de la page Nouvelle colonne de site et la page Créer une colonne . L’élément PropertySchema dans le fichier est l’endroit fldtypes*.xml où ces propriétés de variable sont déclarées et reçoivent un schéma de rendu par défaut. Si vous le souhaitez, vous pouvez également leur attribuer des valeurs par défaut.

Remarque

Si vous définissez les propriétés de variable 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.

Le displayName et un champ Texte modifiable s’affichent 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’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, mais si le développeur du type de champ savait que dans la plupart des cas, il serait utilisé pour créer des colonnes contenant des numéros de téléphone américains, le développeur peut définir la valeur par défaut sur <Default>^(\d{3})\d{3}-\d{4}$</Default>.

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>

Partager via