作法：使用組態檔發行服務的中繼資料
在兩個示範如何發行 Windows Communication Foundation (WCF) 服務中繼資料的 HOW TO 主題中，這是其中一個。 有兩種方法可以指定服務發行中繼資料的方式，分別是使用組態檔和使用程式碼。 本主題說明如何使用組態檔發行服務的中繼資料。
警告
本主題將示範以不安全的方法發行中繼資料。 任何用戶端都能從服務擷取中繼資料。 若您的服務需要以安全的方法發行中繼資料，請參閱自訂安全中繼資料端點。
如需在程式碼中發行中繼資料的詳細資訊，請參閱如何：使用程式碼發行服務的中繼資料。 發行中繼資料可讓用戶端透過 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>項目。在
<behaviors>項目中，新增<serviceBehaviors>項目。將
<behavior>項目新增至<serviceBehaviors>項目，並指定name項目的<behavior>屬性值。將
<serviceMetadata>項目加入至<behavior>項目。 將httpGetEnabled屬性設為true並將policyVersion屬性設為 Policy15。httpGetEnabled允許服務回應由 HTTP GET 要求所提出的中繼資料要求。policyVersion會在產生中繼資料時，要求服務符合 WS-Policy 1.5 規定。將
behaviorConfiguration屬性加入至<service>項目，並指定name項目的<behavior>屬性 (於步驟 1 中加入)，如下列程式碼範例所示。<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)，然後確認已開啟中繼資料發行功能。 如果沒有的話，結果頁面上方應該會顯示：「為此服務發行的中繼資料目前停用」。
若要使用預設端點
若要對使用預設端點的服務設定中繼資料，請在組態檔中指定 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>