Partager via

Concepteur personnalisé pour la configuration d’adaptateurs

  • Article

Les concepteurs personnalisés doivent être créés dans une bibliothèque de classes .NET. Vous pouvez les incorporer dans la DLL de l'adaptateur ou créer une DLL distincte. Une fois que vous avez créé un assembly de concepteur, vous devez le référencer par le biais de décorations, tout comme une description ou une catégorie. La référence inclut une spécification de l'assembly et un nom de classe complet.

Ces décorations prennent en charge deux façons de référencer le concepteur personnalisé spécifique : en tant qu’assembly global dans le global assembly cache ou en tant qu’assembly externe situé sur le disque.

Notes

Il existe deux chemins d’assembly possibles au moment de la conception : vous pouvez spécifier le chemin d’accès absolu aux éditeurs et convertisseurs de type utilisés dans la configuration XSD dans le XSD lui-même (le chemin relatif n’est pas pris en charge), ou vous pouvez stocker les éditeurs de types et les convertisseurs dans le global assembly cache sans avoir besoin d’un chemin absolu.

Utilisation du concepteur du Global Assembly Cache

Le Global Assembly Cache stocke les assemblys en fonction de leur nom, clé publique, version et culture. Il est donc recommandé de :

  1. générer un fichier de clé publique et de l'ajouter au fichier AssemblyInfo.cs ;

  2. spécifier une version spécifique du fichier AssemblyInfo.cs.

    Vous pouvez faire glisser l'assembly dans le Global Assembly Cache ou utiliser GACUTIL pour l'ajouter au GAC.

    Pour utiliser ce concepteur, indiquez le nom de classe complet, une virgule et l'entrée de l'assembly dans le Global Assembly Cache (nom de l'assembly, version, culture et jeton de clé publique) en tant que valeur de la décoration. Utilisez <des décorations d’éditeur> pour les implémentations UITypeEditor et <des décorations de convertisseur> pour les implémentations TypeConverter .

    Le code ci-dessous indique comment initialiser les concepteurs personnalisés dans un fichier XSD :

<xs:element name="Global" type="xs:string">  
   <xs:annotation>  
      <xs:appinfo>  
         <baf:designer>  
            <baf:category>GAC Designer Component</baf:category>  
            <baf:editor>AdapterManagement.ComponentModel. PasswordUITypeEditor, AdapterManagement, Version=1.0.1.0, Culture=neutral, PublicKeyToken=f0db50abb0615c18</baf:editor>  
         </baf:designer>  
      </xs:appinfo>  
   </xs:annotation>  
</xs:element>  
      </xs:sequence>

Installation et utilisation d'un assembly externe

Pour les assemblys externes, la décoration contient un assembly d'attribut facultatif qui spécifie le chemin d'accès complet et le nom de l'assembly contenant le concepteur souhaité.

Le code ci-dessous indique comment initialiser les concepteurs personnalisés contenus dans des assemblys externes :

<xs:element name="External" type="xs:string">  
   <xs:annotation>  
      <xs:appinfo>  
         <baf:designer>  
            <baf:category>External Designer Component</baf:category>  
            <baf:converter assembly="C:\source\private\Adapter\Framework\Designer\bin\Debug\Designer.External.dll">Designer.External.DesignerTypeConverter</baf:converter>  
         </baf:designer>  
      </xs:appinfo>  
   </xs:annotation>  
</xs:element>

Voir aussi

Éditeur déroulant personnalisé pour la configuration d’adaptateurs
Éditeur de boîtes de dialogue modales personnalisé pour la configuration d’adaptateurs
Convertisseur de type personnalisé pour la configuration d’adaptateurs
Composants de configuration avancée pour les adaptateurs