Web サービス記述言語ツール (Wsdl.exe)

[アーティクル]
09/17/2008

Web サービス記述言語ツールは、WSDL コントラクトファイル、XSD スキーマ、および .discomap 探索ドキュメントから、XML Web サービスおよび XML Web サービスクライアントのコードを生成します。

wsdl [options] {URL | path}

解説

引数説明

引数	説明
URL	WSDL コントラクトファイル (.wsdl)、XSD スキーマファイル (.xsd)、または探索ドキュメント (.disco) への URL。.discomap 探索ドキュメントへの URL は指定できません。
Path	ローカル WSDL コントラクトファイル (.wsdl)、XSD スキーマファイル (.xsd)、または探索ドキュメント (.disco または .discomap) へのパス。メモ : Wsdl.exe は、ローカルファイルが指定されている場合、ネットワークからインクルードやインポートを取得しません。Wsdl.exe でローカルファイルの処理中にネットワークリソースの取得を有効にするには、ローカルファイルへの URL を渡します。たとえば、次のファイルでは必要なリソースの取得にネットワークを使用します。 `wsdl File:///E:/Customers/WSDLS/Accounts.wsdl /out:proxy.cs`

URL

WSDL コントラクトファイル (.wsdl)、XSD スキーマファイル (.xsd)、または探索ドキュメント (.disco) への URL。.discomap 探索ドキュメントへの URL は指定できません。

Path

ローカル WSDL コントラクトファイル (.wsdl)、XSD スキーマファイル (.xsd)、または探索ドキュメント (.disco または .discomap) へのパス。

メモ :

Wsdl.exe は、ローカルファイルが指定されている場合、ネットワークからインクルードやインポートを取得しません。Wsdl.exe でローカルファイルの処理中にネットワークリソースの取得を有効にするには、ローカルファイルへの URL を渡します。たとえば、次のファイルでは必要なリソースの取得にネットワークを使用します。 wsdl File:///E:/Customers/WSDLS/Accounts.wsdl /out:proxy.cs

オプション	説明
/appsettingurlkey:key または /urlkey:key	コードを生成するときに URL プロパティの既定値を読み込むために使用する構成キーを指定します。/parameters オプションを使用する場合、この値は文字列を含む <appSettingUrlKey> 要素になります。
/appsettingbaseurl:baseurl または /baseurl:baseurl	URL フラグメントを計算するときに使用するベース URL を指定します。このツールは、相対 URL を baseurl 引数から WSDL ドキュメント内の URL へ変換することにより、URL フラグメントを計算します。このオプションと共に /appsettingurlkey オプションを指定する必要があります。/parameters オプションを使用する場合、この値は文字列を含む <appSettingBaseUrl> 要素になります。
/d[omain]:domain	認証情報を要求するサーバーに接続するときに使用するドメイン名を指定します。/parameters オプションを使用する場合、この値は文字列を含む <domain> 要素になります。
/l[anguage]:language	生成されたプロキシクラスのために使用する言語を指定します。引数 language として CS (C#、既定値)、VB (Visual Basic)、JS (JScript)、または VJS (Visual J#) を指定できます。System.CodeDom.Compiler.CodeDomProvider クラスを実装するクラスの完全限定名も指定できます。/parameters オプションを使用する場合、この値は文字列を含む <language> 要素になります。
/n[amespace]:namespace	生成されたプロキシまたはテンプレートの名前空間を指定します。既定の名前空間はグローバル名前空間です。/parameters オプションを使用する場合、この値は文字列を含む <namespace> 要素になります。この要素は、パラメータファイルに必ず含める必要があります。
/nologo	Microsoft 著作権情報を表示しません。/parameters オプションを使用する場合、この値は true または false を含む <nologo> 要素になります。
/order	パーティクルメンバに明示的な順序 ID を生成します。
/o[ut]:filename または directoryname	生成されたプロキシコードを保存するファイル (またはディレクトリ) を指定します。このファイルを作成するディレクトリを作成することもできます。このツールは、XML Web サービス名から既定のファイル名を派生します。このツールは、生成されたデータセットを複数のファイルに保存します。/parameters オプションを使用する場合、この値は文字列を含む <out> 要素になります。
/parameters	指定された xml ファイルから、コマンドラインオプションを読み取ります。Wsdl.exe ツールに一度に多数のオプションを渡す場合は、このオプションを使用します。省略形は /par: です。オプションの要素は、<wsdlParameters xmlns="https://microsoft.com/webReference/"> 要素の内部に含まれています。詳細については、「解説」を参照してください。
/parsableerrors	言語コンパイラで使用されているエラーレポート形式に似た形式でエラーを表示します。/parameters オプションを使用する場合、この値は <parsableerrors> 要素になり、true または false になります。
/p[assword]:password	認証情報を要求するサーバーに接続するときに使用するパスワードを指定します。/parameters オプションを使用する場合、この値は文字列を含む <password> 要素になります。
/protocol:protocol	実装するプロトコルを指定します。SOAP (既定値)、HttpGet、HttpPost、または構成ファイルで指定されたカスタムプロトコルを指定できます。/parameters オプションを使用する場合、この値は文字列を含む <protocol> 要素になります。
/proxy:URL	HTTP 要求のために使用するプロキシサーバーの URL を指定します。既定では、システムプロキシ設定を使用します。/parameters オプションを使用する場合、この値は文字列を含む <proxy> 要素になります。
/proxydomain:domain または /pd:domain	認証を必要とするプロキシサーバーに接続するときに使用するドメインを指定します。/parameters オプションを使用する場合、この値は文字列を含む <proxydomain> 要素になります。
/proxypassword:password または /pp:password	認証情報を要求するプロキシサーバーに接続するときに使用するパスワードを指定します。/parameters オプションを使用する場合、この値は文字列を含む <proxypassword> 要素になります。
/proxyusername:username または /pu:username	認証情報を要求するプロキシサーバーに接続するときに使用するユーザー名を指定します。/parameters オプションを使用する場合、この値は文字列を含む <proxyusername> 要素になります。
/server	コントラクトに基づく XML Web サービスのための抽象クラスを生成します。既定では、クライアントプロキシクラスを生成します。/parameters オプションを使用する場合、この値は "server" を含む <style> 要素になります。
/serverInterface	ASP.NET Web サービスのサーバーの実装に対するインターフェイスを生成します。WSDL ドキュメントの各バインディングに対して、インターフェイスが生成されます。WSDL だけが WSDL コントラクトを実装します (インターフェイスを実装するクラスには、クラスメソッド上に、Web サービス属性、または WSDL コントラクトを変更するシリアル化属性のいずれも含めません)。省略形は /si: です。/parameters オプションを使用する場合、この値は "serverInterface" を含む <style> 要素になります。
/sharetypes	型の共有機能をオンにします。この機能は、異なるサービス間で共有される同じ型に対して 1 つの型の定義で 1 つのコードファイルを作成します (名前空間、名前、ワイヤシグネチャは同じになる必要があります)。コマンドラインパラメータとして "http://" の付いた URL でサービスを参照するか、ローカルファイルに対して discomap ドキュメントを作成します。 /parametersオプションを使用する場合、この値は <sharetypes> 要素になり、true または false になります。
/u[sername]:username	認証情報を要求するサーバーに接続するときに使用するユーザー名を指定します。/parameters オプションを使用する場合、この値は文字列を含む <username> 要素になります。
/?	このツールのコマンド構文とオプションを表示します。

.wsdl ファイルは、Web サービス記述言語 (WSDL: Web Service Description Language) という XML 文法で記述された XML ドキュメントです。このファイルは、XML Web サービスの動作を定義し、サービスとの対話方法をクライアントに命令します。

Web サービス検出ツール (Disco.exe) を使用して、XML Web サービスの探索ドキュメントを取得できます。このツールで生成された .discomap、.disco、.wsdl、.xsd の各ファイルは、Wsdl.exe への入力として使用できます。

Wsdl.exe を使用してプロキシクラスを作成すると、指定したプログラミング言語で 1 つのソースファイルが作成されます。プロキシクラスのソースコードを生成するプロセスでは、このツールは、サービス記述で指定されたオブジェクトに使用する最適な型を決定します。場合によっては、共通する必要最低限の機能を提供するアプローチを使用して、オブジェクトを型にキャストします。結果として、そのプロキシクラスの生成された型が開発者の意図するものと異なることがあります。たとえば、Wsdl.exe がサービスの説明で ArrayList 型を検出した場合は、生成するプロキシクラス内に Object Array を作成します。オブジェクト型が正しくキャストされるようにするには、生成されたプロキシクラスが含まれているファイルを開き、不適切なオブジェクト型を正しいオブジェクト型に変更します。

/parameters オプションには、ほとんどのコマンドプロンプトオプションに対応する要素を含むファイルを指定します。一部のコマンドプロンプトオプションは、/parameters のファイル形式だけで使用できます。

/parameters オプションが受け入れる XML ファイル形式には、<wsdlParameters xmlns="https://microsoft.com/webReference/"> 要素で囲まれた一連の要素があります。コマンドプロンプト値を指定し、異なるオプションまたは値を含む /parameters ファイルを使用すると、コマンドプロンプトで指定した値が使用されます。<wsdlParameters xmlns="https://microsoft.com/webReference/"> 要素は、<nologo> 要素、<parsableerrors> 要素、および <sharetypes> 要素を含む必要があります。

いくつかのオプションは <verbose> 要素を必ず含む <webReferenceOptions> 要素の子要素として渡されます。その他の <webReferenceOptions> 要素の子要素は次のとおりです。

<style> - "client"、"server"、または "serverInterface" を含みます。
<schemaImporterExtension> - 任意の数の <type> 要素を含みます。
<codeGenerationOptions> - スペースで区切られた次の文字列を受け取ることができます。
"properties"
"newAsync"
"oldAsync"
"order"
"enableDataBinding"

/parameters オプションの例については、次の「例」のセクションを参照してください。

例

次のコマンドは、XML Web サービスのために C# 言語でクライアントプロキシクラスを作成します。

wsdl http://hostServer/WebserviceRoot/WebServiceName.asmx?WSDL

指定した URL にある XML Web サービスの C# 言語におけるクライアントプロキシクラスを作成するコマンドを次に示します。このツールは、クライアントプロキシクラスを myProxyClass.cs ファイルに保存します。

wsdl /out:myProxyClass.cs http://hostServer/WebserviceRoot/WebServiceName.asmx?WSDL

指定した URL にある XML Web サービスの Microsoft Visual Basic 言語におけるクライアントプロキシクラスを作成するコマンドを次に示します。このツールは、クライアントプロキシクラスを myProxyClass.vb ファイルに保存します。

wsdl /language:VB /out:myProxyClass.vb http://hostServer/WebserviceRoot/WebServiceName.asmx?WSDL

コマンドプロンプトで URL 引数と組み合わせて使用できる必須の要素だけを含む基本的な /parameters WSDL ファイルのコード例を次に示します。

<wsdlParameters xmlns="https://microsoft.com/webReference/">
  <nologo>true</nologo>
  <parsableerrors>true</parsableerrors>
  <sharetypes>true</sharetypes>
</wsdlParameters>

WSDL ドキュメントは、次のコード例のように、<documents> 要素を使用して /parameters WSDL ファイルに追加されます。<documents> 要素では、任意の数の <document> 要素を使用できます。

<wsdlParameters xmlns="https://microsoft.com/webReference/">
  <nologo>true</nologo>
  <parsableerrors>true</parsableerrors>
  <sharetypes>true</sharetypes>
  <documents>
    <document>https://www.contoso.com/service.asmx?WSDL</document>
  </documents>
</wsdlParameters>

次の /parameters WSDL ファイルは、<webReferenceOptions> 要素内の <codeGenerationOptions> 要素と <style> 要素の使い方を示します。この場合、このファイルはプロキシコードで新しいスタイルのデータバインディングを有効にし、スキーマインポータの拡張機能を指定し、詳細情報は出力せず、Wsdl.exe はクライアントプロキシを作成するように指定します。

<wsdlParameters xmlns="https://microsoft.com/webReference/">
  <nologo>true</nologo>
  <parsableerrors>true</parsableerrors>
  <sharetypes>true</sharetypes>
  <documents>
    <document>https://www.contoso.com/service.asmx?WSDL</document>
  </documents>
  <webReferenceOptions>
    <verbose>false</verbose>
    <codeGenerationOptions>properties newAsync enableDataBinding</codeGenerationOptions>
    <schemaImporterExtension>
      <type>MyNamespace.MyCustomImporterExtension,ExtensionLibrary</type>
    </schemaImporterExtensions>
    <style>client</style>
  </webReferenceOptions>
</wsdlParameters>

次の方法で共有

Web サービス記述言語ツール (Wsdl.exe)

解説

例

関連項目

参照

概念

その他の技術情報

その他のリソース