Partager via

Contrôles d'éditeur pour les propriétés de type de champ

  • Article

Dernière modification : mercredi 30 septembre 2009

S’applique à : SharePoint Foundation 2010

Un contrôle d'éditeur pour les propriétés de variable d'un type de champ permet, en lieu et place d'un PropertySchema, élément (Types de champs), de restituer les propriétés du champ sur les pages Nouvelle colonne de site, Modifier la colonne de site, Créer une colonne et Modifier la colonne. Voir Rendu des propriétés de type de champ personnalisés pour une vue d'ensemble des deux options et une description des conditions d'utilisation de chaque méthode.

Créer un contrôle d'éditeur

Un contrôle d’éditeur est défini dans un fichier .ascx stocké à l’emplacement %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\ControlTemplates et dans un fichier code-behind compilés dans le même assembly que la classe de champs personnalisés. Outre restituer les propriétés du champ, le contrôle d’éditeur prend en charge des créateurs de colonne qui définissent ces propriétés à l’aide de fonctions spéciales, telles que la logique de calcul complexe, la recherche de valeurs dans des sources de données et la validation de données personnalisée.

Remarque   Nous vous recommandons de nommer vos classes de contrôles d'éditeur à l'aide de la convention d'affectation de noms suivante :

nom_type_champFieldEditor

par exemple, TargetDateFieldEditor ou RegularExpressionFieldEditor. Grâce à cette convention, votre fichier .ascx sera nommé nom_type_champFieldEditor.ascx et héritera de la classe code-behind nom_type_champFieldEditor.

Interface IFieldEditor

Pour agir comme un contrôle utilisateur d'éditeur de champ, la classe code-behind doit :

L'interface IFieldEditor contient la propriété et les méthodes suivantes. Cliquez sur leur nom respectif pour connaître l'implémentation correspondante.

  • DisplayAsNewSection   Utilisez cette propriété pour spécifier si vous souhaitez que le contrôle soit affiché dans la section Paramètres de colonne supplémentaires des pages Nouvelle colonne de site, Modifier la colonne de site, Créer une colonne et Modifier la colonne ou seul dans une nouvelle section.

  • OnSaveChange   Utilisez cette méthode pour valider et enregistrer les modifications apportées aux propriétés de champ (colonne) par un créateur ou éditeur de colonne.

  • InitializeWithField   Utilisez cette méthode pour initialiser le contrôle d'éditeur avec les valeurs par défaut ou les valeurs de propriété actuelles du champ (colonne).

Voir aussi

Concepts

Types de champ personnalisés

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

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