Diseñador de configuración de adaptadores personalizados

Deberá crear una biblioteca de clases .NET a partir de los diseñadores personalizados. Puede integrarlos al DLL del adaptador o crear un DLL distinto. Una vez creado un ensamblado de diseñador debe hacer referencia a él mediante decoraciones, como lo haría con una descripción o categoría. La referencia incluye una especificación del ensamblado y un nombre completo de clase para su uso.

Estas decoraciones admiten dos formas de hacer referencia al diseñador personalizado específico: como un ensamblado global en la caché global de ensamblados o como un ensamblado externo ubicado en el disco.

Nota

Hay dos posibles rutas de acceso de ensamblado en tiempo de diseño: puede especificar la ruta de acceso absoluta a los editores de tipos y convertidores usados en la configuración XSD en el propio XSD (no se admite la ruta de acceso relativa), o puede almacenar los editores de tipos y convertidores en la caché global de ensamblados y no necesita una ruta de acceso absoluta.

Uso del diseñador de la caché de ensamblados global

La caché de ensamblados global almacena ensamblados por nombre, clave pública, versión y referencia cultural. Por este motivo es recomendable:

1. Generar un archivo de clave pública y agregarlo al archivo AssemblyInfo.cs.

2. Especificar una versión específica en el archivo AssemblyInfo.cs.

   Puede arrastrar el ensamblado hasta la caché de ensamblados global o usar GACUTIL para agregarlo a ella.

   Para usar este diseñador, especifique el nombre completo de clase, una coma y la entrada de la caché de ensamblados global (nombre de ensamblado, versión, referencia cultural y token de clave pública) como valor de la decoración. Usa <decoraciones de editor> para implementaciones de UITypeEditor y <decoraciones de convertidor> para implementaciones de TypeConverter .

   En el código siguiente se muestra cómo inicializar los diseñadores personalizados en un archivo 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>  

Instalación y uso de un ensamblado externo

Para ensamblados externos, la decoración contiene un ensamblado de atributo opcional que especifica el nombre y ruta completos del ensamblado que contiene el diseñador deseado.

En el código siguiente se muestra cómo inicializar los diseñadores personalizados contenidos en ensamblados externos:

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

Consulte también

Editor desplegable personalizado para la configuración del adaptador
Editor de cuadro de diálogo modal personalizado para la configuración del adaptador
Convertidor de tipos personalizado para la configuración del adaptador
Componentes de configuración avanzada para adaptadores