<serviceMetadata>

指定服务元数据及相关信息的发布。

架构层次结构

<system.serviceModel>
  <behaviors>
    <serviceBehaviors>
      <serviceBehaviors> 的 <behavior>
        <serviceMetadata>

语法

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

属性和元素

以下几节描述了特性、子元素和父元素。

属性

特性	说明
externalMetadataLocation	一个包含 WSDL 文件的位置的 URI，该文件将返回到用户以响应 WSDL 和 MEX 请求而非自动生成的 WSDL。当未设置此特性时，将返回默认的 WSDL。默认值为一个空字符串。
httpGetBinding	一个字符串，指定将用于通过 HTTP GET 进行元数据检索的绑定类型。此设置是可选的。如果未指定此设置，则将使用默认绑定。 仅支持具有支持 T:System.ServiceModel.Channels.IReplyChannel 的内部绑定元素的绑定。此外，绑定的 P:System.ServiceModel.Channels.MessageVersion 属性必须为 P:System.ServiceModel.Channels.MessageVersion.None。
httpGetBindingConfiguration	一个字符串，用于设置在 httpGetBinding 特性中指定的绑定的名称，此名称引用此绑定的其他配置信息。必须在 <bindings> 节中定义相同的名称。
httpGetEnabled	一个布尔值，指定是否发布服务元数据以便使用 HTTP/Get 请求进行检索。默认值为 false。 如果未指定 httpGetUrl 属性，则发布元数据的地址为服务地址加上“?wsdl”。例如，如果服务地址为“https://localhost:8080/CalculatorService”，则 HTTP/Get 元数据地址为“https://localhost:8080/CalculatorService?wsdl”。 如果此属性为 false，或者服务的地址不基于 HTTP 或 HTTPS，则忽略“?wsdl”。
httpGetUrl	一个 URI，指定发布元数据的地址以便使用 HTTP/Get 请求进行检索。
httpsGetBinding	一个字符串，指定将用于通过 HTTPS GET 进行元数据检索的绑定类型。此设置是可选的。如果未指定此设置，则将使用默认绑定。 仅支持具有支持 T:System.ServiceModel.Channels.IReplyChannel 的内部绑定元素的绑定。此外，绑定的 P:System.ServiceModel.Channels.MessageVersion 属性必须为 P:System.ServiceModel.Channels.MessageVersion.None。
httpsGetBindingConfiguration	一个字符串，用于设置在 httpsGetBinding 特性中指定的绑定的名称，此名称引用此绑定的其他配置信息。必须在 <bindings> 节中定义相同的名称。
httpsGetEnabled	一个布尔值，指定是否发布服务元数据以便使用 HTTPS/Get 请求进行检索。默认值为 false。 如果未指定 httpsGetUrl 属性，则发布元数据的地址为服务地址加上“?wsdl”。例如，如果服务地址为“https://localhost:8080/CalculatorService”，则 HTTP/Get 元数据地址为“https://localhost:8080/CalculatorService?wsdl”。 如果此属性为 false，或者服务的地址不基于 HTTP 或 HTTPS，则忽略“?wsdl”。
httpsGetUrl	一个 URI，指定发布元数据的地址以便使用 HTTPS/Get 请求进行检索。
policyVersion	一个字符串，指定所使用的 WS-Policy 规范的版本。此属性的类型为 PolicyVersion。

子元素

无

父元素

元素	说明
<endpointBehaviors> 的 <behavior>	指定行为元素。

备注

此配置元素允许您控制服务的元数据发布功能。为了防止无意中泄露潜在的敏感服务元数据，Windows Communication Foundation (WCF) 服务的默认配置将禁用元数据发布。默认情况下此行为是安全的，但也意味着您无法使用元数据导入工具（例如 Svcutil.exe）生成调用服务所需的客户端代码，除非在配置中显式启用服务的元数据发布行为。使用此配置元素，可以为服务启用此发布行为。

有关配置此行为的详细代码示例，请参见Metadata Publishing Behavior。

利用可选的 httpGetBinding 和 httpsGetBinding 属性，您可以配置用于通过 HTTP GET（或 HTTPS GET）检索元数据的绑定。如果未指定这两个属性，则根据情况使用相应的默认绑定（采用 HTTP 时为 HttpTransportBindingElement，采用 HTTPS 时为 HttpsTransportBindingElement）进行元数据检索。请注意：不能将这些属性用于内置 WCF 绑定。仅支持具有支持 IReplyChannel 的内部绑定元素的绑定。此外，绑定的 MessageVersion 属性必须为 None。

为了降低服务被恶意使用者滥用的可能性，可以使用 SSL over HTTP (HTTPS) 机制来确保传输的安全。为此，必须首先将一个适合的 X.509 证书绑定到承载该服务的计算机上的特定端口。(有关更多信息，请参见 Working with Certificates.)然后，将此元素添加到服务配置，并将 httpsGetEnabled 特性设置为 true。最后，将 httpsGetUrl 属性设置为服务元数据终结点的 URL，如下面的示例所示。

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

示例

下面的示例配置服务以便使用 <serviceMetadata> 元素公开元数据。它还配置终结点以便将 IMetadataExchange 协定作为 WS-MetadataExchange (MEX) 协议的实现公开。此示例使用的是 mexHttpBinding，这是一种便于使用的标准绑定，与安全模式设置为 None 的 wsHttpBinding 等效。在终结点中使用相对地址“mex”，当针对服务基址对其进行解析时将得到终结点地址 https://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: https://localhost/servicemodelsamples/service.svc  -->
      <endpoint address=""
                binding="wsHttpBinding"
                contract="Microsoft.ServiceModel.Samples.ICalculator" />
      <!-- the mex endpoint is exposed at https://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. https://localhost/servicemodelsamples/service.svc?wsdl -->
        <serviceMetadata httpGetEnabled="True"/>
        <serviceDebug includeExceptionDetailInFaults="False" />
      </behavior>
    </serviceBehaviors>
  </behaviors>

</system.serviceModel>

</configuration>

另请参见

参考

ServiceMetadataPublishingElement
ServiceMetadataBehavior

其他资源

Security Behaviors in WCF
Metadata Publishing Behavior