IChannel インターフェイス

定義

名前空間:

System.ServiceModel.Channels

アセンブリ:

System.ServiceModel.Primitives.dll

パッケージ:

System.ServiceModel.Primitives v8.0.0

すべてのチャネル オブジェクトが実装する必要がある基本インターフェイスを定義します。 すべての通信オブジェクトが共有するステート マシン インターフェイスを実装し、チャネル スタックからオブジェクトを取得するためのメソッドを実装する必要があります。

public interface class IChannel : System::ServiceModel::ICommunicationObject

public interface IChannel : System.ServiceModel.ICommunicationObject

type IChannel = interface
    interface ICommunicationObject

Public Interface IChannel
Implements ICommunicationObject

派生

System.ServiceModel.Channels.ChannelBase

System.ServiceModel.Channels.IDuplexChannel

System.ServiceModel.Channels.IDuplexSessionChannel

System.ServiceModel.Channels.IInputChannel

System.ServiceModel.Channels.IInputSessionChannel

System.ServiceModel.Channels.IOutputChannel

System.ServiceModel.Channels.IOutputSessionChannel

System.ServiceModel.Channels.IReplyChannel

System.ServiceModel.Channels.IReplySessionChannel

System.ServiceModel.Channels.IRequestChannel

System.ServiceModel.Channels.IRequestSessionChannel

System.ServiceModel.ClientBase<TChannel>.ChannelBase<T>

System.ServiceModel.Federation.WSTrustChannel

System.ServiceModel.IClientChannel

System.ServiceModel.IContextChannel

System.ServiceModel.IDuplexContextChannel

System.ServiceModel.IServiceChannel

System.ServiceModel.Security.WSTrustChannel

実装

ICommunicationObject

注釈

重要

このインターフェイスを実装するクラスのメソッドの呼び出しを信頼されていないデータを指定して実行することは、セキュリティ上のリスクが伴います。 このインターフェイスを実装するクラスのメソッドの呼び出しは、信頼されたデータだけを指定して実行してください。 詳細については、「 すべての入力を検証する」を参照してください。

チャネルは、ICommunicationObject インターフェイスで定義されているステート マシンのコントラクトを満たす必要があります。

IChannel インターフェイスは、

GetProperty メソッドをインターフェイスに追加 ICommunicationObject します。 このメソッドは、スタック内でプロパティが存在する場所に関係なく、チャネル スタックからプロパティを取得するためのメカニズムを提供します。 メソッド名に含まれる "property" という言葉は、スタック内のいずれかのチャネルに属するなんらかの情報を指します。 そのプロパティに対する CLR 型は、T によって決まります。 この取得メソッドは、チャネル ファクトリやチャネル リスナーに対しても使用できます。

IChannel は、基本的なメッセージ交換パターンに関連付けられている各チャネル インターフェイスによって継承されます。

• メッセージ受信用の IInputChannel。

• IOutputChannel メッセージを送信するための。

• IRequestChannel 要求を送信する場合は 。

• 応答送信用の IReplyChannel。

• IDuplexChannel 双方向メッセージング用。

プロパティ

State

通信指向オブジェクトの現在の状態を取得します。 (継承元 ICommunicationObject)

メソッド

Abort()	通信オブジェクトを、現在の状態から Closed 状態に直ちに遷移させます。 (継承元 ICommunicationObject)
BeginClose(AsyncCallback, Object)	通信オブジェクトをクローズするための非同期操作を開始します。 (継承元 ICommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	タイムアウトを指定して、通信オブジェクトをクローズするための非同期操作を開始します。 (継承元 ICommunicationObject)
BeginOpen(AsyncCallback, Object)	通信オブジェクトを開くための非同期操作を開始します。 (継承元 ICommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	指定した時間内で通信オブジェクトを開くための非同期操作を開始します。 (継承元 ICommunicationObject)
Close()	通信オブジェクトを、現在の状態から Closed 状態に遷移させます。 (継承元 ICommunicationObject)
Close(TimeSpan)	通信オブジェクトを、現在の状態から Closed 状態に遷移させます。 (継承元 ICommunicationObject)
EndClose(IAsyncResult)	通信オブジェクトをクローズするための非同期操作を完了します。 (継承元 ICommunicationObject)
EndOpen(IAsyncResult)	通信オブジェクトを開くための非同期操作を完了します。 (継承元 ICommunicationObject)
GetProperty<T>()	チャネル スタックの適切な層から、要求のあった型指定されたオブジェクト (ある場合) を返します。
Open()	通信オブジェクトを、Created 状態から Opened 状態に遷移させます。 (継承元 ICommunicationObject)
Open(TimeSpan)	指定した時間内で、通信オブジェクトを Created 状態から Opened 状態に遷移させます。 (継承元 ICommunicationObject)

イベント

Closed	通信オブジェクトが、Closing 状態から Closed 状態への通信状態の遷移を完了したときに発生します。 (継承元 ICommunicationObject)
Closing	通信オブジェクトが初めて Closing 状態に遷移するときに発生します。 (継承元 ICommunicationObject)
Faulted	通信オブジェクトが初めて Faulted 状態に遷移するときに発生します。 (継承元 ICommunicationObject)
Opened	通信オブジェクトが、Opening 状態から Opened 状態への通信状態の遷移を完了したときに発生します。 (継承元 ICommunicationObject)
Opening	通信オブジェクトが初めて Opening 状態に遷移するときに発生します。 (継承元 ICommunicationObject)