NetTcpBinding 類別

定義

命名空間:

System.ServiceModel

組件:

System.ServiceModel.NetTcp.dll

組件:

System.ServiceModel.dll

一個適用於跨電腦通訊的安全、可靠的繫結。

public ref class NetTcpBinding : System::ServiceModel::Channels::Binding

public ref class NetTcpBinding : System::ServiceModel::Channels::Binding, System::ServiceModel::Channels::IBindingRuntimePreferences

public class NetTcpBinding : System.ServiceModel.Channels.Binding

public class NetTcpBinding : System.ServiceModel.Channels.Binding, System.ServiceModel.Channels.IBindingRuntimePreferences

type NetTcpBinding = class
    inherit Binding

type NetTcpBinding = class
    inherit Binding
    interface IBindingRuntimePreferences

Public Class NetTcpBinding
Inherits Binding

Public Class NetTcpBinding
Inherits Binding
Implements IBindingRuntimePreferences

繼承

Object

Binding

NetTcpBinding

衍生

System.ServiceModel.NetTcpContextBinding

實作

IBindingRuntimePreferences

範例

此範例示範如何建立 NetTcpBinding 、設定安全性模式和傳輸認證類型。

NetTcpBinding binding = new NetTcpBinding();
binding.Security.Mode = SecurityMode.Transport;
binding.Security.Transport.ClientCredentialType = TcpClientCredentialType.Certificate;

備註

NetTcpBinding預設會產生執行時間通訊堆疊，它會使用傳輸安全性、TCP 進行訊息傳遞，以及二進位訊息編碼。 此系結是適當的Windows Communication Foundation (WCF) 系統提供用來透過內部網路通訊的選項。

的預設組態比 所提供的 WSHttpBinding 組態 NetTcpBinding 更快，但僅供 WCF 通訊使用。 您可以使用建構函式中的選擇性 securityMode 參數，設定安全性行為。 您可以使用選擇性的 reliableSessionEnabled 參數，設定是否要使用 WS-ReliableMessaging。 不過可信賴傳訊預設為關閉。 較常見地，HTTP 系統提供繫結，例如 WSHttpBinding 及 BasicHttpBinding 設定好可預設啟動，而 NetTcpBinding 繫結則預設關閉，因此必須 Opt-In 以尋求支援，例如 WS-* 規格其中一個。 這意味著預設的 TCP 組態在端點間交換訊息，較依照預設針對 HTTP 繫結所設定的還快。

警告

會 NetTcpBinding 根據服務的主機名稱和服務所接聽的埠號碼，使用 TCP 連線共用。 當用戶端對不同埠上的不同服務進行呼叫，或服務裝載于單一進程並共用埠時，這可以正常運作。 如果單一用戶端呼叫多個服務共用裝載于不同進程的埠，或裝載 WAS/IIS，用戶端共用可能會導致服務 B 的連線重複使用的問題，導致擲回例外狀況、已中止連接，以及建立新的通道的問題。 若要避免這個問題，請使用 CustomBinding，並為用戶端所通訊的每個服務指定不同的 ConnectionPoolSettings.GroupName。

建構函式

NetTcpBinding()	初始化 NetTcpBinding 類別的新執行個體。
NetTcpBinding(SecurityMode)	使用指定的安全性類型，初始化 NetTcpBinding 類別的新執行個體。
NetTcpBinding(SecurityMode, Boolean)	使用指定使用的安全性類型以及指示可靠工作階段是否明確啟用的值，初始化 NetTcpBinding 類別的新執行個體。
NetTcpBinding(String)	使用指定的組態名稱，初始化 NetTcpBinding 類別的新執行個體。

屬性

CloseTimeout	取得或設定針對連線所提供的時間間隔 (此連線要在傳輸引發例外狀況之前關閉)。 (繼承來源 Binding)
EnvelopeVersion	取得 SOAP 的版本，用於由此繫結處理的訊息。
HostNameComparisonMode	取得或設定值，這個值會指出在比對 URI 時此主機名稱是否會用來取用服務。
ListenBacklog	取得或設定可以擱置之佇列連線要求的最大數目。
MaxBufferPoolSize	取得或設定儲存繫結所處理之 TCP 訊息的可用緩衝集區大小上限 (以位元組為單位)。
MaxBufferSize	取得或設定值，這個值會指定記憶體中用來儲存訊息的緩衝區大小上限 (以位元組為單位)。
MaxConnections	取得或設定值，控制在用戶端後續重複使用的共用連接數量上限，以及允許在伺服器上暫止分派的連接數量上限。
MaxReceivedMessageSize	取得或設定由繫結處理之接收訊息的大小上限 (以位元組為單位)。
MessageVersion	取得用戶端所使用的訊息版本及使用繫結所設定的服務。 (繼承來源 Binding)
Name	取得或設定繫結的名稱。 (繼承來源 Binding)
Namespace	取得或設定繫結的 XML 命名空間。 (繼承來源 Binding)
OpenTimeout	取得或設定針對連線所提供的時間間隔 (此連線要在傳輸引發例外狀況之前開啟)。 (繼承來源 Binding)
PortSharingEnabled	取得或設定布林值，這個值表示是否啟用以此繫結設定的連線之 TCP 連接埠共用功能。
ReaderQuotas	取得或設定 SOAP 訊息複雜性的條件約束，而這些條件約束可由以此繫結所設定的端點處理。
ReceiveTimeout	取得或設定連線中斷之前，可以維持非作用狀態的時間間隔 (在此期間未接收應用程式訊息)。 (繼承來源 Binding)
ReliableSession	取得物件，這個物件表示是否在通道端點之間建立可靠的工作階段。
Scheme	傳回用於傳輸的 URI 配置。
Security	取得物件，指定與此繫結所設定之服務共用的安全性類型。
SendTimeout	取得或設定針對寫入作業所提供的時間間隔 (此作業要在傳輸引發例外狀況之前完成)。 (繼承來源 Binding)
TransactionFlow	取得或設定值，這個值會判斷是否啟用交易流程。
TransactionProtocol	取得或設定服務用來使交易流動的交易通訊協定。
TransferMode	取得或設定值，這個值會指出以繫結設定的服務使用訊息傳輸的資料流處理模式或緩衝處理模式 (或兩者)。

方法

BuildChannelFactory<TChannel>(BindingParameterCollection)	在用戶端上建置通道處理站堆疊，此堆疊會建立指定的通道型別，並滿足繫結參數集合所指定的功能。 (繼承來源 Binding)
BuildChannelFactory<TChannel>(Object[])	在用戶端上建置通道處理站堆疊，此堆疊會建立指定的通道型別，並滿足物件陣列所指定的功能。 (繼承來源 Binding)
BuildChannelListener<TChannel>(BindingParameterCollection)	在服務上建置通道接聽程式，此接聽程式會接受指定的通道型別，並滿足繫結參數集合所指定的功能。 (繼承來源 Binding)
BuildChannelListener<TChannel>(Object[])	在服務上建置通道接聽程式，此接聽程式可接受指定的通道型別並滿足指定的功能。 (繼承來源 Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection)	在服務上建置通道接聽程式，此接聽程式可接受指定的通道型別並滿足指定的功能。 (繼承來源 Binding)
BuildChannelListener<TChannel>(Uri, Object[])	在服務上建置通道接聽程式，此接聽程式可接受指定的通道型別並滿足指定的功能。 (繼承來源 Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)	在服務上建置通道接聽程式，此接聽程式可接受指定的通道型別並滿足指定的功能。 (繼承來源 Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)	在服務上建置通道接聽程式，此接聽程式可接受指定的通道型別並滿足指定的功能。 (繼承來源 Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])	在服務上建置通道接聽程式，此接聽程式可接受指定的通道型別並滿足指定的功能。 (繼承來源 Binding)
BuildChannelListener<TChannel>(Uri, String, Object[])	在服務上建置通道接聽程式，此接聽程式可接受指定的通道型別並滿足指定的功能。 (繼承來源 Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection)	傳回值，這個值指出目前的繫結是否可以在用戶端上建置滿足指定之繫結參數集合的通道處理站堆疊。 (繼承來源 Binding)
CanBuildChannelFactory<TChannel>(Object[])	傳回值，這個值指出目前的繫結程序是否可以在用戶端上建置滿足物件陣列指定之需求的通道處理站堆疊。 (繼承來源 Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection)	傳回值，這個值指出目前的繫結是否可以在服務上建置滿足指定之繫結參數集合的通道接聽程式堆疊。 (繼承來源 Binding)
CanBuildChannelListener<TChannel>(Object[])	傳回值，這個值指出目前的繫結是否可以在服務上建置滿足物件陣列中指定之準則的通道接聽程式堆疊。 (繼承來源 Binding)
CreateBindingElements()	建立含有繫結之繫結項目的集合。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetProperty<T>(BindingParameterCollection)	從繫結堆疊的適當層次中，傳回要求的型別物件 (如果有)。 (繼承來源 Binding)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ShouldSerializeListenBacklog()	傳回值，這個值表示 ListenBacklog 屬性是否已變更為非預設值且應該序列化。
ShouldSerializeMaxConnections()	傳回值，這個值表示 MaxConnections 屬性是否已變更為非預設值且應該序列化。
ShouldSerializeName()	傳回繫結的名稱是否應該序列化。 (繼承來源 Binding)
ShouldSerializeNamespace()	傳回繫結的命名空間是否應該序列化。 (繼承來源 Binding)
ShouldSerializeReaderQuotas()	傳回值，這個值表示 ReaderQuotas 屬性是否已變更為非預設值且應該序列化。
ShouldSerializeReliableSession()	傳回值，這個值表示 ReliableSession 屬性是否已變更為非預設值且應該序列化。
ShouldSerializeSecurity()	傳回值，這個值表示 Security 屬性是否已變更為非預設值且應該序列化。
ShouldSerializeTransactionProtocol()	傳回值，這個值表示 TransactionProtocol 屬性是否已變更為非預設值且應該序列化。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

IBindingRuntimePreferences.ReceiveSynchronously

取得值，這個值會指出要以同步或非同步方式處理傳入要求。