次の方法で共有

WsdCodeGen 構成ファイル

WsdCodeGen 構成ファイルは、通常、WsdCodeGen ツールによって生成されます。 構成ファイルは手動で作成できますが、ファイルの複雑さと長さは通常、手動コーディングを妨げる可能性があります。 WsdCodeGen を使用してファイルを生成することを強くお勧めします。 構成ファイルの生成の詳細については、「WsdCodeGen の使用と WsdCodeGen コマンド ライン構文の を参照してください。

生成された構成ファイルを検査し、必要に応じて、ソース コードを作成するために使用する前に変更する必要があります。 WsdCodeGen によって生成される構成ファイルは、通常、ほとんどのクライアント開発に十分です。

サーバー開発に構成ファイルを使用するには、いくつかの変更が必要です。 ホスティングが有効になっている場合 (つまり、"all" または "host" モードが選択されている場合)、必要に応じて、ThisModelMetadata 要素とその子要素の内容を変更します。 また、必要に応じて、PnPXDeviceCategory、PnPXHardwareId、および PnPXCompatibleIdThisModelMetadata 要素または Hosted 要素内の要素を変更または削除します。

構成ファイルは、コード生成用の入力データを提供する一連の要素の後に、生成するファイルを記述する任意の数の ファイル 要素で構成されます。 入力データには、いくつかのグローバル プロパティと、WSDL、XSD、およびマネージド アセンブリで表される型への参照が含まれています。 ファイル内のテキストと CDATA 要素は、変更なしで生成されたファイルに書き込まれます。 ファイル内の他の要素 要素は、生成されたファイル内で生成されたコードに置き換えられます。

XML 構成ファイルは、コード ジェネレーター ユーティリティで使用できるように適切に書式設定するために、いくつかの一般的な規則に従う必要があります。 これらは：

  • 構成ファイルのルート要素は wsdCodeGenです。

  • 単純なデータ型を含む要素は、属性と交換可能です。 例えば：

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

    は次の内容に相当します。

    <wsdCodeGen layerNumber="1"/>

  • 一般に、要素の順序に制約はありません。 例えば：

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

    は次の内容に相当します。

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

    ただし、コード ジェネレーターは構成ファイルを 1 回のパスで処理し、順序付けには関連性があります。 たとえば、ファイル 特定のポート型に関連するコードを生成する要素は、コード ジェネレーターにポート型コントラクトの読み取りを指示する要素の後に存在する必要があります。

WsdCodeGen 構成ファイルで使用される要素の完全な一覧については、「WsdCodeGen 構成ファイル XML リファレンス を参照してください。

サンプル構成ファイルは、Windows SDK に含まれています。 詳細については、WSDAPI サンプル を参照してください。

WsdCodeGen について

WSDAPI サンプル の