端點建立概觀

發行項
05/20/2023

與 Windows Communication Foundation (WCF) 服務進行的所有通訊，會透過服務的「端點」來完成。端點可讓用戶端存取 WCF 服務提供的功能。本章節說明端點的結構，並且摘要說明如何透過組態與程式碼來定義端點。

端點結構

每個端點都包含一個位址用以指出該到何處尋找端點、一個指定用戶端與端點如何進行通訊的繫結，以及一個可識別可用方法的合約。

位址。位址會唯一識別端點並告訴潛在取用者服務的位置。它是由 WCF 物件模型中的 EndpointAddress 位址所代表，內含統一資源識別元 (URI) 與位址屬性，而這些屬性又包含了身分識別、一些 Web 服務描述語言 (WSDL) 項目，以及選用標頭的集合。選用標頭會提供額外的詳細位址資訊來識別端點或與端點互動。如需詳細資訊，請參閱指定端點位址。
繫結。繫結會指定與端點的通訊方式。繫結程序會指定端點與世界的通訊方式，包括要使用的傳輸通訊協定 (例如，TCP 或 HTTP)、訊息使用的編碼 (例如，文字或二進位)，以及必要的安全性要求有哪些 (例如，Secure Sockets Layer [SSL] 或 SOAP 訊息安全性)。如需詳細資訊，請參閱使用繫結來設定服務和用戶端。
服務合約。服務合約會概略說明端點公開哪些功能給用戶端。合約指定了用戶端可以呼叫的作業、訊息格式與輸入參數型別或是呼叫作業時必要的資料，以及用戶端能夠預期的處理或回應訊息類型。三種基本合約型別都對應至基本的訊息交換模式 (MEP)：資料包 (單向)、要求/回覆，與雙工 (雙向)。當服務合約遭到存取，也能使用資料與訊息合約來要求特定資料類型與訊息格式。如需如何定義服務合約的詳細資訊，請參閱設計服務合約。請注意，用戶端可能也會被要求實作服務定義合約 (稱為回呼合約)，以便在雙工 MEP 中從服務接收訊息。如需詳細資訊，請參閱雙面服務。

您可以透過命令式程式碼或是宣告式組態來指定服務端點。如果沒有指定端點，則執行階段會針對服務所實作的每個服務合約，為每個基底位址加入一個預設端點，藉以提供預設端點。在程式碼中定義端點通常不太實用，因為部署之服務的繫結和位址通常與開發服務時所使用的繫結和位址不同。一般來說，透過組態來定義服務端點會比透過程式碼來得實際一些。將繫結和位址資訊留在程式碼外面可讓它們直接進行變更，而不需要重新編譯或重新部署應用程式。

注意

在新增可執行模擬服務端點時，您必須使用其中一個 AddServiceEndpoint 方法或是 GetContract(Type, Type) 方法，將合約適當地載入新的 ServiceDescription 物件中。

在程式碼中定義端點

下列範例將說明如何使用下列各項在程式碼中指定端點：

定義服務 IEcho 類型的合約，以便接受某人名稱以及包含 "Hello <name>!" 的回應。
實作由 Echo 合約定義的 IEcho 服務型別。
為服務指定 http://localhost:8000/Echo 的端點位址。
使用 Echo 繫結來設定 WSHttpBinding 服務。

namespace Echo
{
   // Define the contract for the IEcho service
   [ServiceContract]
   public interface IEcho
   {
       [OperationContract]
       String Hello(string name)
   }

   // Create an Echo service that implements IEcho contract
   class Echo : IEcho
   {
      public string Hello(string name)
      {
         return "Hello" + name + "!";
      }
      public static void Main ()
      {
          //Specify the base address for Echo service.
          Uri echoUri = new Uri("http://localhost:8000/");

          //Create a ServiceHost for the Echo service.
          ServiceHost serviceHost = new ServiceHost(typeof(Echo),echoUri);

          // Use a predefined WSHttpBinding to configure the service.
          WSHttpBinding binding = new WSHttpBinding();

          // Add the endpoint for this service to the service host.
          serviceHost.AddServiceEndpoint(
             typeof(IEcho),
             binding,
             echoUri
           );

          // Open the service host to run it.
          serviceHost.Open();
     }
  }
}

' Define the contract for the IEcho service
    <ServiceContract()> _
    Public Interface IEcho
        <OperationContract()> _
        Function Hello(ByVal name As String) As String
    End Interface

' Create an Echo service that implements IEcho contract
    Public Class Echo
        Implements IEcho
        Public Function Hello(ByVal name As String) As String _
 Implements ICalculator.Hello
            Dim result As String = "Hello" + name + "!"
            Return result
        End Function

' Specify the base address for Echo service.
Dim echoUri As Uri = New Uri("http://localhost:8000/")

' Create a ServiceHost for the Echo service.
Dim svcHost As ServiceHost = New ServiceHost(GetType(HelloWorld), echoUri)

' Use a predefined WSHttpBinding to configure the service.
Dim binding As New WSHttpBinding()

' Add the endpoint for this service to the service host.
serviceHost.AddServiceEndpoint(GetType(IEcho), binding, echoUri)

' Open the service host to run it.
serviceHost.Open()

注意

使用基底位址建立服務主機，然後將相對於基底位址的其餘位址指定為端點的一部分。這種位址分割方式可讓您更方便地針對主機上的服務定義多個端點。

注意

服務應用程式中的 ServiceDescription 屬性不得在 OnOpening 上的 ServiceHostBase 方法之後修改。一些成員，像是 Credentials 屬性及 AddServiceEndpoint 與 ServiceHostBase 上的 ServiceHost 方法，如果在通過該點之後修改，便會擲回例外狀況。其他成員可讓您加以修改，但結果仍未定義。

同樣地，您不可以在呼叫 ServiceEndpoint 上的 OnOpening 之後修改用戶端上的 ChannelFactory 值。 Credentials 屬性如果在通過該點之後修改，便會擲回例外狀況。其他的用戶端說明值可以修改而不會造成錯誤，但是結果仍為未定義。

無論是在服務或是用戶端，建議的做法都是在呼叫 Open 之前修改說明。

在組態中定義端點

建立應用程式時，您經常會想要延遲負責部署應用程式之系統管理員的決定。例如，經常無法預先得知服務位址 (URI) 會是怎樣。這時候，為位址進行硬式編碼並不是理想的作法，較好的作法是讓系統管理員在建立服務後再處理。這樣的靈活性是透過組態達成。如需詳細資料，請參閱設定服務。

注意

使用 ServiceModel Metadata Utility Tool (Svcutil.exe) 和 /config:filename[,filename] 參數快速建立組態檔。

使用預設端點

如果在程式碼或組態中沒有指定端點，則執行階段會針對服務所實作的每個服務合約，為每個基底位址加入一個預設端點，藉以提供預設端點。基底位址可以在程式碼或組態中指定，而預設端點則會在 Open() 上呼叫 ServiceHost 時加入。這個範例和上一節的範例相同，但是因為沒有指定端點，所以會加入預設端點。

namespace Echo
{
   // Define the contract for the IEcho service
   [ServiceContract]
   public interface IEcho
   {
       [OperationContract]
       String Hello(string name)
   }

   // Create an Echo service that implements IEcho contract
   public class Echo : IEcho
   {
      public string Hello(string name)
      {
         return "Hello" + name + "!";
      }
      public static void Main ()
      {
          //Specify the base address for Echo service.
          Uri echoUri = new Uri("http://localhost:8000/");

          //Create a ServiceHost for the Echo service.
          ServiceHost serviceHost = new ServiceHost(typeof(Echo),echoUri);

          // Open the service host to run it. Default endpoints
          // are added when the service is opened.
          serviceHost.Open();
     }
  }
}

' Define the contract for the IEcho service
    <ServiceContract()> _
    Public Interface IEcho
        <OperationContract()> _
        Function Hello(ByVal name As String) As String
    End Interface

' Create an Echo service that implements IEcho contract
    Public Class Echo
        Implements IEcho
        Public Function Hello(ByVal name As String) As String _
 Implements ICalculator.Hello
            Dim result As String = "Hello" + name + "!"
            Return result
        End Function

' Specify the base address for Echo service.
Dim echoUri As Uri = New Uri("http://localhost:8000/")

' Open the service host to run it. Default endpoints
' are added when the service is opened.
serviceHost.Open()

如果沒有明確提供端點，在呼叫 AddDefaultEndpoints 之前，仍可藉由在 ServiceHost 上呼叫 Open 來加入預設端點。如需預設端點的詳細資訊，請參閱簡化的組態和 WCF 服務的簡化組態。

另請參閱

履行服務合約