Freigeben über


Designer für benutzerdefinierte Adapterkonfiguration

Sie müssen benutzerdefinierte Designer in eine .NET-Klassenbibliothek integrieren. Sie können diese in die DLL-Datei für den Adapter aufnehmen oder eine eigenständige DLL-Datei erstellen. Nach dem Erstellen einer Designerassembly müssen Sie wie eine Beschreibung oder Kategorie über Ergänzungen auf diese verweisen. Der Verweis umfasst eine Spezifikation der Assembly sowie den zu verwendenden voll gekennzeichneten Klassennamen.

Diese Dekorationen unterstützen zwei Möglichkeiten, auf den spezifischen benutzerdefinierten Designer zu verweisen: als globale Assembly im globalen Assemblycache oder als externe Assembly, die sich auf dem Datenträger befindet.

Hinweis

Es gibt zwei mögliche Entwurfszeitassemblypfade: Sie können den absoluten Pfad zu den Typ-Editoren und Konvertern angeben, die in der XSD-Konfiguration in der XSD selbst verwendet werden (relativer Pfad wird nicht unterstützt), oder Sie können die Typ-Editoren und Konverter im globalen Assemblycache speichern und keinen absoluten Pfad benötigen.

Verwendung des Designers im globalen Assemblycache

Der globale Assemblycache speichert Assemblys nach Assemblyname, öffentlichem Schlüssel, Version und Kultur. Daher sollten Sie Folgendes beachten:

  1. Generieren Sie eine Datei mit dem öffentlichen Schlüssel, und fügen Sie diese Datei der Datei AssemblyInfo.cs hinzu.

  2. Geben Sie in der Datei AssemblyInfo.cs eine bestimmte Version an.

    Sie können die Assembly in den globalen Assemblycache ziehen oder mithilfe von GACUTIL dem globalen Assemblycache hinzufügen.

    Geben Sie zum Verwenden dieses Designers den voll gekennzeichneten Klassennamen, ein Komma und den Assemblyeintrag im globalen Assemblycache (Assemblyname, Version, Kultur und öffentliches Schlüsseltoken) als Wert der Ergänzung an. Verwenden Sie <Editordekorationen> für UITypeEditor-Implementierungen und <Konverterdekorationen> für TypeConverter-Implementierungen .

    Im folgenden Code wird das Initialisieren der benutzerdefinierten Designer in einer XSD-Datei veranschaulicht:

<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>  

Installieren und Verwenden externer Assemblys

Bei externen Assemblys enthält die Ergänzung eine optionale Attributassembly, die den vollständigen Pfad und Namen der Assembly mit dem gewünschten Designer angibt.

Im folgenden Code wird das Initialisieren der benutzerdefinierten Designer in einer externen Assembly veranschaulicht:

<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>  

Weitere Informationen

Benutzerdefinierter Dropdowneditor zur Adapterkonfiguration
Benutzerdefinierter Editor für modale Dialogfelder zur Adapterkonfiguration
Benutzerdefinierter Typkonverter für die Adapterkonfiguration
Erweiterte Konfigurationskomponenten für Adapter