Fichier de configuration WsdCodeGen

  • Article

Un fichier de configuration WsdCodeGen est généralement généré par l’outil WsdCodeGen. Vous pouvez créer des fichiers de configuration manuellement, mais la complexité et la longueur du fichier empêchent généralement le codage manuel. Nous vous recommandons vivement d’utiliser WsdCodeGen pour générer le fichier. Pour plus d’informations sur la génération de fichiers de configuration, consultez Utilisation de la syntaxe de ligne de commande WsdCodeGen et WsdCodeGen.

Vous devez inspecter le fichier de configuration généré et, si nécessaire, le modifier avant de l’utiliser pour créer du code source. Le fichier de configuration généré par WsdCodeGen est généralement suffisant pour la plupart des développements clients.

Pour utiliser le fichier de configuration pour le développement de serveur, certaines modifications sont nécessaires. Si l’hébergement est activé (c’est-à-dire si le mode « tout » ou « hôte » est sélectionné), modifiez le contenu de l’élément ThisModelMetadata et de ses éléments enfants si nécessaire. En outre, modifiez ou supprimez les éléments PnPXDeviceCategory, PnPXHardwareId et PnPXCompatibleId à l’intérieur de l’élément ThisModelMetadata ou des éléments Hébergés si nécessaire.

Un fichier de configuration se compose d’une séquence d’éléments qui fournissent des données d’entrée pour la génération de code, suivie d’un nombre quelconque d’éléments de fichier qui décrivent les fichiers à générer. Les données d’entrée incluent quelques propriétés globales et références aux types exprimés en WSDL, XSD et assemblys managés. Text et CDATA dans les éléments file sont écrits dans les fichiers générés sans modification. Les autres éléments des éléments de fichier sont remplacés dans les fichiers générés par du code généré.

Les fichiers de configuration XML doivent suivre quelques règles générales pour être correctement mis en forme en vue d’une utilisation avec l’utilitaire générateur de code. Ces règles sont les suivantes :

  • L’élément racine d’un fichier de configuration est wsdCodeGen.

  • Les éléments qui contiennent des types de données simples sont interchangeables avec des attributs. Exemple :

    <wsdCodeGen>
    <layerNumber>1</layerNumber>
</wsdCodeGen>

    équivaut à :

    <wsdCodeGen layerNumber="1"/>

  • En général, il n’existe aucune contrainte sur l’ordre des éléments. Exemple :

    <wsdCodeGen>
    <layerNumber>1</layerNumber>
    <layerPrefix>MEDIA_</layerPrefix>
</wsdCodeGen>

    équivaut à :

    <wsdCodeGen>
    <layerPrefix>MEDIA_</layerPrefix>
    <layerNumber>1</layerNumber>
</wsdCodeGen>

    Toutefois, le générateur de code traite le fichier de configuration en une seule passe, et le classement a une certaine pertinence. Par exemple, les éléments de fichier qui génèrent du code relatif à un type de port particulier doivent se produire après l’élément qui indique au générateur de code de lire le contrat de type de port.

Pour obtenir la liste complète des éléments utilisés dans les fichiers de configuration WsdCodeGen, consultez Référence XML du fichier de configuration WsdCodeGen.

Des exemples de fichiers de configuration sont inclus avec le SDK Windows. Pour plus d’informations, consultez Exemples WSDAPI.

À propos de WsdCodeGen

Exemples WSDAPI