ICommunicationObject.Open メソッド

定義

通信オブジェクトを、Created 状態から Opened 状態に遷移させます。

オーバーロード

Open()

通信オブジェクトを、Created 状態から Opened 状態に遷移させます。

Open(TimeSpan)

指定した時間内で、通信オブジェクトを Created 状態から Opened 状態に遷移させます。

注釈

明示的なタイムアウトを持つバージョンと持たないバージョンが提供されます。

Open()

Source:
ICommunicationObject.cs
Source:
ICommunicationObject.cs
Source:
ICommunicationObject.cs

通信オブジェクトを、Created 状態から Opened 状態に遷移させます。

public:
 void Open();
public void Open ();
abstract member Open : unit -> unit
Public Sub Open ()

例外

ICommunicationObject が開きません。Faulted 状態に遷移しました。

ICommunicationObjectOpened 状態に入る前に既定の open タイムアウトが経過しました。Faulted 状態に遷移しました。

注釈

ICommunicationObjectがインスタンス化されると、状態でCreated開始されます。 Created 状態の場合、オブジェクトを構成する (プロパティの設定やイベントの登録など) ことはできますが、メッセージの送受信にはまだ使用できません。 メソッドICommunicationObjectOpen、開いている操作が成功するか、開いている操作がタイムアウトまたは失敗し、オブジェクトがエラーになるか、または ICommunicationObject が中止されるまで、 が残っている状態に入Openingります。

状態では OpenedICommunicationObject は使用可能ですが (たとえば、メッセージを受信できます)、構成できなくなります。

また、非同期バージョンの open メソッドがあります。これは、BeginOpen の呼び出しで開始され、EndOpen(IAsyncResult) の呼び出しで完了します。

適用対象

Open(TimeSpan)

Source:
ICommunicationObject.cs
Source:
ICommunicationObject.cs
Source:
ICommunicationObject.cs

指定した時間内で、通信オブジェクトを Created 状態から Opened 状態に遷移させます。

public:
 void Open(TimeSpan timeout);
public void Open (TimeSpan timeout);
abstract member Open : TimeSpan -> unit
Public Sub Open (timeout As TimeSpan)

パラメーター

timeout
TimeSpan

送信操作を完了する必要がある、タイムアウトまでの制限時間を指定する TimeSpan

例外

ICommunicationObject が開きません。Faulted 状態に遷移しました。

ICommunicationObjectOpened 状態に入る前に指定したタイムアウトが経過しました。Faulted 状態に遷移しました。

注釈

ICommunicationObjectがインスタンス化されると、状態でCreated開始されます。 Created 状態の場合、オブジェクトを構成する (プロパティの設定やイベントの登録など) ことはできますが、メッセージの送受信にはまだ使用できません。 メソッドICommunicationObjectOpen、開いている操作が成功するか、開いている操作がタイムアウトまたは失敗し、オブジェクトがエラーになるか、または ICommunicationObject が中止されるまで、 が残っている状態に入Openingります。

状態では OpenedICommunicationObject は使用可能ですが (たとえば、メッセージを受信できます)、構成できなくなります。

また、非同期バージョンの open メソッドがあります。これは、BeginOpen の呼び出しで開始され、EndOpen(IAsyncResult) の呼び出しで完了します。

注意 (実装者)

指定した timeout を超えた場合、操作は をTimeoutExceptionスローする必要があります。

適用対象