NetTcpBinding NetTcpBinding NetTcpBinding NetTcpBinding Class

定義

複数コンピューターの通信に適した、セキュリティで保護された信頼できるバインドです。A secure, reliable binding suitable for cross-machine communication.

public ref class NetTcpBinding : System::ServiceModel::Channels::Binding, System::ServiceModel::Channels::IBindingRuntimePreferences
public class NetTcpBinding : System.ServiceModel.Channels.Binding, System.ServiceModel.Channels.IBindingRuntimePreferences
type NetTcpBinding = class
    inherit Binding
    interface IBindingRuntimePreferences
Public Class NetTcpBinding
Inherits Binding
Implements IBindingRuntimePreferences
継承
NetTcpBindingNetTcpBindingNetTcpBindingNetTcpBinding
派生
実装

次の例は、セキュリティ モードとトランスポート資格情報の種類を設定して、NetTcpBinding を作成する方法を示します。This example shows how to create a NetTcpBinding, setting the security mode and transport credential type.

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

注釈

NetTcpBinding は、既定ではランタイム通信スタックを生成し、トランスポート セキュリティ、メッセージ配信用 TCP、およびバイナリ メッセージ エンコーディングを使用します。The NetTcpBinding generates a run-time communication stack by default, which uses transport security, TCP for message delivery, and a binary message encoding. このバインディングは、イントラネット経由で通信するための適切な Windows Communication Foundation (WCF) システム提供の選択肢です。This binding is an appropriate Windows Communication Foundation (WCF) system-provided choice for communicating over an Intranet.

の既定の構成NetTcpBindingは、 WSHttpBindingによって提供される構成よりも高速ですが、WCF 通信のみを目的としています。The default configuration for the NetTcpBinding is faster than the configuration provided by the WSHttpBinding, but it is intended only for WCF communication. セキュリティ動作は、コンストラクターの省略可能な securityMode パラメーターを使用して設定できます。The security behavior is configurable using the optional securityMode parameter in the constructor. WS-ReliableMessaging を使用するかどうかは、省略可能な reliableSessionEnabled パラメーターを使用して設定できます。The use of WS-ReliableMessaging is configurable using the optional reliableSessionEnabled parameter. ただし、信頼できるメッセージングは、既定ではオフです。But reliable messaging is off by default. WSHttpBindingBasicHttpBinding などの HTTP システム指定のバインディングは、既定では設定をオンにするように構成され、NetTcpBinding バインディングは、既定では設定をオフにするように構成されているのが一般的であるため、たとえば、いずれかの WS-* 仕様のサポートを得るには、サポートを選択する必要があります。More generally, the HTTP system-provided bindings such as WSHttpBinding and BasicHttpBinding are configured to turn things on by default, whereas the NetTcpBinding binding turns things off by default so that you have to opt-in to get support, for example, for one of the WS-* specifications. これは、TCP の既定の構成の方が、HTTP バインド用の既定の構成より、エンドポイント間でのメッセージ交換が高速になることを意味します。This means that the default configuration for TCP is faster at exchanging messages between endpoints than that configured for the HTTP bindings by default.

警告

NetTcpBinding 、サービスのホスト DNS 名と、サービスがリッスンしているポート番号に基づいて、TCP 接続プールを使用します。The NetTcpBinding uses TCP connection pooling based on the service's host DNS name and the port number the service is listening on. これは、クライアントが異なるポートで異なるサービスを呼び出す場合、またはサービスが1つのプロセスでホストされ、ポートを共有する場合に適しています。This works well when a client makes calls to different services on different ports, or services are hosted in a single process and share a port. 1つのクライアントが複数のサービスを呼び出して、別のプロセスでホストされているポートを共有する場合、または WAS/IIS でホストされている場合は、クライアント側のプーリングによって、サービス A への接続がサービス B に再利用され、例外がスローされるという問題が発生する可能性があります。、接続が中止され、新しいチャネルが作成されました。If a single client calls multiple services sharing a port that are hosted in different processes, or are WAS/IIS hosted, the client side pooling may lead to problems where a connection to Service A is reused for Service B, resulting in an exception being thrown, the connection aborted, and a new channel created. この問題を回避するには、CustomBinding を使用して、クライアントが通信するサービスごとに異なる ConnectionPoolSettings を指定します。To avoid this problem, use a CustomBinding and specify a different ConnectionPoolSettings.GroupName for each service the client communicates with.

コンストラクター

NetTcpBinding() NetTcpBinding() NetTcpBinding() NetTcpBinding()

NetTcpBinding クラスの新しいインスタンスを初期化します。Initializes a new instance of the NetTcpBinding class.

NetTcpBinding(SecurityMode) NetTcpBinding(SecurityMode) NetTcpBinding(SecurityMode) NetTcpBinding(SecurityMode)

使用されるセキュリティの種類を指定して、NetTcpBinding クラスの新しいインスタンスを初期化します。Initializes a new instance of the NetTcpBinding class with the type of security used specified.

NetTcpBinding(SecurityMode, Boolean) NetTcpBinding(SecurityMode, Boolean) NetTcpBinding(SecurityMode, Boolean) NetTcpBinding(SecurityMode, Boolean)

使用するセキュリティの種類と、信頼できるセッションを明示的に有効にするかどうかを示す値を指定して、NetTcpBinding クラスの新しいインスタンスを初期化します。Initializes a new instance of the NetTcpBinding class with the type of security used specified and with a value that indicates whether reliable sessions are explicitly enabled.

NetTcpBinding(String) NetTcpBinding(String) NetTcpBinding(String) NetTcpBinding(String)

構成名を指定して、NetTcpBinding クラスの新しいインスタンスを初期化します。Initializes a new instance of the NetTcpBinding class with a specified configuration name.

プロパティ

CloseTimeout CloseTimeout CloseTimeout CloseTimeout

接続の終了を待機する時間間隔を取得および設定します。これを超えるとトランスポートで例外が発生します。Gets or sets the interval of time provided for a connection to close before the transport raises an exception.

(Inherited from Binding)
EnvelopeVersion EnvelopeVersion EnvelopeVersion EnvelopeVersion

このバインドによって処理されるメッセージで使用される SOAP のバージョンを取得します。Gets the version of SOAP that is used for messages processed by this binding.

HostNameComparisonMode HostNameComparisonMode HostNameComparisonMode HostNameComparisonMode

URI が一致した場合にサービスに到達するためにホスト名を使用するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the hostname is used to reach the service when matching the URI.

ListenBacklog ListenBacklog ListenBacklog ListenBacklog

保留可能なキュー内の接続要求の最大数を取得または設定します。Gets or sets the maximum number of queued connection requests that can be pending.

MaxBufferPoolSize MaxBufferPoolSize MaxBufferPoolSize MaxBufferPoolSize

バインディングによって処理される TCP メッセージを保存するバッファー プールで許可される最大サイズ (バイト単位) を取得または設定します。Gets or sets the maximum size, in bytes, allowed for a buffer pool that stores TCP messages processed by the binding.

MaxBufferSize MaxBufferSize MaxBufferSize MaxBufferSize

メッセージをメモリに保存するために使用するバッファーの最大サイズをバイト単位で指定する値を取得または設定します。Gets or sets a value that specifies the maximum size, in bytes, of the buffer used to store messages in memory.

MaxConnections MaxConnections MaxConnections MaxConnections

クライアント上で後で再使用するためにプールできる接続の最大数と、サーバー上でディスパッチを保留できる接続の最大数を制御する値を取得または設定します。Gets or sets a value that controls the maximum number of connections to be pooled for subsequent reuse on the client and the maximum number of connections allowed to be pending dispatch on the server.

MaxReceivedMessageSize MaxReceivedMessageSize MaxReceivedMessageSize MaxReceivedMessageSize

このバインディングで処理される受信メッセージの最大サイズ (バイト単位) を取得または設定します。Gets or sets the maximum size, in bytes, for a received message that is processed by the binding.

MessageVersion MessageVersion MessageVersion MessageVersion

バインドで構成されるクライアントとサービスが使用するメッセージ バージョンを取得します。Gets the message version used by clients and services configured with the binding.

(Inherited from Binding)
Name Name Name Name

バインドの名前を取得または設定します。Gets or sets the name of the binding.

(Inherited from Binding)
Namespace Namespace Namespace Namespace

バインドの XML 名前空間を取得または設定します。Gets or sets the XML namespace of the binding.

(Inherited from Binding)
OpenTimeout OpenTimeout OpenTimeout OpenTimeout

接続の確立を待機する時間間隔を取得および設定します。これを超えるとトランスポートで例外が発生します。Gets or sets the interval of time provided for a connection to open before the transport raises an exception.

(Inherited from Binding)
PortSharingEnabled PortSharingEnabled PortSharingEnabled PortSharingEnabled

このバインドを使用して構成された接続で、TCP ポート共有を有効にするかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether TCP port sharing is enabled for the connection configured with this binding.

ReaderQuotas ReaderQuotas ReaderQuotas ReaderQuotas

このバインディングで構成されたエンドポイントにより処理可能な、SOAP メッセージの複雑さに対する制約を取得または設定します。Gets or sets constraints on the complexity of SOAP messages that can be processed by endpoints configured with this binding.

ReceiveTimeout ReceiveTimeout ReceiveTimeout ReceiveTimeout

アプリケーション メッセージが受信されない間に、接続が非アクティブになってから切断されるまでの時間を取得または設定します。Gets or sets the interval of time that a connection can remain inactive, during which no application messages are received, before it is dropped.

(Inherited from Binding)
ReliableSession ReliableSession ReliableSession ReliableSession

チャネルのエンドポイント間に信頼できるセッションを確立するかどうかを示す構成要素を取得します。Gets an object that indicates whether a reliable session is established between channel endpoints.

Scheme Scheme Scheme Scheme

トランスポートの URI スキームを返します。Returns the URI scheme for the transport.

Security Security Security Security

この要素を使用して構成されたサービスで使用されるセキュリティの種類を指定するオブジェクトを取得します。Gets an object that specifies the type of security used with services configured with this binding.

SendTimeout SendTimeout SendTimeout SendTimeout

書き込み操作の完了を待機する時間間隔を取得および設定します。これを超えるとトランスポートで例外が発生します。Gets or sets the interval of time provided for a write operation to complete before the transport raises an exception.

(Inherited from Binding)
TransactionFlow TransactionFlow TransactionFlow TransactionFlow

トランザクション フローが有効かどうかを決定する値を取得または設定します。Gets or sets a value that determines whether transaction flow is enabled.

TransactionProtocol TransactionProtocol TransactionProtocol TransactionProtocol

トランザクションをフローするためにサービスで使用されるトランザクション プロトコルを取得または設定します。Gets or sets the transactions protocol used by the service to flow transactions.

TransferMode TransferMode TransferMode TransferMode

このバインディングを使用して構成されたサービスが、メッセージ転送のストリーミング モードまたはバッファー モード (あるいは両方のモード) を使用するかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the service configured with the binding uses streamed or buffered (or both) modes of message transfer.

メソッド

BuildChannelFactory<TChannel>(BindingParameterCollection) BuildChannelFactory<TChannel>(BindingParameterCollection) BuildChannelFactory<TChannel>(BindingParameterCollection) BuildChannelFactory<TChannel>(BindingParameterCollection)

指定した種類のチャネルを作成し、バインド パラメーターのコレクションで指定されている機能を満たすチャネル ファクトリ スタックを、クライアント上に構築します。Builds the channel factory stack on the client that creates a specified type of channel and that satisfies the features specified by a collection of binding parameters.

(Inherited from Binding)
BuildChannelFactory<TChannel>(Object[]) BuildChannelFactory<TChannel>(Object[]) BuildChannelFactory<TChannel>(Object[]) BuildChannelFactory<TChannel>(Object[])

指定した種類のチャネルを作成し、オブジェクト配列で指定されている機能を満たすチャネル ファクトリ スタックを、クライアント上に構築します。Builds the channel factory stack on the client that creates a specified type of channel and that satisfies the features specified by an object array.

(Inherited from Binding)
BuildChannelListener<TChannel>(BindingParameterCollection) BuildChannelListener<TChannel>(BindingParameterCollection) BuildChannelListener<TChannel>(BindingParameterCollection) BuildChannelListener<TChannel>(BindingParameterCollection)

指定した種類のチャネルを受け入れ、バインド パラメーターのコレクションで指定されている機能を満たすチャネル リスナーを、サービス上に構築します。Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified by a collection of binding parameters.

(Inherited from Binding)
BuildChannelListener<TChannel>(Object[]) BuildChannelListener<TChannel>(Object[]) BuildChannelListener<TChannel>(Object[]) BuildChannelListener<TChannel>(Object[])

指定した種類のチャネルを受け入れ、指定した機能を満たすチャネル リスナーを、サービス上に構築します。Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, BindingParameterCollection)

指定した種類のチャネルを受け入れ、指定した機能を満たすチャネル リスナーを、サービス上に構築します。Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, Object[]) BuildChannelListener<TChannel>(Uri, Object[]) BuildChannelListener<TChannel>(Uri, Object[]) BuildChannelListener<TChannel>(Uri, Object[])

指定した種類のチャネルを受け入れ、指定した機能を満たすチャネル リスナーを、サービス上に構築します。Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, BindingParameterCollection)

指定した種類のチャネルを受け入れ、指定した機能を満たすチャネル リスナーを、サービス上に構築します。Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, BindingParameterCollection)

指定した種類のチャネルを受け入れ、指定した機能を満たすチャネル リスナーを、サービス上に構築します。Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[]) BuildChannelListener<TChannel>(Uri, String, ListenUriMode, Object[])

指定した種類のチャネルを受け入れ、指定した機能を満たすチャネル リスナーを、サービス上に構築します。Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
BuildChannelListener<TChannel>(Uri, String, Object[]) BuildChannelListener<TChannel>(Uri, String, Object[]) BuildChannelListener<TChannel>(Uri, String, Object[]) BuildChannelListener<TChannel>(Uri, String, Object[])

指定した種類のチャネルを受け入れ、指定した機能を満たすチャネル リスナーを、サービス上に構築します。Builds the channel listener on the service that accepts a specified type of channel and that satisfies the features specified.

(Inherited from Binding)
CanBuildChannelFactory<TChannel>(BindingParameterCollection) CanBuildChannelFactory<TChannel>(BindingParameterCollection) CanBuildChannelFactory<TChannel>(BindingParameterCollection) CanBuildChannelFactory<TChannel>(BindingParameterCollection)

指定したバインド パラメーターのコレクションを満たすチャネル ファクトリ スタックを、現在のバインドがクライアント上に構築できるかどうかを示す値を返します。Returns a value that indicates whether the current binding can build a channel factory stack on the client that satisfies the collection of binding parameters specified.

(Inherited from Binding)
CanBuildChannelFactory<TChannel>(Object[]) CanBuildChannelFactory<TChannel>(Object[]) CanBuildChannelFactory<TChannel>(Object[]) CanBuildChannelFactory<TChannel>(Object[])

オブジェクト配列で指定した要件を満たすチャネル ファクトリ スタックを、現在のバインドがクライアント上に構築できるかどうかを示す値を返します。Returns a value that indicates whether the current binding can build a channel factory stack on the client that satisfies the requirements specified by an object array.

(Inherited from Binding)
CanBuildChannelListener<TChannel>(BindingParameterCollection) CanBuildChannelListener<TChannel>(BindingParameterCollection) CanBuildChannelListener<TChannel>(BindingParameterCollection) CanBuildChannelListener<TChannel>(BindingParameterCollection)

指定したバインド パラメーターのコレクションを満たすチャネル リスナー スタックを、現在のバインドがサービス上に構築できるかどうかを示す値を返します。Returns a value that indicates whether the current binding can build a channel listener stack on the service that satisfies the collection of binding parameters specified.

(Inherited from Binding)
CanBuildChannelListener<TChannel>(Object[]) CanBuildChannelListener<TChannel>(Object[]) CanBuildChannelListener<TChannel>(Object[]) CanBuildChannelListener<TChannel>(Object[])

オブジェクトの配列で指定した条件を満たすチャネル リスナー スタックを、現在のバインドがサービス上に構築できるかどうかを示す値を返します。Returns a value that indicates whether the current binding can build a channel listener stack on the service that satisfies the criteria specified in an array of objects.

(Inherited from Binding)
CreateBindingElements() CreateBindingElements() CreateBindingElements() CreateBindingElements()

バインド用のバインド要素でコレクションを作成します。Creates a collection with the binding elements for the binding.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetProperty<T>(BindingParameterCollection) GetProperty<T>(BindingParameterCollection) GetProperty<T>(BindingParameterCollection) GetProperty<T>(BindingParameterCollection)

バインド スタックの適切な層から、要求のあった型指定されたオブジェクト (ある場合) を返します。Returns a typed object requested, if present, from the appropriate layer in the binding stack.

(Inherited from Binding)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
ShouldSerializeListenBacklog() ShouldSerializeListenBacklog() ShouldSerializeListenBacklog() ShouldSerializeListenBacklog()

ListenBacklog プロパティが既定値から変更されたためにシリアル化する必要があるかどうかを示す値を返します。Returns a value that indicates whether the ListenBacklog property has changed from its default value and should be serialized.

ShouldSerializeMaxConnections() ShouldSerializeMaxConnections() ShouldSerializeMaxConnections() ShouldSerializeMaxConnections()

MaxConnections プロパティが既定値から変更されたためにシリアル化する必要があるかどうかを示す値を返します。Returns a value that indicates whether the MaxConnections property has changed from its default value and should be serialized.

ShouldSerializeName() ShouldSerializeName() ShouldSerializeName() ShouldSerializeName()

バインドの名前をシリアル化する必要があるかどうかを示す値を返します。Returns whether the name of the binding should be serialized.

(Inherited from Binding)
ShouldSerializeNamespace() ShouldSerializeNamespace() ShouldSerializeNamespace() ShouldSerializeNamespace()

バインドの名前空間をシリアル化する必要があるかどうかを示す値を返します。Returns whether the namespace of the binding should be serialized.

(Inherited from Binding)
ShouldSerializeReaderQuotas() ShouldSerializeReaderQuotas() ShouldSerializeReaderQuotas() ShouldSerializeReaderQuotas()

ReaderQuotas プロパティが既定値から変更されたためにシリアル化する必要があるかどうかを示す値を返します。Returns a value that indicates whether the ReaderQuotas property has changed from its default value and should be serialized.

ShouldSerializeReliableSession() ShouldSerializeReliableSession() ShouldSerializeReliableSession() ShouldSerializeReliableSession()

ReliableSession プロパティが既定値から変更されたためにシリアル化する必要があるかどうかを示す値を返します。Returns a value that indicates whether the ReliableSession property has changed from its default value and should be serialized.

ShouldSerializeSecurity() ShouldSerializeSecurity() ShouldSerializeSecurity() ShouldSerializeSecurity()

Security プロパティが既定値から変更されたためにシリアル化する必要があるかどうかを示す値を返します。Returns a value that indicates whether the Security property has changed from its default value and should be serialized.

ShouldSerializeTransactionProtocol() ShouldSerializeTransactionProtocol() ShouldSerializeTransactionProtocol() ShouldSerializeTransactionProtocol()

TransactionProtocol プロパティが既定値から変更されたためにシリアル化する必要があるかどうかを示す値を返します。Returns a value that indicates whether the TransactionProtocol property has changed from its default value and should be serialized.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

明示的なインターフェイスの実装

IBindingRuntimePreferences.ReceiveSynchronously IBindingRuntimePreferences.ReceiveSynchronously IBindingRuntimePreferences.ReceiveSynchronously IBindingRuntimePreferences.ReceiveSynchronously

受信要求を同期処理するか、または非同期処理するかを示す値を取得します。Gets a value that indicates whether incoming requests are handled synchronously or asynchronously.

適用対象