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

PropertySchema, élément (Types de champs)

Windows SharePoint Services 3

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>

Attribut Description

None

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 Windows SharePoint Services 3.0, 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.

Remarque Remarque :

Si vous définissez les propriétés variables du type de champ personnalisé dans l'élément PropertySchema, Windows SharePoint Services 3.0 affiche automatiquement ces propriétés en fonction du schéma. Vous pouvez également définir le rendu de vos propriétés de types de champs à l'aide d'un contrôle utilisateur d'éditeur de champ. Pour plus d'informations sur les avantages de chaque approche, voir Rendu des propriétés de type de champ personnalisés.

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>
Afficher: