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 utilizzare l'oggetto WsdlImporter per aggiungere un'interfaccia System.Runtime.Serialization.IDataContractSurrogate personalizzata, importare tutti i contratti, 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

Utilizzare la classe WsdlImporter per importare metadati e per convertire tali informazioni in varie classi che rappresentano informazioni di contratto e di endpoint.

La classe base per WsdlImporter, ovvero MetadataImporter, definisce metodi che importano selettivamente informazioni di contratto e di endpoint e proprietà che espongono eventuali errore di importazione e accettano informazioni sul tipo relative al processo di importazione e di conversione. Il tipo WsdlImporter utilizza le unità di importazione di criteri personalizzate (implementazioni di IPolicyImportExtension) provenienti dal tipo padre per gestire istruzioni di criteri personalizzate e proprie unità di importazione WSDL personalizzate (implementazioni di IWsdlImportExtension) per gestire elementi WSDL personalizzati. Per informazioni dettagliate, vedere Estensione del sistema dei metadati.

Durante l'importazione di criteri da documenti WSDL, il tipo WsdlImporter tenta fino a 32 combinazioni di alternative di criteri collegate ai diversi soggetti di criteri WSDL. Se nessuna combinazione viene importata correttamente, viene utilizzata la prima combinazione per costruire un'associazione personalizzata parziale.

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

In genere, la classe WsdlImporter viene utilizzata in un processo composto da tre passaggi.

1. Creazione di un oggetto WsdlImporter e passaggio di un oggetto MetadataSet al costruttore.

2. Chiamata al metodo Import appropriato per recuperare i risultati.

3. Controllo della proprietà Errors per accertare l'eventuale presenza di errori di importazione.

Non viene restituito alcun valore dalla proprietà WsdlImporter prima della chiamata a uno dei metodi di importazione. Gli oggetti personalizzati System.ServiceModel.Description.IWsdlImportExtension possono essere caricati a livello di codice o usando l'elemento WsdlImporter wsdlImporters> di configurazione< client.

I metadati importati come endpoint del servizio non possono essere utilizzati per creare metadati di runtime o di esportazione perché gli endpoint importati non contengono informazioni sui tipi gestiti. Per utilizzare i metadati per creare un runtime del client o del servizio o per generare metadati, è necessario innanzitutto generare e compilare codice dai metadati e utilizzare tali informazioni sui tipi per creare un nuovo oggetto System.ServiceModel.Description.ContractDescription utilizzando GetContract.

Costruttori

Proprietà

Metodi

Si applica a