IChannel インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
すべてのチャネル オブジェクトが実装する必要がある基本インターフェイスを定義します。 すべての通信オブジェクトが共有するステート マシン インターフェイスを実装し、チャネル スタックからオブジェクトを取得するためのメソッドを実装する必要があります。
public interface class IChannel : System::ServiceModel::ICommunicationObject
public interface IChannel : System.ServiceModel.ICommunicationObject
type IChannel = interface
interface ICommunicationObject
Public Interface IChannel
Implements 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) |
拡張メソッド
CloseHelperAsync(ICommunicationObject, TimeSpan) |
すべてのチャネル オブジェクトが実装する必要がある基本インターフェイスを定義します。 すべての通信オブジェクトが共有するステート マシン インターフェイスを実装し、チャネル スタックからオブジェクトを取得するためのメソッドを実装する必要があります。 |
OpenHelperAsync(ICommunicationObject, TimeSpan) |
すべてのチャネル オブジェクトが実装する必要がある基本インターフェイスを定義します。 すべての通信オブジェクトが共有するステート マシン インターフェイスを実装し、チャネル スタックからオブジェクトを取得するためのメソッドを実装する必要があります。 |
適用対象
.NET