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

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

Windows SharePoint Services 3

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 C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\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 :

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

Afficher: