WsdlImporter Classe

Definizione

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

Ereditarietà

Object

MetadataImporter

WsdlImporter

Esempio

Nell'esempio di codice seguente viene illustrato come usare WsdlImporter per aggiungere un oggetto personalizzato System.Runtime.Serialization.IDataContractSurrogate, importare tutti i contratti e compilarli e salvarli in un file.

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

Commenti

Usare la WsdlImporter classe per importare metadati e convertire tali informazioni in varie classi che rappresentano informazioni sul contratto e sull'endpoint.

La classe base per WsdlImporter, la MetadataImporter classe , definisce metodi che importano in modo selettivo le informazioni e le proprietà del contratto e dell'endpoint che espongono eventuali errori di importazione e accettano informazioni sul tipo rilevanti per il processo di importazione e conversione. Il WsdlImporter tipo usa gli utilità di importazione di criteri personalizzati (IPolicyImportExtension implementazioni) dal tipo padre per gestire istruzioni di criteri personalizzate e le proprie utilità di importazione WSDL personalizzate (IWsdlImportExtension implementazioni) per gestire gli elementi WSDL personalizzati. Per informazioni dettagliate, vedere Estensione del sistema di metadati.

Quando si importano criteri da documenti WSDL, il WsdlImporter tipo tenterà fino a 32 combinazioni di alternative di criteri associate ai diversi soggetti dei criteri WSDL. Se nessuna combinazione viene importata senza errori, la prima combinazione viene usata per costruire un binding personalizzato parziale.

Oltre a questi metodi e proprietà, WsdlImporter implementa anche metodi che supportano l'importazione di informazioni e proprietà di associazione che forniscono l'accesso a qualsiasi documento di criteri, documenti WSDL, estensioni WSDL e documenti XML Schema. Per informazioni sull'estensione WsdlImporter per supportare elementi WSDL personalizzati, vedere IWsdlImportExtension.

In genere la WsdlImporter classe viene usata in un processo in tre passaggi.

1. Creare un WsdlImporter oggetto e passare un MetadataSet oggetto al costruttore.

2. Chiamare il metodo appropriato Import per recuperare i risultati.

3. Controllare la Errors proprietà per determinare se sono presenti errori di importazione.

Non vengono restituiti valori dalle WsdlImporter proprietà finché non viene chiamato uno dei metodi di importazione. Gli oggetti personalizzati System.ServiceModel.Description.IWsdlImportExtension possono essere caricati nell'oggetto a WsdlImporter livello di codice o usando l'elemento wsdlImporters> di configurazione< client.

I metadati importati come endpoint di servizio non possono essere usati per creare un runtime o esportare metadati perché gli endpoint importati non contengono informazioni sul tipo gestito. Per usare i metadati per creare un runtime client o di servizio o per generare metadati, è necessario innanzitutto generare e compilare codice dai metadati e usare tali informazioni sul tipo per creare un nuovo System.ServiceModel.Description.ContractDescription oggetto usando GetContract.