如何：自定義 System-Provided 系結

發行項
03/26/2025

Windows Communication Foundation （WCF）包含數個系統提供的系結，可讓您設定基礎綁定項的某些屬性，但並非所有屬性。本主題示範如何在綁定項上設定屬性，以建立自定義系結。

如需如何在不使用系統提供的系結的情況下直接建立及設定綁定項的詳細資訊，請參閱自定義系結。

如需建立和擴充自定義系結的詳細資訊，請參閱擴充系結。

在 WCF 中，所有系結都是由 綁定項所組成。每個綁定項都是衍生自 BindingElement 類別。由系統提供的綁定，例如 BasicHttpBinding，會建立及設定自己的綁定元素。本主題說明如何存取和變更這些綁定項的屬性，這些綁定項不會直接公開在系結上;具體來說，BasicHttpBinding 類別。

個別綁定項包含在由 BindingElementCollection 類別所代表的集合中，並依下列順序新增：交易流程、可靠會話、安全性、複合雙工、單向、數據流安全性、訊息編碼和傳輸。請注意，並非每個系結都需要列出的所有綁定項。使用者定義的綁定項也可以出現在這個綁定項集合中，而且必須以與先前所述的相同順序顯示。例如，使用者定義傳輸必須是繫結元素集合的最後一個元素。

BasicHttpBinding 類別包含三個綁定項：

選擇性的安全性綁定項，可以是用於 HTTP 傳輸（訊息層級安全性）的 AsymmetricSecurityBindingElement 類別，或者在傳輸層提供安全性時使用的 TransportSecurityBindingElement 類別，此時則使用 HTTPS 傳輸。
必要的訊息編碼器綁定元素，TextMessageEncodingBindingElement 或 MtomMessageEncodingBindingElement。
必須的傳輸繫結元素，HttpTransportBindingElement或 HttpsTransportBindingElement。

在此範例中，我們會建立系結的實例、從中產生 自定義系結、檢查自定義系結中的綁定項，以及當我們找到 HTTP 綁定項時，我們會將其 KeepAliveEnabled 屬性設定為 false。 KeepAliveEnabled 屬性不會直接公開在 BasicHttpBinding上，因此我們必須建立自定義系結，才能向下巡覽至綁定項並設定此屬性。

修改系統提供的系結

建立 BasicHttpBinding 類別的實例，並將其安全性模式設定為訊息層級。

//  Create an instance of the T:System.ServiceModel.BasicHttpBinding
//  class and set its security mode to message-level security.
BasicHttpBinding binding = new BasicHttpBinding();
binding.Security.Message.ClientCredentialType = BasicHttpMessageCredentialType.Certificate;
binding.Security.Mode = BasicHttpSecurityMode.Message;

'  Create an instance of the T:System.ServiceModel.BasicHttpBinding 
'  class and set its security mode to message-level security.
Dim binding As New BasicHttpBinding()
With binding.Security
    .Message.ClientCredentialType = BasicHttpMessageCredentialType.Certificate
    .Mode = BasicHttpSecurityMode.Message
End With

從系結建立自定義系結，並從其中一個自定義系結的屬性建立 BindingElementCollection 類別。

//  Create a custom binding from the binding
CustomBinding cb = new CustomBinding(binding);
//  Get the BindingElementCollection from this custom binding
BindingElementCollection bec = cb.Elements();

'  Create a custom binding from the binding 
Dim cb As New CustomBinding(binding)
'  Get the BindingElementCollection from this custom binding 
Dim bec = cb.Elements

循環執行 BindingElementCollection 類別，並在找到 HttpTransportBindingElement 類別時，將其 KeepAliveEnabled 屬性設定為 false。

//  Loop through the collection, and when you find the HTTP binding element
//  set its KeepAliveEnabled property to false
foreach (BindingElement be in bec)
{
    Type thisType = be.GetType();
    Console.WriteLine(thisType);
    if (be is HttpTransportBindingElement)
    {
        HttpTransportBindingElement httpElement = (HttpTransportBindingElement)be;
        Console.WriteLine($"\tBefore: HttpTransportBindingElement.KeepAliveEnabled = {httpElement.KeepAliveEnabled}");
        httpElement.KeepAliveEnabled = false;
        Console.WriteLine($"\tAfter:  HttpTransportBindingElement.KeepAliveEnabled = {httpElement.KeepAliveEnabled}");
    }
}

'  Loop through the collection, and when you find the HTTP binding element
'  set its KeepAliveEnabled property to false
For Each be In bec
    Dim thisType = be.GetType()
    Console.WriteLine(thisType)
    If TypeOf be Is HttpTransportBindingElement Then
        Dim httpElement As HttpTransportBindingElement = CType(be, HttpTransportBindingElement)
        Console.WriteLine(Constants.vbTab & "Before: HttpTransportBindingElement.KeepAliveEnabled = {0}", httpElement.KeepAliveEnabled)
        httpElement.KeepAliveEnabled = False
        Console.WriteLine(vbTab & "After:  HttpTransportBindingElement.KeepAliveEnabled = {0}", httpElement.KeepAliveEnabled)
    End If
Next be

共用方式為

如何：自定義 System-Provided 系結

修改系統提供的系結

另請參閱

其他資源