WsdlImporter Klas

Definitie

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

Overname

Object

MetadataImporter

WsdlImporter

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de WsdlImporter opdracht gebruikt om een aangepast bestand System.Runtime.Serialization.IDataContractSurrogatetoe te voegen, alle contracten te importeren en deze contracten samen te stellen en op te slaan in een bestand.

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

Opmerkingen

Gebruik de WsdlImporter klasse om metagegevens te importeren en deze informatie te converteren naar verschillende klassen die contract- en eindpuntgegevens vertegenwoordigen.

De basisklasse voor WsdlImporter, de MetadataImporter klasse, definieert methoden die selectief contract- en eindpuntinformatie en -eigenschappen importeren die eventuele importfouten blootstellen en typegegevens accepteren die relevant zijn voor het import- en conversieproces. Het WsdlImporter type gebruikt de aangepaste beleidsimporteurs (IPolicyImportExtension implementaties) van het bovenliggende type om aangepaste beleidsinstructies en eigen aangepaste WSDL-importeurs (IWsdlImportExtension implementaties) af te handelen om aangepaste WSDL-elementen te verwerken. Zie Het metagegevenssysteem uitbreiden voor meer informatie.

Bij het importeren van beleid uit WSDL-documenten probeert het WsdlImporter type maximaal 32 combinaties van beleidsalternatieven die zijn gekoppeld aan de verschillende WSDL-beleidsonderwerpsen. Als er geen combinatie probleemloos wordt geïmporteerd, wordt de eerste combinatie gebruikt om een gedeeltelijke eigen binding te maken.

Naast deze methoden en eigenschappen WsdlImporter worden ook methoden geïmplementeerd die ondersteuning bieden voor het importeren van bindingsinformatie en eigenschappen die toegang bieden tot beleidsdocumenten, WSDL-documenten, WSDL-extensies en XML-schemadocumenten. Zie voor meer informatie over uitbreiding WsdlImporter ter ondersteuning van aangepaste WSDL-elementen IWsdlImportExtension.

Normaal gesproken wordt de WsdlImporter klasse gebruikt in een proces met drie stappen.

1. Maak een WsdlImporter object en geef een MetadataSet object door aan de constructor.

2. Roep de juiste Import methode aan om de resultaten op te halen.

3. Controleer de Errors eigenschap om te bepalen of er importfouten zijn.

Er worden geen waarden geretourneerd uit de WsdlImporter eigenschappen totdat een van de importmethoden wordt aangeroepen. Aangepaste System.ServiceModel.Description.IWsdlImportExtension objecten kunnen programmatisch in het WsdlImporter programma worden geladen of met behulp van het clientconfiguratieelement< wsdlImporters>.

Metagegevens die als service-eindpunten zijn geïmporteerd, kunnen niet worden gebruikt om een runtime te maken of metagegevens te exporteren omdat de geïmporteerde eindpunten geen beheerde typegegevens bevatten. Als u de metagegevens wilt gebruiken om een client- of serviceruntime te maken of metagegevens te genereren, moet u eerst code genereren en compileren op basis van de metagegevens en dat typegegevens gebruiken om een nieuw System.ServiceModel.Description.ContractDescription object te maken met behulp van GetContract.