WsdlImporter Класс

Определение

public ref class WsdlImporter : System::ServiceModel::Description::MetadataImporter

public class WsdlImporter : System.ServiceModel.Description.MetadataImporter

type WsdlImporter = class
    inherit MetadataImporter

Public Class WsdlImporter
Inherits MetadataImporter

Наследование

Object

MetadataImporter

WsdlImporter

Примеры

В следующем примере кода показано, как добавить WsdlImporter настраиваемый System.Runtime.Serialization.IDataContractSurrogate, импортировать все контракты и скомпилировать эти контракты и сохранить их в файле.

  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();
  }

Комментарии

WsdlImporter Используйте класс для импорта метаданных, а также преобразования этой информации в различные классы, представляющие сведения о контракте и конечной точке.

Базовый класс для WsdlImporterMetadataImporter класса определяет методы, которые выборочно импортируют сведения о контрактах и конечных точках и свойствах, которые предоставляют любые ошибки импорта и принимают сведения о типе, относящиеся к процессу импорта и преобразования. Тип WsdlImporter использует настраиваемые средства импорта политик (IPolicyImportExtension реализации) из родительского типа для обработки пользовательских инструкций политики и собственных пользовательских импортов WSDL (IWsdlImportExtension реализаций) для обработки пользовательских элементов WSDL. Дополнительные сведения см. в разделе "Расширение системы метаданных".

При импорте политики из документов WsdlImporter WSDL тип будет пытаться использовать до 32 сочетаний альтернативных политик, присоединенных к разным субъектам политики WSDL. Если ни одно сочетание не импортируется без ошибок, первая комбинация используется для создания частичной пользовательской привязки.

Помимо этих методов и свойств, WsdlImporter также реализует методы, поддерживающие импорт сведений о привязке и свойствах, которые обеспечивают доступ к любым документам политики, документам WSDL, расширениям WSDL и документам схемы XML. Сведения о расширении для поддержки WsdlImporter пользовательских элементов WSDL см. в разделе IWsdlImportExtension.

Обычно WsdlImporter класс используется в трехэтапном процессе.

1. WsdlImporter Создайте объект и передайте MetadataSet объект конструктору.

2. Вызовите соответствующий Import метод, чтобы получить результаты.

3. Errors Проверьте свойство, чтобы определить наличие ошибок импорта.

Никакие значения не возвращаются из WsdlImporter свойств до вызова одного из методов импорта. Пользовательские System.ServiceModel.Description.IWsdlImportExtension объекты можно загрузить в WsdlImporter программно или с помощью элемента wsdlImporters> конфигурации< клиента.

Метаданные, импортированные в качестве конечных точек службы, нельзя использовать для создания среды выполнения или экспорта метаданных, так как импортированные конечные точки не содержат сведений об управляемом типе. Чтобы использовать метаданные для создания клиентской среды выполнения или среды выполнения службы или создания метаданных, сначала необходимо создать и скомпилировать код из метаданных и использовать эти данные типа для создания нового System.ServiceModel.Description.ContractDescription объекта с помощью GetContract.