IChannel インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
すべてのチャネル オブジェクトが実装する必要がある基本的なインターフェイスを定義します。 すべての通信オブジェクトによって共有されるステート マシン インターフェイスを実装し、チャネル スタックからオブジェクトを取得するメソッドを実装する必要があります。
public interface class IChannel : System::ServiceModel::ICommunicationObjectpublic interface IChannel : System.ServiceModel.ICommunicationObjecttype IChannel = interface
interface ICommunicationObjectPublic Interface IChannel
Implements ICommunicationObject- 派生
- 実装
注釈
Important
信頼されていないデータを使用してこのインターフェイスを実装するクラスからメソッドを呼び出すことは、セキュリティ上のリスクです。 信頼されたデータでのみこのインターフェイスを実装するクラスからメソッドを呼び出します。 詳細については、「すべての入力を検証する」を参照してください。
チャネルは、 ICommunicationObject インターフェイスで定義されているステート マシンのコントラクトを満たす必要があります。
IChannel インターフェイスは、
GetProperty メソッドを ICommunicationObject インターフェイスに追加します。 このメソッドは、スタック内の場所に関係なく、チャネル スタックからプロパティを取得するためのメカニズムを提供します。 メソッド名の "property" という用語は、スタック内のいずれかのチャネルに属する情報を指します。 そのプロパティの CLR 型は、 Tによって決まります。 この取得方法は、チャネル ファクトリとチャネル リスナーでも使用されます。
IChannel は、基本的なメッセージ交換パターンに関連付けられている各チャネル インターフェイスによって継承されます。
IInputChannel メッセージを受信します。
IOutputChannel メッセージを送信するための〘。
IRequestChannel 要求を送信します。
IReplyChannel 応答を送信する場合は 〗。
IDuplexChannel 双方向メッセージング用。
プロパティ
| 名前 | 説明 |
|---|---|
| State |
通信指向オブジェクトの現在の状態を取得します。 (継承元 ICommunicationObject) |
メソッド
| 名前 | 説明 |
|---|---|
| Abort() |
通信オブジェクトを現在の状態から閉じた状態に直ちに遷移させます。 (継承元 ICommunicationObject) |
| BeginClose(AsyncCallback, Object) |
通信オブジェクトを閉じる非同期操作を開始します。 (継承元 ICommunicationObject) |
| BeginClose(TimeSpan, AsyncCallback, Object) |
指定したタイムアウトで通信オブジェクトを閉じる非同期操作を開始します。 (継承元 ICommunicationObject) |
| BeginOpen(AsyncCallback, Object) |
通信オブジェクトを開く非同期操作を開始します。 (継承元 ICommunicationObject) |
| BeginOpen(TimeSpan, AsyncCallback, Object) |
指定した時間内に通信オブジェクトを開く非同期操作を開始します。 (継承元 ICommunicationObject) |
| Close() |
通信オブジェクトを現在の状態から閉じた状態に遷移させます。 (継承元 ICommunicationObject) |
| Close(TimeSpan) |
通信オブジェクトを現在の状態から閉じた状態に遷移させます。 (継承元 ICommunicationObject) |
| EndClose(IAsyncResult) |
通信オブジェクトを閉じる非同期操作を完了します。 (継承元 ICommunicationObject) |
| EndOpen(IAsyncResult) |
通信オブジェクトを開く非同期操作を完了します。 (継承元 ICommunicationObject) |
| GetProperty<T>() |
チャネル スタック内の適切なレイヤーから、要求された型指定されたオブジェクト (存在する場合) を返します。 |
| Open() |
通信オブジェクトが作成された状態から開かれた状態に遷移します。 (継承元 ICommunicationObject) |
| Open(TimeSpan) |
指定した時間内に、通信オブジェクトが作成された状態から開かれた状態に遷移します。 (継承元 ICommunicationObject) |
イベント
| 名前 | 説明 |
|---|---|
| Closed |
通信オブジェクトが終了状態から閉じた状態への遷移を完了したときに発生します。 (継承元 ICommunicationObject) |
| Closing |
通信オブジェクトが最初に終了状態になったときに発生します。 (継承元 ICommunicationObject) |
| Faulted |
通信オブジェクトが最初に障害状態になったときに発生します。 (継承元 ICommunicationObject) |
| Opened |
通信オブジェクトが開始状態から開かれた状態への遷移を完了したときに発生します。 (継承元 ICommunicationObject) |
| Opening |
通信オブジェクトが最初に開始状態になったときに発生します。 (継承元 ICommunicationObject) |
