NetTcpBinding クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
複数コンピューターの通信に適した、セキュリティで保護された信頼できるバインドです。
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
- 継承
- 派生
- 実装
例
この例では、セキュリティ モードとトランスポート資格情報の種類を NetTcpBinding設定する 、を作成する方法を示します。
NetTcpBinding binding = new NetTcpBinding();
binding.Security.Mode = SecurityMode.Transport;
binding.Security.Transport.ClientCredentialType = TcpClientCredentialType.Certificate;
注釈
既定 NetTcpBinding では、トランスポート セキュリティ、メッセージ配信に TCP、バイナリ メッセージ エンコードを使用するランタイム通信スタックが生成されます。 このバインディングは、イントラネット経由での通信に適した Windows Communication Foundation (WCF) システム提供の選択肢です。
NetTcpBinding の既定の構成は、WSHttpBinding で提供される構成より高速ですが、これは WCF 通信のみを目的としたものです。 セキュリティ動作は、コンストラクターの省略可能な securityMode
パラメーターを使用して設定できます。 WS-ReliableMessaging を使用するかどうかは、省略可能な reliableSessionEnabled
パラメーターを使用して設定できます。 ただし、信頼できるメッセージングは、既定ではオフです。 WSHttpBinding や BasicHttpBinding などの HTTP システム指定のバインディングは、既定では設定をオンにするように構成され、NetTcpBinding バインディングは、既定では設定をオフにするように構成されているのが一般的であるため、たとえば、いずれかの WS-* 仕様のサポートを得るには、サポートを選択する必要があります。 これは、TCP の既定の構成の方が、HTTP バインド用の既定の構成より、エンドポイント間でのメッセージ交換が高速になることを意味します。
警告
サービスの NetTcpBinding ホスト DNS 名とサービスがリッスンしているポート番号に基づいて TCP 接続プールを使用します。 これは、クライアントが異なるポートで異なるサービスを呼び出す場合、またはサービスが 1 つのプロセスでホストされ、ポートを共有する場合に適切に機能します。 1 つのクライアントが、異なるプロセスでホストされているポート、または WAS/IIS でホストされているポートを共有する複数のサービスを呼び出す場合、クライアント側のプールによって、サービス A への接続がサービス 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 |
受信要求を同期処理するか、または非同期処理するかを示す値を取得します。 |