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