MetadataImporter 類別

定義

public ref class MetadataImporter abstract

public abstract class MetadataImporter

type MetadataImporter = class

Public MustInherit Class MetadataImporter

繼承

Object

MetadataImporter

衍生

System.ServiceModel.Description.WsdlImporter

範例

下列範例會顯示使用 System.ServiceModel.Description.WsdlImporter 衍生類別 (Derived Class) 匯入中繼資料的用法，方法為使用自訂狀態、檢查 Errors 屬性、將匯入的中繼資料編譯為 Managed 型別，然後將結果儲存至程式碼檔案。

  static void GenerateCSCodeForService(EndpointAddress metadataAddress, string outputFile)
  {
MetadataExchangeClient mexClient = new MetadataExchangeClient(metadataAddress);
mexClient.ResolveMetadataReferences = true;
MetadataSet metaDocs = mexClient.GetMetadata();

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

// Add our custom DCAnnotationSurrogate
// to write XSD annotations into the comments.
object dataContractImporter;
XsdDataContractImporter xsdDCImporter;
if (!importer.State.TryGetValue(typeof(XsdDataContractImporter), out dataContractImporter))
{
  Console.WriteLine("Couldn't find the XsdDataContractImporter! Adding custom importer.");
  xsdDCImporter = new XsdDataContractImporter();
  xsdDCImporter.Options = new ImportOptions();
  importer.State.Add(typeof(XsdDataContractImporter), xsdDCImporter);
}
else
{
  xsdDCImporter = (XsdDataContractImporter)dataContractImporter;
  if (xsdDCImporter.Options == null)
  {
    Console.WriteLine("There were no ImportOptions on the importer.");
    xsdDCImporter.Options = new ImportOptions();
  }
}
xsdDCImporter.Options.DataContractSurrogate = new DCAnnotationSurrogate();

// Uncomment the following code if you are going to do your work programmatically rather than add
// the WsdlDocumentationImporters through a configuration file.
/*
// 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);
*/

System.Collections.ObjectModel.Collection<ContractDescription> contracts
  = importer.ImportAllContracts();
importer.ImportAllEndpoints();
      foreach (ContractDescription contract in contracts)
      {
          generator.GenerateServiceContractType(contract);
      }
if (generator.Errors.Count != 0)
  throw new Exception("There were errors during code compilation.");

// Write the code dom
System.CodeDom.Compiler.CodeGeneratorOptions options
  = new System.CodeDom.Compiler.CodeGeneratorOptions();
      options.BracingStyle = "C";
      System.CodeDom.Compiler.CodeDomProvider codeDomProvider
  = System.CodeDom.Compiler.CodeDomProvider.CreateProvider("C#");
      System.CodeDom.Compiler.IndentedTextWriter textWriter
  = new System.CodeDom.Compiler.IndentedTextWriter(new System.IO.StreamWriter(outputFile));
      codeDomProvider.GenerateCodeFromCompileUnit(
  generator.TargetCompileUnit, textWriter, options
);
      textWriter.Close();
  }

備註

您可以使用 MetadataImporter 抽象類別 (Abstract Class) 的實作匯入服務中繼資料。 衍生自 類別的類型 MetadataImporter 會實作匯入元資料格式的支援，這些格式利用 Windows Communication Foundation (WCF) 中的WS-Policy匯入邏輯。

MetadataImporter 實作會收集附加至 System.ServiceModel.Description.PolicyConversionContext 物件內服務中繼資料的原則運算式。 MetadataImporter 接著會呼叫 System.ServiceModel.Description.IPolicyImportExtension 屬性中的 MetadataImporter.PolicyImportExtensions 介面實作，將原則當成匯入中繼資料作業的一部分來處理。

您可以將自己的 MetadataImporter 介面實作新增至 System.ServiceModel.Description.IPolicyImportExtension 執行個體上的 MetadataImporter.PolicyImportExtensions 屬性，以便在將新原則判斷提示匯入 MetadataImporter 時提供更多支援。 或者，您可以在應用程式組態檔中註冊自己的原則匯入延伸。

類型 System.ServiceModel.Description.WsdlImporter 是 WCF 隨附之 MetadataImporter 抽象類別的實作。 System.ServiceModel.Description.WsdlImporter 型別會匯入具有與 System.ServiceModel.Description.MetadataSet 物件組合在一起之附加原則的 WSDL 中繼資料。

您可以實作 System.ServiceModel.Description.IWsdlImportExtension 介面，然後將實作新增至 WsdlImporter.WsdlImportExtensions 執行個體上的 System.ServiceModel.Description.WsdlImporter 屬性中，以便在匯入 WSDL 延伸時提供更多支援。 System.ServiceModel.Description.WsdlImporter 也可以將 System.ServiceModel.Description.IWsdlImportExtension 介面 (在您的應用程式組態檔中註冊) 的實作載入。

屬性

方法

適用於