IChannel インターフェイス

定義

名前空間:

System.ServiceModel.Channels

アセンブリ:

System.ServiceModel.Primitives.dll

アセンブリ:

System.ServiceModel.dll

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

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.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)

events

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