MetadataExporter Classe

Definição

public ref class MetadataExporter abstract

public abstract class MetadataExporter

type MetadataExporter = class

Public MustInherit Class MetadataExporter

Herança

Object

MetadataExporter

Derivado

System.ServiceModel.Description.WsdlExporter

Exemplos

O exemplo de código seguinte é um IWsdlExportExtension.ExportContract método que demonstra como a State propriedade da classe WsdlExporter é usada para anexar um custom System.Runtime.Serialization.XsdDataContractExporter que modifica a exportação de contratos de dados no endpoint.

public void ExportContract(WsdlExporter exporter, WsdlContractConversionContext context)
{

// Add a custom DCAnnotationSurrogate to write data contract comments into the XSD.
object dataContractExporter;
XsdDataContractExporter xsdDCExporter;
if (!exporter.State.TryGetValue(typeof(XsdDataContractExporter), out dataContractExporter))
{
    xsdDCExporter = new XsdDataContractExporter(exporter.GeneratedXmlSchemas);
    exporter.State.Add(typeof(XsdDataContractExporter), xsdDCExporter);
}
else
{
    xsdDCExporter = (XsdDataContractExporter)dataContractExporter;
}

if (xsdDCExporter.Options == null)
    xsdDCExporter.Options = new ExportOptions();
xsdDCExporter.Options.DataContractSurrogate = new DCAnnotationSurrogate();

Observações

A exportação de metadados é o processo de descrever os endpoints de serviço e projetá-los numa representação paralela e padronizada (tipicamente, mas não necessariamente XML) à qual as aplicações podem aceder para implementar um cliente que utiliza o serviço. Para exportar metadados de System.ServiceModel.Description.ServiceEndpoint objetos, use uma implementação da MetadataExporter classe abstrata. Uma MetadataExporter implementação gera metadados que são encapsulados em uma System.ServiceModel.Description.MetadataSet instância.

A MetadataExporter classe fornece um quadro para gerar expressões de políticas que descrevem as capacidades e requisitos de uma ligação de endpoint e as suas operações, mensagens e falhas associadas. Essas expressões de política são capturadas numa System.ServiceModel.Description.PolicyConversionContext instância. Uma MetadataExporter implementação pode então anexar essas expressões de política aos metadados que gera.

As MetadataExporter invocações em cada System.ServiceModel.Channels.BindingElement que implementa a interface System.ServiceModel.Description.IPolicyExportExtension na ligação de um ServiceEndpoint ao gerar um objeto PolicyConversionContext para a implementação MetadataExporter utilizar. Você pode exportar novos valores de política ao implementar a interface IPolicyExportExtension nas suas implementações personalizadas do tipo System.ServiceModel.Channels.BindingElement.

O tipo System.ServiceModel.Description.WsdlExporter é a implementação da classe MetadataExporter incluída com Windows Communication Foundation (WCF). O WsdlExporter tipo gera metadados WSDL com expressões de política anexadas.

Para exportar metadados WSDL personalizados ou extensões WSDL para comportamentos de endpoint, comportamentos contratuais ou elementos de ligação num endpoint de serviço, pode implementar a System.ServiceModel.Description.IWsdlExportExtension interface. O WsdlExporter tipo chama partes de um endpoint de serviço que implementam esta interface ao gerar o documento WSDL a partir desse endpoint.