WsdCodeGen 構成ファイル
WsdCodeGen 構成ファイルは通常、WsdCodeGen ツールによって生成されます。 構成ファイルは手動で作成できますが、ファイルの複雑さと長さは通常、手動コーディングを妨げる可能性があります。 WsdCodeGen を使用してファイルを生成することを強くお勧めします。 構成ファイルの生成の詳細については、「 WsdCodeGen と WsdCodeGen コマンド ライン構文の使用」を参照してください。
生成された構成ファイルを検査し、必要に応じて、ソース コードを作成するために使用する前に変更する必要があります。 WsdCodeGen によって生成される構成ファイルは、通常、ほとんどのクライアント開発に十分です。
サーバー開発に構成ファイルを使用するには、いくつかの変更が必要です。 ホスティングが有効になっている場合 (つまり、"all" または "host" モードが選択されている場合)、必要に応じて ThisModelMetadata 要素とその子要素の内容を変更します。 また、必要に応じて、ThisModelMetadata 要素または Hosted 要素内の PnPXDeviceCategory、PnPXHardwareId、および PnPXCompatibleId 要素を変更または削除します。
構成ファイルは、コード生成用の入力データを提供する一連の要素の後に、生成されるファイルを記述する任意の数の ファイル 要素で構成されます。 入力データには、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 サンプル」を参照してください。
関連トピック