IWsdlImportExtension インターフェイス

定義

名前空間:

System.ServiceModel.Description

アセンブリ:

System.ServiceModel.dll

WsdlImporter オブジェクトを実装してそれに接続し、インポーターが Web サービス記述言語 (WSDL) の部分を ServiceDescription オブジェクトの部分にマッピングする方法を制御します。

public interface class IWsdlImportExtension

public interface IWsdlImportExtension

type IWsdlImportExtension = interface

Public Interface IWsdlImportExtension

派生

System.ServiceModel.Channels.ContextBindingElementImporter

System.ServiceModel.Channels.MessageEncodingBindingElementImporter

System.ServiceModel.Channels.StandardBindingImporter

System.ServiceModel.Channels.TransportBindingElementImporter

System.ServiceModel.Channels.UdpTransportImporter

System.ServiceModel.Description.DataContractSerializerMessageContractImporter

System.ServiceModel.Description.XmlSerializerMessageContractImporter

例

次のIWsdlImportExtensionコード例は、インターフェイスとSystem.ServiceModel.Description.IOperationContractGenerationExtension操作レベルで生成された WCF クライアント コードを追加System.ServiceModel.Description.IServiceContractGenerationExtensionし、(WsdlDocumentationImporterこの場合は) 追加する方法を示しています。

  public void ImportContract(WsdlImporter importer, WsdlContractConversionContext context)
  {
Console.Write("ImportContract");
      // Contract Documentation
      if (context.WsdlPortType.Documentation != null)
      {
  context.Contract.Behaviors.Add(new WsdlDocumentationImporter(context.WsdlPortType.Documentation));
      }
      // Operation Documentation
      foreach (Operation operation in context.WsdlPortType.Operations)
      {
          if (operation.Documentation != null)
          {
              OperationDescription operationDescription = context.Contract.Operations.Find(operation.Name);
              if (operationDescription != null)
              {
      operationDescription.Behaviors.Add(new WsdlDocumentationImporter(operation.Documentation));
              }
          }
      }
  }

クライアント メタデータ システムを構成してアプリケーション構成ファイルからカスタムの IWsdlImportExtension を使用する方法を次のコード例に示します。

<system.serviceModel>
    <client>
      <endpoint 
        address="http://localhost:8000/Fibonacci" 
        binding="wsHttpBinding"
        contract="IFibonacci"
      />
      <metadata>
        <wsdlImporters>
          <extension type="Microsoft.WCF.Documentation.WsdlDocumentationImporter, WsdlDocumentation, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
        </wsdlImporters>
      </metadata>
    </client>
  </system.serviceModel>

注釈

IWsdlImportExtension インターフェイスを実装すると、特にコントラクトまたはエンドポイントの情報を変更するカスタム WSDL 拡張を読み込む場合などに、WSDL と ServiceEndpoint オブジェクトおよび ContractDescription オブジェクト間のマッピングを制御できます。 プログラム内から直接、またはアプリケーション構成ファイルを使用して、カスタムの IWsdlImportExtension オブジェクトを WsdlImporter に接続します。 また、アプリケーション構成ファイルを使用して、ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe) によって使用される内部WsdlImporterにカスタム IWsdlImportExtension オブジェクトをアタッチすることもできます。

コントラクトをインポートするには、ImportContract メソッドを呼び出します。

BeforeImport オブジェクトおよび ServiceEndpoint オブジェクトにインポートするメタデータを変更するには、ContractDescription メソッドを使用します。

メソッド

BeforeImport(ServiceDescriptionCollection, XmlSchemaSet, ICollection<XmlElement>)	メタデータ ドキュメントをインポートする前に呼び出します。
ImportContract(WsdlImporter, WsdlContractConversionContext)	コントラクトをインポートするときに呼び出します。
ImportEndpoint(WsdlImporter, WsdlEndpointConversionContext)	エンドポイントのインポート時に呼び出します。