如何：使用配置文件发布服务的元数据
这是演示为 Windows Communication Foundation (WCF) 服务发布元数据的两个操作方法主题之一。 有两种方式可以指定服务应如何发布元数据：使用配置文件和使用代码。 本主题演示如何使用配置文件发布服务的元数据。
注意
本主题演示如何以不安全的方式发布元数据。 任何客户端都可以检索服务的元数据。 如果需要服务以安全方式发布元数据，请参阅自定义安全元数据终结点。
有关在代码中发布元数据的更多信息，请参阅如何：使用代码发布服务的元数据。 通过发布元数据，客户端可以使用 WS-Transfer GET 请求或使用 ?wsdl 查询字符串的 HTTP/GET 来检索元数据。 若要确保代码能够工作，需创建一个基本 WCF 服务。 为了简单起见，将在以下代码中提供一个基本的自承载服务。
using System;
using System.Runtime.Serialization;
using System.ServiceModel;
using System.ServiceModel.Description;
namespace Metadata.Samples
{
[ServiceContract]
public interface ISimpleService
{
[OperationContract]
string SimpleMethod(string msg);
}
class SimpleService : ISimpleService
{
public string SimpleMethod(string msg)
{
Console.WriteLine("The caller passed in " + msg);
return "Hello " + msg;
}
}
class Program
{
static void Main(string[] args)
{
ServiceHost host = new ServiceHost(typeof(SimpleService),
new Uri("http://localhost:8001/MetadataSample"));
try
{
// Open the service host to accept incoming calls
host.Open();
// The service can now be accessed.
Console.WriteLine("The service is ready.");
Console.WriteLine("Press <ENTER> to terminate service.");
Console.WriteLine();
Console.ReadLine();
// Close the ServiceHostBase to shutdown the service.
host.Close();
}
catch (CommunicationException commProblem)
{
Console.WriteLine("There was a communication problem. " + commProblem.Message);
Console.Read();
}
}
}
}
此服务为自承载服务，并且是使用配置文件配置的。 下面的配置文件作为开始点。
<configuration>
<system.serviceModel>
<services>
<service name="Metadata.Example.SimpleService">
<endpoint address=""
binding="basicHttpBinding"
contract="Metadata.Example.ISimpleService" />
</service>
</services>
<behaviors>
</behaviors>
</system.serviceModel>
</configuration>
使用应用程序配置文件发布 WCF 服务的元数据
在 App.config 文件内，在结束
</services>元素。在
<behaviors>元素中添加<serviceBehaviors>元素。向
<behavior><serviceBehaviors>元素中添加一个name元素，并为 元素的<behavior>属性指定一个值。向
<serviceMetadata>元素中添加一个<behavior>元素。 将httpGetEnabled属性设置为true，并将policyVersion属性设置为 Policy15。httpGetEnabled可让服务响应 HTTP GET 请求发出的元数据请求。policyVersion通知服务在生成元数据时应符合 WS-Policy 1.5。将
behaviorConfiguration特性添加到<service>元素，并指定在步骤 1 中添加的name元素的<behavior>特性，如下面的代码示例所示。<services> <service name="Metadata.Example.SimpleService" behaviorConfiguration="SimpleServiceBehavior"> ... </service> </services> <behaviors> <serviceBehaviors> <behavior name="SimpleServiceBehavior"> <serviceMetadata httpGetEnabled="True" policyVersion="Policy15" /> </behavior> </serviceBehaviors> </behaviors>添加一个或多个其协定设置为
<endpoint>的IMetadataExchange元素，如下面的代码示例所示。<services> <service name="Metadata.Example.SimpleService" behaviorConfiguration="SimpleServiceBehavior"> <endpoint address="" binding="wsHttpBinding" contract="Metadata.Example.ISimpleService" /> <endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange" /> </service> </services>对于上一步中添加的元数据终结点，将
binding特性设置为下列值之一：mexHttpBinding（对于 HTTP 发布）。mexHttpsBinding（对于 HTTPS 发布）。mexNamedPipeBinding（对于命名管道发布）。mexTcpBinding（对于 TCP 发布）。
对于上一步中添加的元数据终结点，将地址设置为等于：
一个空字符串，以在基址和元数据绑定相同的情况下将主机应用程序的基址用作发布点。
一个相对地址，前提是主机应用程序具有一个基址。
一个绝对地址。
生成并运行控制台应用程序。
浏览到服务的基址（本示例中的
http://localhost:8001/MetadataSample）并验证已打开元数据发布。 如果未显示上述内容，则结果页顶部会显示消息：“Metadata publishing for this service is currently disabled”（当前禁用服务的元数据发布）。
使用默认终结点
若要配置使用默认终结点的服务上的元数据，请在上一个示例中的配置文件中指定 ServiceMetadataBehavior，但不要指定任何终结点。 配置文件将类似如下所示。
<configuration> <system.serviceModel> <behaviors> <serviceBehaviors> <behavior name="SimpleServiceBehavior"> <serviceMetadata httpGetEnabled="True" policyVersion="Policy12" /> </behavior> </serviceBehaviors> </behaviors> </system.serviceModel> </configuration>由于该服务有一个 ServiceMetadataBehavior 设置为
httpGetEnabled的true，因此该服务启用了发布元数据，但是由于未显式添加任何终结点，因此运行时添加默认终结点。 有关默认终结点、绑定和行为的详细信息，请参阅简化配置和 WCF 服务的简化配置。
示例
下面的代码示例演示基本 WCF 服务的实现，以及发布服务的元数据的配置文件。
using System;
using System.Runtime.Serialization;
using System.ServiceModel;
using System.ServiceModel.Description;
namespace Metadata.Samples
{
[ServiceContract]
public interface ISimpleService
{
[OperationContract]
string SimpleMethod(string msg);
}
class SimpleService : ISimpleService
{
public string SimpleMethod(string msg)
{
Console.WriteLine("The caller passed in " + msg);
return "Hello " + msg;
}
}
class Program
{
static void Main(string[] args)
{
ServiceHost host = new ServiceHost(typeof(SimpleService),
new Uri("http://localhost:8001/MetadataSample"));
try
{
// Open the service host to accept incoming calls
host.Open();
// The service can now be accessed.
Console.WriteLine("The service is ready.");
Console.WriteLine("Press <ENTER> to terminate service.");
Console.WriteLine();
Console.ReadLine();
// Close the ServiceHostBase to shutdown the service.
host.Close();
}
catch (CommunicationException commProblem)
{
Console.WriteLine("There was a communication problem. " + commProblem.Message);
Console.Read();
}
}
}
}
<configuration>
<system.serviceModel>
<behaviors>
<serviceBehaviors>
<behavior name="SimpleServiceBehavior">
<serviceMetadata httpGetEnabled="True" policyVersion="Policy12" />
<serviceDebug includeExceptionDetailInFaults="False" />
</behavior>
</serviceBehaviors>
</behaviors>
</system.serviceModel>
</configuration>