Default, élément (Field Types, propriété)

Article
04/08/2023

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

Représente la valeur par défaut d'une propriété d'un type de champ personnalisé.

<Default>
</Default>

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

Aucun

Éléments parents

Field, élément (Types de champs)

Remarques

Pour obtenir une description de cet élément dans le contexte, consultez PropertySchema, élément (types de champs) .

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 qui peut être utilisé par les créateurs de colonne lorsqu'ils créent une colonne en fonction du type de champ. La finalité du champ est de permettre à un créateur de colonne de définir une expression régulière différente pour chaque colonne qui repose sur le type de champ RegularExpressionMatch.

Le displayName et le 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, tandis que DisplaySize définit la taille du champ qui contient l'attribut MaxLength. Les utilisateurs peuvent parcourir le champ pour voir le reste de l'expression régulière si celle-ci est plus longue que ce qui apparaît dans le champ DisplaySize.

Dans l’exemple de code suivant, l’élément Default de la propriété est ^(\d{3})\d{3}-\d{4}$ dû au fait que ce modèle correspond aux numéros de téléphone américains, et dans cet exemple, le développeur sait que son champ sera le plus fréquemment utilisé pour créer des colonnes contenant des numéros de téléphone américains. Lorsque les utilisateurs créent une colonne basée sur un type de champ personnalisé et que les pages Nouvelle colonne de site et Créer une colonne s’ouvrent initialement, cette valeur de propriété apparaît dans une zone de texte, où elle peut ensuite être modifiée par le créateur de la colonne.

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>^(\d{3})\d{3}-\d{4}$</Default>
      </Field>
    </Fields>
  </PropertySchema>
  …
</FieldType>

Partager via