GeneradorDeCódigoDeConfiguración

ConfigurationCodeGenerator es una herramienta que puede usar para exponer las implementaciones de canal personalizadas al sistema de configuración. Esto permite a los usuarios de su canal personalizado configurar el canal usando un archivo .config de la misma manera que lo harían con una vinculación proporcionada por el sistema, como NetTcpBinding, o con una vinculación personalizada usando el TcpTransportBindingElement.

Al escribir un canal personalizado y exponerlo al modelo de programación mediante un nuevo BindingElement o Binding, debe crear un conjunto de clases para que el BindingElement o el Binding sean configurables con un archivo .config. Puede usar la herramienta ConfigurationCodeGenerator para generar estas clases y mejorar la experiencia del cliente.

Para compilar la herramienta

1. Para compilar la solución, siga las instrucciones que se indican en Compilación de los ejemplos de Windows Communication Foundation.

2. La compilación de la solución genera un archivo: ConfigurationCodeGenerator.exe. El archivo SampleRun.cmd tiene una línea de comandos de ejemplo que muestra cómo usar esta herramienta para generar las clases para el ejemplo Transport: UDP .

Para ejecutar la herramienta

1. En el símbolo del sistema escriba lo siguiente si tiene un tipo BindingElement personalizado y un tipo Binding personalizado:

   ConfigurationCodeGenerator.exe /be:YourCustomBindingElementTypeName /sb:YourCustomStdBindingTypeName /dll:TheAssemblyWhereTheseTypesAreDefined
   

   O escriba lo siguiente si solo tiene un tipo personalizado BindingElement :

   ConfigurationCodeGenerator.exe /be:YourCustomBindingElementTypeName /dll: TheAssemblyWhereThisTypeIsDefined
   

   O escriba lo siguiente si solo tiene un tipo personalizado Binding :

   ConfigurationCodeGenerator.exe /sb:YourCustomStdBindingTypeName /dll:TheAssemblyWhereThisTypeIsDefined
   

   El comando genera tres archivos .cs para BindingElement (si especificó la opción /be): cinco archivos .cs para el estándar Binding (si especificó la opción /sb: ) y un archivo .xml.

   1. Si utilizó la opción /be, uno de los archivos .cs implementa BindingElementExtensionSection para su elemento de enlace. Este código expone BindingElement al sistema de configuración, de modo que otros elementos de vinculación personalizados puedan utilizar su elemento de vinculación. Los demás archivos tienen clases que representan valores predeterminados y constantes. Los archivos tienen //TODO comentarios para recordarle que actualice los valores predeterminados.

   2. Si especificó la opción /sb, dos de los archivos de .cs implementan un StandardBindingElement y un StandardBindingCollectionElement respectivamente, lo que expone su enlace estándar al sistema de configuración. Los demás archivos tienen clases que representan valores predeterminados y constantes. Los archivos tienen //TODO comentarios para recordarle que actualice los valores predeterminados.

      Si especificó la opción /sb:, el archivo CodeToAddTo<YourStdBinding>.cs contiene código que debe agregar manualmente a la clase que implementa su enlace estándar.

   El archivo SampleConfig.xml contiene el código de configuración que debe agregar al archivo de configuración que registra los controladores definidos en el paso 1 o 2 anterior.