Élément PropertySchema (Types de champs)
S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | SharePoint En ligne | 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>
Important
Cette rubrique décrit le markup 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 par rapport aux versions antérieures de SharePoint Foundation. Pour plus d’informations sur la méthode recommandée, voir 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
Éléments parents
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. Considérons 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 pour les numéros de téléphone ^(\d{3})\d{3}-\d{4}$ américains.
Au lieu 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é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 de permettre aux utilisateurs qui créent des colonnes en fonction du 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, la création d’une colonne « Boîte de publication du Brésil » définirait 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 restitue 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 Colonne supplémentaire Paramètres page Nouvelle colonne de site et page Créer une colonne. L’élément PropertySchema dans le fichier est l’endroit où ces propriétés variables sont déclarées et un schéma de rendu par fldtypes*.xml défaut est attribué. Si vous le souhaitez, ils peuvent également se voir donner des valeurs 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 restituera 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 Texte modifiable apparaissent dans la section Colonne supplémentaire Paramètres page Nouvelle colonne de site et 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 sait que, dans la plupart des cas, il sera 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 comme <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>