WsdlImporter Classe

Definição

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

Herança

Object

MetadataImporter

WsdlImporter

Exemplos

O exemplo de código seguinte mostra como usar o WsdlImporter para adicionar um personalizado System.Runtime.Serialization.IDataContractSurrogate, importar todos os contratos, compilar esses contratos e guardá-los num ficheiro.

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

Observações

Use a WsdlImporter classe para importar metadados, bem como converter essa informação em várias classes que representem informações de contratos e endpoints.

A classe base para WsdlImporter, a MetadataImporter classe, define métodos que importam seletivamente informações e propriedades de contratos e endpoints que expõem quaisquer erros de importação e aceitam informações de tipo relevantes para o processo de importação e conversão. O WsdlImporter tipo utiliza os importadores de políticas personalizadas (IPolicyImportExtension implementações) do seu tipo-pai para tratar declarações de política personalizadas e os seus próprios importadores WSDL personalizados (IWsdlImportExtension implementações) para tratar dos elementos WSDL personalizados. Para mais detalhes, veja Extensão do Sistema de Metadados.

Ao importar política a partir de documentos WSDL, o WsdlImporter tipo tentará até 32 combinações de alternativas de política associadas aos diferentes temas da política WSDL. Se nenhuma combinação importar de forma limpa, a primeira combinação será usada para construir uma ligação personalizada parcial.

Para além destes métodos e propriedades, WsdlImporter implementa também métodos que suportam a importação de informação de ligação e propriedades que dão acesso a quaisquer documentos de política, documentos WSDL, extensões WSDL e documentos de esquema XML. Para informações sobre como estender WsdlImporter para suportar elementos WSDL personalizados, veja IWsdlImportExtension.

Normalmente, a WsdlImporter classe é utilizada num processo de três etapas.

1. Crie um WsdlImporter objeto e passe um MetadataSet objeto ao construtor.

2. Chame o método adequado Import para obter os resultados.

3. Verifique a Errors propriedade para ver se há erros de importação.

Nenhum valor é devolvido das WsdlImporter propriedades até que um dos métodos de importação seja chamado. Os objetos personalizados System.ServiceModel.Description.IWsdlImportExtension podem ser carregados WsdlImporter programaticamente ou usando o elemento de configuração <do cliente wsdlImporters> .

Metadados importados como endpoints de serviço não podem ser usados para criar um runtime ou exportar metadados porque os endpoints importados não contêm informação de tipo gerido. Para usar os metadados para criar um cliente ou runtime de serviço ou para gerar metadados, deve primeiro gerar e compilar código a partir dos metadados e usar essa informação de tipo para criar um novo System.ServiceModel.Description.ContractDescription objeto usando GetContract.