Compartir a través de

Archivo de configuración de WsdCodeGen

Normalmente, la herramienta WsdCodeGen genera un archivo de configuración 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 Using WsdCodeGen and WsdCodeGen Command Line Syntax.

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

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 thisModelMetadata elemento y sus elementos secundarios según sea necesario. Además, modifique o quite el PnPXDeviceCategory, PnPXHardwareIdy elementos PnPXCompatibleId dentro del elemento ThisModelMetadata o 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 archivo elementos que describen los archivos que se van a generar. Los datos de entrada incluyen algunas propiedades globales y referencias a tipos expresados en ensamblados WSDL, XSD y administrados. Text y CDATA en archivo elementos se escriben en los archivos generados sin modificaciones. Otros elementos de archivo elementos se reemplazan en los archivos generados por código generado.

Los archivos de configuración XML deben seguir algunas reglas generales para tener el formato correcto para su uso con la utilidad generador de código. Estos son:

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

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

    es equivalente 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, archivo elementos 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 WsdCodeGen.

Los archivos de configuración de ejemplo se incluyen con windows SDK. Para obtener más información, consulte ejemplos de WSDAPI.

Acerca de WsdCodeGen

ejemplos de WSDAPI de