<serviceMetadata>

Especifica la publicación de metadatos del servicio y la información asociada.

<configuración>
   <system.serviceModel>
     <Comportamientos>
       <serviceBehaviors>
         <comportamiento>
           <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 y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Attributes

Elementos secundarios

Ninguno

Elementos primarios

Observaciones

Este elemento de configuración permite controlar las características de publicación de metadatos de un servicio. Para evitar la divulgación involuntaria de metadatos de servicio potencialmente confidenciales, la configuración predeterminada para los servicios de Windows Communication Foundation (WCF) deshabilita la publicación de metadatos. Este comportamiento es seguro de forma predeterminada, pero también significa que no puede usar una herramienta de importación de metadatos (como Svcutil.exe) para generar el código de cliente necesario para llamar al servicio a menos que el comportamiento de publicación de metadatos del servicio esté habilitado explícitamente en la configuración. Con este elemento de configuración, puede habilitar este comportamiento de publicación para el servicio.

Para obtener un ejemplo detallado de cómo configurar este comportamiento, consulte Comportamiento de publicación de metadatos.

Los atributos y httpGetBinding opcionales httpsGetBinding permiten configurar los enlaces usados para la recuperación de metadatos a través de HTTP GET (o HTTPS GET). Si no se especifican, los enlaces predeterminados (HttpTransportBindingElementen el caso de HTTP y HttpsTransportBindingElement, en el caso de HTTPS) se usan para la recuperación de metadatos según corresponda. Tenga en cuenta que no puede usar estos atributos con los enlaces WCF integrados. Solo se admitirán enlaces con elementos de enlace internos que admitan IReplyChannel . Además, la MessageVersion propiedad del enlace debe ser None.

Para reducir la exposición de un servicio a los usuarios malintencionados, es posible proteger la transferencia mediante el mecanismo SSL sobre HTTP (HTTPS). Para realizar esto, debe enlazar primero un certificado X.509 adecuado a un puerto concreto en el equipo que esté hospedando el servicio. (Para obtener más información, vea Trabajar con certificados). En segundo lugar, agregue este elemento a la configuración del servicio y establezca el httpsGetEnabled atributo en true. Finalmente, establezca el atributo httpsGetUrl en la dirección URL del punto de conexión de metadatos del servicio, tal y como se muestra en el ejemplo siguiente.

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

Example

En el ejemplo siguiente se configura un servicio para exponer metadatos mediante el <elemento serviceMetadata> . También configura un punto de conexión para exponer el IMetadataExchange contrato como una implementación de un protocolo WS-MetadataExchange (MEX). En el mexHttpBindingejemplo se usa , que es un enlace estándar de conveniencia equivalente al wsHttpBinding con el modo de seguridad establecido Noneen . Una dirección relativa de "mex" se usa en el punto de conexión, que cuando se resuelve en la dirección base de servicios da como resultado una dirección de punto de conexión 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>

Consulte también

• ServiceMetadataPublishingElement
• ServiceMetadataBehavior
• Comportamientos de seguridad
• Comportamiento de publicación de metadatos