WsdlImporter 建構函式

定義

命名空間:

System.ServiceModel.Description

組件:

System.ServiceModel.dll

初始化 WsdlImporter 類別的新執行個體。

多載

WsdlImporter(MetadataSet)	初始化 WsdlImporter 類別的新執行個體。
WsdlImporter(MetadataSet, IEnumerable<IPolicyImportExtension>, IEnumerable<IWsdlImportExtension>)	從指定的中繼資料、自訂原則匯入工具和自訂 WSDL 匯入工具建立 WsdlImporter 物件。
WsdlImporter(MetadataSet, IEnumerable<IPolicyImportExtension>, IEnumerable<IWsdlImportExtension>, MetadataImporterQuotas)	從指定的中繼資料、自訂原則匯入工具和自訂 WSDL 匯入工具建立 WsdlImporter 物件。

WsdlImporter(MetadataSet)

初始化 WsdlImporter 類別的新執行個體。

public:
 WsdlImporter(System::ServiceModel::Description::MetadataSet ^ metadata);

public WsdlImporter (System.ServiceModel.Description.MetadataSet metadata);

new System.ServiceModel.Description.WsdlImporter : System.ServiceModel.Description.MetadataSet -> System.ServiceModel.Description.WsdlImporter

Public Sub New (metadata As MetadataSet)

參數

metadata

MetadataSet

要從其中擷取合約、端點和繫結資訊的中繼資料文件集合。

範例

下列程式碼範例會示範最常見的搭配 WsdlImporter 類別使用 MetadataResolver 類別的方式。

MetadataExchangeClient mexClient = new MetadataExchangeClient(metadataAddress);
mexClient.ResolveMetadataReferences = true;
MetadataSet metaDocs = mexClient.GetMetadata();

      WsdlImporter importer = new WsdlImporter(metaDocs);
ServiceContractGenerator generator = new ServiceContractGenerator();

備註

使用 WsdlImporter 建構函式，即可從一組中繼資料文件建立 WsdlImporter 物件。

WsdlImporter(MetadataSet, IEnumerable<IPolicyImportExtension>, IEnumerable<IWsdlImportExtension>)

從指定的中繼資料、自訂原則匯入工具和自訂 WSDL 匯入工具建立 WsdlImporter 物件。

public:
 WsdlImporter(System::ServiceModel::Description::MetadataSet ^ metadata, System::Collections::Generic::IEnumerable<System::ServiceModel::Description::IPolicyImportExtension ^> ^ policyImportExtensions, System::Collections::Generic::IEnumerable<System::ServiceModel::Description::IWsdlImportExtension ^> ^ wsdlImportExtensions);

public WsdlImporter (System.ServiceModel.Description.MetadataSet metadata, System.Collections.Generic.IEnumerable<System.ServiceModel.Description.IPolicyImportExtension> policyImportExtensions, System.Collections.Generic.IEnumerable<System.ServiceModel.Description.IWsdlImportExtension> wsdlImportExtensions);

new System.ServiceModel.Description.WsdlImporter : System.ServiceModel.Description.MetadataSet * seq<System.ServiceModel.Description.IPolicyImportExtension> * seq<System.ServiceModel.Description.IWsdlImportExtension> -> System.ServiceModel.Description.WsdlImporter

Public Sub New (metadata As MetadataSet, policyImportExtensions As IEnumerable(Of IPolicyImportExtension), wsdlImportExtensions As IEnumerable(Of IWsdlImportExtension))

參數

metadata

MetadataSet

下載的中繼資料。

policyImportExtensions

IEnumerable<IPolicyImportExtension>

用於匯入自訂原則陳述式的自訂原則匯入工具。

wsdlImportExtensions

IEnumerable<IWsdlImportExtension>

用於匯入自訂 WSDL 項目的自訂 WSDL 匯入工具。

例外狀況

ArgumentNullException

metadata 引數為 null。

範例

下列程式碼範例會示範如何在使用 WSDLDocumentationImporter 物件之前，先將新的自訂 WSDL 匯入工具 (WsdlImporter) 新增至預設的匯入工具組。

// The following code inserts a custom WsdlImporter without removing the other
// importers already in the collection.
System.Collections.Generic.IEnumerable<IWsdlImportExtension> exts = importer.WsdlImportExtensions;
System.Collections.Generic.List<IWsdlImportExtension> newExts
  = new System.Collections.Generic.List<IWsdlImportExtension>();
foreach (IWsdlImportExtension ext in exts)
{
  Console.WriteLine("Default WSDL import extensions: {0}", ext.GetType().Name);
  newExts.Add(ext);
}
newExts.Add(new WsdlDocumentationImporter());
System.Collections.Generic.IEnumerable<IPolicyImportExtension> polExts = importer.PolicyImportExtensions;
importer = new WsdlImporter(metaDocs, polExts, newExts);

備註

使用這個建構函式，即可控制要匯入的中繼資料，以及控制要使用的原則和 WSDL 匯入工具。

注意

當自訂原則匯入工具或自訂 WSDL 匯入工具傳遞至這個建構函式時，便不會載入在應用程式組態檔中所指定的任何自訂匯入工具。 如果要新增自訂匯入工具，您必須在使用這個建構函式之前先重新建構匯入工具集合。 請參閱＜範例＞一節。

WsdlImporter(MetadataSet, IEnumerable<IPolicyImportExtension>, IEnumerable<IWsdlImportExtension>, MetadataImporterQuotas)

從指定的中繼資料、自訂原則匯入工具和自訂 WSDL 匯入工具建立 WsdlImporter 物件。

public:
 WsdlImporter(System::ServiceModel::Description::MetadataSet ^ metadata, System::Collections::Generic::IEnumerable<System::ServiceModel::Description::IPolicyImportExtension ^> ^ policyImportExtensions, System::Collections::Generic::IEnumerable<System::ServiceModel::Description::IWsdlImportExtension ^> ^ wsdlImportExtensions, System::ServiceModel::Description::MetadataImporterQuotas ^ quotas);

public WsdlImporter (System.ServiceModel.Description.MetadataSet metadata, System.Collections.Generic.IEnumerable<System.ServiceModel.Description.IPolicyImportExtension> policyImportExtensions, System.Collections.Generic.IEnumerable<System.ServiceModel.Description.IWsdlImportExtension> wsdlImportExtensions, System.ServiceModel.Description.MetadataImporterQuotas quotas);

new System.ServiceModel.Description.WsdlImporter : System.ServiceModel.Description.MetadataSet * seq<System.ServiceModel.Description.IPolicyImportExtension> * seq<System.ServiceModel.Description.IWsdlImportExtension> * System.ServiceModel.Description.MetadataImporterQuotas -> System.ServiceModel.Description.WsdlImporter

Public Sub New (metadata As MetadataSet, policyImportExtensions As IEnumerable(Of IPolicyImportExtension), wsdlImportExtensions As IEnumerable(Of IWsdlImportExtension), quotas As MetadataImporterQuotas)

參數

metadata

MetadataSet

下載的中繼資料。

policyImportExtensions

IEnumerable<IPolicyImportExtension>

用於匯入自訂原則陳述式的自訂原則匯入工具。

wsdlImportExtensions

IEnumerable<IWsdlImportExtension>

用於匯入自訂 WSDL 項目的自訂 WSDL 匯入工具。

quotas

MetadataImporterQuotas

一次擷取的中繼資料數量。

例外狀況

ArgumentNullException

metadata 引數為 null。

範例

下列程式碼範例會示範如何在使用 WSDLDocumentationImporter 物件之前，先將新的自訂 WSDL 匯入工具 (WsdlImporter) 新增至預設的匯入工具組。

// The following code inserts a custom WsdlImporter without removing the other
// importers already in the collection.
System.Collections.Generic.IEnumerable<IWsdlImportExtension> exts = importer.WsdlImportExtensions;
System.Collections.Generic.List<IWsdlImportExtension> newExts
  = new System.Collections.Generic.List<IWsdlImportExtension>();
foreach (IWsdlImportExtension ext in exts)
{
  Console.WriteLine("Default WSDL import extensions: {0}", ext.GetType().Name);
  newExts.Add(ext);
}
newExts.Add(new WsdlDocumentationImporter());
System.Collections.Generic.IEnumerable<IPolicyImportExtension> polExts = importer.PolicyImportExtensions;
importer = new WsdlImporter(metaDocs, polExts, newExts);

備註

使用這個建構函式，即可控制要匯入的中繼資料，以及控制要使用的原則和 WSDL 匯入工具。

注意

當自訂原則匯入工具或自訂 WSDL 匯入工具傳遞至這個建構函式時，便不會載入在應用程式組態檔中所指定的任何自訂匯入工具。 如果要新增自訂匯入工具，您必須在使用這個建構函式之前先重新建構匯入工具集合。 請參閱＜範例＞一節。