Archivo de configuración de WsdCodeGen
Normalmente, la herramienta WsdCodeGen genera un archivo de configuración de WsdCodeGen. Puede crear archivos de configuración manualmente, pero la complejidad y la longitud del archivo normalmente excluyen la codificación manual. Se recomienda encarecidamente usar WsdCodeGen para generar el archivo. Para obtener más información sobre cómo generar archivos de configuración, vea Uso de WsdCodeGen y WsdCodeGen Sintaxis de línea de comandos.
Debe inspeccionar el archivo de configuración generado y, si es necesario, modificarlo antes de usarlo para crear código fuente. El archivo de configuración generado por WsdCodeGen suele ser suficiente para la mayoría del desarrollo de clientes.
Para usar el archivo de configuración para el desarrollo del servidor, se requieren algunas modificaciones. Si el hospedaje está habilitado (es decir, si se selecciona el modo "all" o "host"), modifique el contenido del elemento ThisModelMetadata y sus elementos secundarios según sea necesario. Además, modifique o quite los elementos PnPXDeviceCategory, PnPXHardwareId y PnPXCompatibleId dentro del elemento ThisModelMetadata o los elementos Hosted según sea necesario.
Un archivo de configuración consta de una secuencia de elementos que proporcionan datos de entrada para la generación de código seguidos de cualquier número de elementos de archivo que describen los archivos que se van a generar. Los datos de entrada incluyen algunas propiedades globales y referencias a tipos expresados en WSDL, XSD y ensamblados administrados. Text y CDATA en los elementos de archivo se escriben en los archivos generados sin modificaciones. Otros elementos de los elementos de archivo se reemplazan en los archivos generados por código generado.
Los archivos de configuración XML deben seguir algunas reglas generales para poder usarse correctamente con la utilidad del generador de código. Son las siguientes:
El elemento raíz de cualquier archivo de configuración es wsdCodeGen.
Los elementos que contienen tipos de datos simples son intercambiables con atributos. Por ejemplo:
<wsdCodeGen> <layerNumber>1</layerNumber> </wsdCodeGen>equivale a:
<wsdCodeGen layerNumber="1"/>En general, no hay ninguna restricción en el orden de los elementos. Por ejemplo:
<wsdCodeGen> <layerNumber>1</layerNumber> <layerPrefix>MEDIA_</layerPrefix> </wsdCodeGen>equivale a:
<wsdCodeGen> <layerPrefix>MEDIA_</layerPrefix> <layerNumber>1</layerNumber> </wsdCodeGen>Sin embargo, el generador de código procesa el archivo de configuración en un solo paso y la ordenación tiene cierta relevancia. Por ejemplo, los elementos de archivo que generan código relacionado con un tipo de puerto determinado deben producirse después del elemento que indica al generador de código que lea el contrato de tipo de puerto.
Para obtener una lista completa de los elementos usados en los archivos de configuración de WsdCodeGen, vea Referencia XML del archivo de configuración de WsdCodeGen.
Los archivos de configuración de ejemplo se incluyen con windows SDK. Para obtener más información, consulte Ejemplos de WSDAPI.
Temas relacionados