WsdlImporter Clase

Definición

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

Herencia

Object

MetadataImporter

WsdlImporter

Ejemplos

El ejemplo de código siguiente muestra cómo utilizar WsdlImporter para agregar un System.Runtime.Serialization.IDataContractSurrogate personalizado, importar todos los contratos y compilar esos contratos y guardarlos en un archivo.

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

Comentarios

Utilice la claseWsdlImporter para importar metadatos, así como para convertir esa información en varias clases que representan información de contrato y de punto de conexión.

La clase base para WsdlImporter, la clase MetadataImporter, define métodos para importar de manera selectiva información de contrato y punto de conexión y propiedades que exponen cualquier error de importación y aceptan información de tipo importante para el proceso de importación y conversión. El tipo WsdlImporter utiliza a los importadores de la directiva personalizados (implementaciones IPolicyImportExtension) de su tipo primario para administrar a las instrucciones de directiva personalizadas y sus propios importadores de WSDL personalizados (implementaciones IWsdlImportExtension) para administrar los elementos WSDL personalizados. Para obtener más información, consulte Extensión del sistema de metadatos.

Al importar la directiva de los documentos WSDL, el tipo WsdlImporter probará hasta 32 combinaciones de alternativas de la directiva asociadas a los asuntos de directiva de WSDL diferentes. Si ninguna combinación se importa limpiamente, la primera combinación se utiliza para construir un enlace personalizado parcial.

Además de estos métodos y propiedades, WsdlImporter también implementa métodos que admiten la importación de información de enlace y propiedades que proporcionan acceso a cualquier documento de directiva, documentos y extensiones WSDL y documentos de esquema XML. Para obtener información sobre cómo extender WsdlImporter para admitir elementos WSDL personalizados, vea IWsdlImportExtension.

Normalmente la clase WsdlImporter se utiliza en un proceso de tres pasos.

1. Cree un objeto WsdlImporter y pase un objeto MetadataSet al constructor.

2. Llame al método Import adecuado para recuperar los resultados.

3. Compruebe la propiedad Errors para determinar si se han producido errores de importación.

Ningún valor se devuelve de las propiedades WsdlImporter hasta que se llama a uno de los métodos de importación. Los objetos personalizados System.ServiceModel.Description.IWsdlImportExtension se pueden cargar en el WsdlImporter elemento mediante programación o mediante la configuración <de cliente wsdlImporters> .

Los metadatos que se importan cuando los puntos de conexión de servicio no se pueden utilizar para crear un tiempo de ejecución o exportar los metadatos, porque los puntos de conexión importados no contienen ninguna información del tipo administrado. Para utilizar los metadatos para crear un cliente o servicio en tiempo de ejecución o generar los metadatos, debe generar y compilar primero el código de los metadatos y utilizar esta información de tipo para crear un nuevo objeto System.ServiceModel.Description.ContractDescription mediante GetContract.

Constructores

Propiedades

Métodos

Se aplica a