Sdílet prostřednictvím

Konfigurační soubor WsdCodeGen

Konfigurační soubor WsdCodeGen je obvykle generován nástrojem WsdCodeGen. Konfigurační soubory můžete vytvářet ručně, ale složitost a délka souboru obvykle brání ručnímu kódování. K vygenerování souboru důrazně doporučujeme použít WsdCodeGen. Další informace o generování konfiguračních souborů naleznete v tématu Using WsdCodeGen a WsdCodeGen Syntaxe příkazového řádku.

Než ho použijete k vytvoření zdrojového kódu, měli byste zkontrolovat vygenerovaný konfigurační soubor a v případě potřeby ho upravit. Konfigurační soubor vygenerovaný wsdCodeGen obvykle stačí pro většinu vývoje klientů.

Pokud chcete konfigurační soubor použít pro vývoj serveru, vyžadují se některé úpravy. Pokud je povoleno hostování (tj. pokud je vybrán režim "all" nebo "host"), upravte obsah ThisModelMetadata elementu a jeho podřízených elementů podle potřeby. Upravte nebo odeberte také prvky PnPXDeviceCategory, PnPXHardwareIda PnPXCompatibleId uvnitř elementu ThisModelMetadata nebo hostované elementy podle potřeby.

Konfigurační soubor se skládá z posloupnosti prvků, které poskytují vstupní data pro generování kódu, následovaný libovolným počtem souborů prvky, které popisují soubory, které mají být generovány. Vstupní data obsahují několik globálních vlastností a odkazů na typy vyjádřené ve WSDL, XSD a spravovaných sestaveních. Text a CDATA v souboru elementy se zapisují do vygenerovaných souborů beze změny. Ostatní prvky v souboru prvky jsou nahrazeny ve vygenerovaných souborech vygenerovaným kódem.

Konfigurační soubory XML musí dodržovat několik obecných pravidel, aby byly správně naformátované pro použití s nástrojem generátoru kódu. Toto jsou:

  • Kořenový prvek jakéhokoli konfiguračního souboru je wsdCodeGen.

  • Prvky, které obsahují jednoduché datové typy, jsou zaměnitelné s atributy. Například:

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

    odpovídá:

    <wsdCodeGen layerNumber="1"/>

  • Obecně platí, že řazení prvků není nijak omezené. Například:

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

    odpovídá:

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

    Generátor kódu ale zpracovává konfigurační soubor v jediném průchodu a řazení má určitou relevanci. Například soubor prvky, které generují kód vztahující se k určitému typu portu, musí dojít za element, který dává generátoru kódu pokyn ke čtení kontraktu typu portu.

Úplný seznam elementů použitých v konfiguračních souborech WsdCodeGen naleznete v tématu Xml konfiguračního souboru WsdCodeGen referenční.

Ukázkové konfigurační soubory jsou součástí sady Windows SDK. Další informace najdete v tématu ukázky WSDAPI.

o WsdCodeGen

ukázky WSDAPI

 

 

  • Last updated on