ICommunicationObject.Open メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
通信オブジェクトが作成された状態から開かれた状態に遷移します。
オーバーロード
| 名前 | 説明 |
|---|---|
| Open() |
通信オブジェクトが作成された状態から開かれた状態に遷移します。 |
| Open(TimeSpan) |
指定した時間内に、通信オブジェクトが作成された状態から開かれた状態に遷移します。 |
注釈
明示的なタイムアウトの有無にかかわらず、バージョンが提供されます。
Open()
通信オブジェクトが作成された状態から開かれた状態に遷移します。
public:
void Open();public void Open();abstract member Open : unit -> unitPublic Sub Open ()例外
ICommunicationObjectを開けず、Faulted状態になりました。
ICommunicationObjectがOpened状態に入り、Faulted状態に入る前に、既定のオープン タイムアウトが経過しました。
注釈
ICommunicationObjectがインスタンス化されると、Created状態で開始されます。 Created状態では、オブジェクトを構成できますが (プロパティを設定したり、イベントを登録したりできます)、メッセージの送受信はまだ使用できません。 Open メソッドを使用すると、ICommunicationObjectがOpening状態になり、開いている操作が成功するか、開いている操作がタイムアウトするか失敗し、オブジェクトがエラーになるか、ICommunicationObjectが中止されるまで保持されます。
Opened状態では、ICommunicationObjectは使用できますが (メッセージを受信できる場合など)、構成できなくなります。
BeginOpenを呼び出して開始され、EndOpen(IAsyncResult)を呼び出して完了する open メソッドの非同期バージョンもあります。
適用対象
Open(TimeSpan)
指定した時間内に、通信オブジェクトが作成された状態から開かれた状態に遷移します。
public:
void Open(TimeSpan timeout);public void Open(TimeSpan timeout);abstract member Open : TimeSpan -> unitPublic Sub Open (timeout As TimeSpan)パラメーター
例外
ICommunicationObjectを開けず、Faulted状態になりました。
指定されたタイムアウトは、 ICommunicationObject が Opened 状態に入り、 Faulted 状態に入る前に経過しました。
注釈
ICommunicationObjectがインスタンス化されると、Created状態で開始されます。 Created状態では、オブジェクトを構成できますが (プロパティを設定したり、イベントを登録したりできます)、メッセージの送受信はまだ使用できません。 Open メソッドを使用すると、ICommunicationObjectがOpening状態になり、開いている操作が成功するか、開いている操作がタイムアウトするか失敗し、オブジェクトがエラーになるか、ICommunicationObjectが中止されるまで保持されます。
Opened状態では、ICommunicationObjectは使用できますが (メッセージを受信できる場合など)、構成できなくなります。
BeginOpenを呼び出して開始され、EndOpen(IAsyncResult)を呼び出して完了する open メソッドの非同期バージョンもあります。
注意 (実装者)
指定したTimeoutExceptionを超えた場合、操作はtimeoutをスローする必要があります。
