NetTcpBinding クラス

定義

名前空間:: System.ServiceModel

アセンブリ:: System.ServiceModel.dll, System.ServiceModel.NetTcp.dll

アセンブリ:: System.ServiceModel.NetTcp.dll

アセンブリ:: System.ServiceModel.dll

パッケージ:: System.ServiceModel.NetTcp v10.0.652802, System.ServiceModel.Primitives v10.0.652802

パッケージ:: System.ServiceModel.NetTcp v10.0.652802

ソース:: NetTcpBinding.cs

ソース:: NetTcpBinding.cs

ソース:: NetTcpBinding.cs

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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

継承: 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) システム提供の選択肢です。

NetTcpBindingの既定の構成は、WSHttpBindingによって提供される構成よりも高速ですが、WCF 通信のみを対象としています。セキュリティ動作は、コンストラクターの省略可能な securityMode パラメーターを使用して構成できます。 WS-ReliableMessaging の使用は、省略可能な reliableSessionEnabled パラメーターを使用して構成できます。ただし、信頼できるメッセージングは既定ではオフになっています。より一般的には、 WSHttpBinding や BasicHttpBinding などの HTTP システムによって提供されるバインディングは既定でオンになるように構成されますが、 NetTcpBinding バインドでは既定でオフになるため、WS-* 仕様の 1 つなど、サポートを受けるためにオプトインする必要があります。つまり、TCP の既定の構成では、既定で HTTP バインド用に構成された構成よりも、エンドポイント間でメッセージを交換する方が高速です。

Warning

NetTcpBindingは、サービスのホスト DNS 名とサービスがリッスンしているポート番号に基づいて TCP 接続プールを使用します。これは、クライアントが異なるポートで異なるサービスを呼び出す場合、またはサービスが 1 つのプロセスでホストされ、ポートを共有する場合に適切に機能します。 1 つのクライアントが、異なるプロセスでホストされているポート、または WAS/IIS でホストされているポートを共有する複数のサービスを呼び出すと、クライアント側のプーリングによって、サービス A への接続がサービス B に再利用され、例外がスローされ、接続が中止され、新しいチャネルが作成されるという問題が発生する可能性があります。この問題を回避するには、CustomBinding を使用し、クライアントが通信するサービスごとに異なる ConnectionPoolSettings.GroupName を指定します。

コンストラクター

名前	説明
NetTcpBinding()	NetTcpBinding クラスの新しいインスタンスを初期化します。
NetTcpBinding(SecurityMode, Boolean)	指定したセキュリティの種類と、信頼できるセッションが明示的に有効になっているかどうかを示す値を使用して、 NetTcpBinding クラスの新しいインスタンスを初期化します。
NetTcpBinding(SecurityMode)	指定したセキュリティの種類を使用して、 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	受信要求が同期的または非同期的に処理されるかどうかを示す値を取得します。

適用対象

フィードバック

このページはお役に立ちましたか?