<serviceMetadata>

Especifica a publicação de metadados de serviço e informações associadas.

<configuração>
  <system.serviceModel>
    <comportamentos>
      <serviceBehaviors>
        <comportamento>
          <serviceMetadata>

Syntax

<serviceMetadata externalMetadataLocation="String"
                 httpGetBinding="String"
                 httpGetBindingConfiguration="String"
                 httpGetEnabled="Boolean"
                 httpGetUrl="String"
                 httpsGetBinding="String"
                 httpsGetBindingConfiguration="String"
                 httpsGetEnabled="Boolean"
                 httpsGetUrl="String"
                 policyVersion="Policy12/Policy15" />

Atributos e Elementos

As secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Elementos Subordinados

Nenhuma

Elementos Principais

Observações

Este elemento de configuração permite-lhe controlar as funcionalidades de publicação de metadados de um serviço. Para impedir a divulgação não intencional de metadados de serviço potencialmente confidenciais, a configuração predefinida dos serviços do Windows Communication Foundation (WCF) desativa a publicação de metadados. Este comportamento é seguro por predefinição, mas também significa que não pode utilizar uma ferramenta de importação de metadados (como Svcutil.exe) para gerar o código de cliente necessário para chamar o serviço, a menos que o comportamento de publicação de metadados do serviço esteja explicitamente ativado na configuração. Com este elemento de configuração, pode ativar este comportamento de publicação para o seu serviço.

Para obter um exemplo detalhado de configuração deste comportamento, veja Comportamento de Publicação de Metadados.

Os atributos e httpsGetBinding opcionais httpGetBinding permitem-lhe configurar os enlaces utilizados para a obtenção de metadados através de HTTP GET (ou HTTPS GET). Se não forem especificados, os enlaces predefinidos (HttpTransportBindingElementno caso de HTTP e HttpsTransportBindingElement, no caso de HTTPS) são utilizados para obtenção de metadados conforme adequado. Tenha em atenção que não pode utilizar estes atributos com os enlaces WCF incorporados. Apenas serão suportados enlaces com elementos de enlace internos suportados IReplyChannel . Além disso, a MessageVersion propriedade do enlace tem de ser None.

Para reduzir a exposição de um serviço a utilizadores maliciosos, é possível proteger a transferência com o mecanismo SSL através de HTTP (HTTPS). Para tal, primeiro tem de vincular um certificado X.509 adequado a uma porta específica no computador que aloja o serviço. (Para obter mais informações, consulte Trabalhar com Certificados.) Em segundo lugar, adicione este elemento à configuração do serviço e defina o httpsGetEnabled atributo como true. Por fim, defina o httpsGetUrl atributo para o URL do ponto final de metadados de serviço, conforme mostrado no exemplo seguinte.

<behaviors>
  <serviceBehaviors>
    <behavior name="NewBehavior">
      <serviceMetadata httpsGetEnabled="true"
                       httpsGetUrl="https://myComputerName/myEndpoint" />
    </behavior>
  </serviceBehaviors>
</behaviors>

Exemplo

O exemplo seguinte configura um serviço para expor metadados com o <elemento serviceMetadata> . Também configura um ponto final para expor o IMetadataExchange contrato como uma implementação de um protocolo WS-MetadataExchange (MEX). O exemplo utiliza o mexHttpBinding, que é um enlace padrão de conveniência que é equivalente ao wsHttpBinding com o modo de segurança definido como None. É utilizado um endereço relativo de "mex" no ponto final, que quando resolvido em relação ao endereço base dos serviços resulta num endereço de ponto final de http://localhost/servicemodelsamples/service.svc/mex.

<configuration>
  <system.serviceModel>
    <services>
      <service name="Microsoft.ServiceModel.Samples.CalculatorService"
               behaviorConfiguration="CalculatorServiceBehavior">
        <!-- This endpoint is exposed at the base address provided by the host: http://localhost/servicemodelsamples/service.svc -->
        <endpoint address=""
                  binding="wsHttpBinding"
                  contract="Microsoft.ServiceModel.Samples.ICalculator" />
        <!-- The mex endpoint is exposed at http://localhost/servicemodelsamples/service.svc/mex
             To expose the IMetadataExchange contract, you must enable the serviceMetadata behavior as demonstrated below. -->
        <endpoint address="mex"
                  binding="mexHttpBinding"
                  contract="IMetadataExchange" />
      </service>
    </services>
    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->
    <behaviors>
      <serviceBehaviors>
        <behavior name="CalculatorServiceBehavior">
          <!-- The serviceMetadata behavior publishes metadata through the IMetadataExchange contract. When this behavior is
               present, you can expose this contract through an endpoint as shown above. Setting httpGetEnabled to true publishes
               the service's WSDL at the <baseaddress>?wsdl eg. http://localhost/servicemodelsamples/service.svc?wsdl -->
          <serviceMetadata httpGetEnabled="True" />
          <serviceDebug includeExceptionDetailInFaults="False" />
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>
</configuration>

Ver também

• ServiceMetadataPublishingElement
• ServiceMetadataBehavior
• Comportamentos de Segurança
• Comportamento de Publicação de Metadados