ICommunicationObject.Open ICommunicationObject.Open ICommunicationObject.Open ICommunicationObject.Open Method

定義

通信オブジェクトを、Created 状態から Opened 状態に遷移させます。Causes a communication object to transition from the created state into the opened state.

オーバーロード

Open() Open() Open() Open()

通信オブジェクトを、Created 状態から Opened 状態に遷移させます。Causes a communication object to transition from the created state into the opened state.

Open(TimeSpan) Open(TimeSpan) Open(TimeSpan) Open(TimeSpan)

指定した時間内で、通信オブジェクトを Created 状態から Opened 状態に遷移させます。Causes a communication object to transition from the created state into the opened state within a specified interval of time.

注釈

明示的なタイムアウトを持つバージョンと持たないバージョンが提供されます。Versions with and without an explicit timeout are provided.

Open() Open() Open() Open()

通信オブジェクトを、Created 状態から Opened 状態に遷移させます。Causes a communication object to transition from the created state into the opened state.

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

例外

ICommunicationObject が開きません。Faulted 状態に遷移しました。The ICommunicationObject was unable to be opened and has entered the Faulted state.

ICommunicationObjectOpened 状態に入る前に既定の open タイムアウトが経過しました。Faulted 状態に遷移しました。The default open timeout elapsed before the ICommunicationObject was able to enter the Opened state and has entered the Faulted state.

注釈

ICommunicationObject がインスタンス化されると、Created 状態で開始します。When an ICommunicationObject is instantiated, it begins in the Created state. Created 状態の場合、オブジェクトを構成する (プロパティの設定やイベントの登録など) ことはできますが、メッセージの送受信にはまだ使用できません。In the Created state, the object can be configured (for example, properties can be set, or events can be registered), but it is not yet usable to send or receive messages. Open メソッドは、ICommunicationObjectOpening 状態に遷移させ、オープン操作が完了するまでその状態を保ちます。オープン操作がタイムアウトするか失敗すると、オブジェクトがエラーになる、または ICommunicationObject が中止されます。The Open method causes an ICommunicationObject to enter into the Opening state where it remains until the open operation succeeds, the open operation times out or fails and the object becomes faulted, or the ICommunicationObject is aborted.

Opened 状態では、ICommunicationObject は使用可能ですが (たとえば、メッセージは受信できます)、構成可能ではなくなります。In the Opened state, the ICommunicationObject is usable (for example, messages can be received), but it is no longer configurable.

また、非同期バージョンの open メソッドがあります。これは、BeginOpen の呼び出しで開始され、EndOpen(IAsyncResult) の呼び出しで完了します。There is also an asynchronous version of the open method that is initiated by calling BeginOpen and completed by calling EndOpen(IAsyncResult).

Open(TimeSpan) Open(TimeSpan) Open(TimeSpan) Open(TimeSpan)

指定した時間内で、通信オブジェクトを Created 状態から Opened 状態に遷移させます。Causes a communication object to transition from the created state into the opened state within a specified interval of time.

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

パラメーター

timeout
TimeSpan TimeSpan TimeSpan TimeSpan

送信操作を完了する必要がある、タイムアウトまでの制限時間を指定する TimeSpanThe TimeSpan that specifies how long the send operation has to complete before timing out.

例外

ICommunicationObject が開きません。Faulted 状態に遷移しました。The ICommunicationObject was unable to be opened and has entered the Faulted state.

ICommunicationObjectOpened 状態に入る前に指定したタイムアウトが経過しました。Faulted 状態に遷移しました。The specified timeout elapsed before the ICommunicationObject was able to enter the Opened state and has entered the Faulted state.

注釈

ICommunicationObject がインスタンス化されると、Created 状態で開始します。When an ICommunicationObject is instantiated, it begins in the Created state. Created 状態の場合、オブジェクトを構成する (プロパティの設定やイベントの登録など) ことはできますが、メッセージの送受信にはまだ使用できません。In the Created state, the object can be configured (for example, properties can be set, or events can be registered), but it is not yet usable to send or receive messages. Open メソッドは、ICommunicationObjectOpening 状態に遷移させ、オープン操作が完了するまでその状態を保ちます。オープン操作がタイムアウトするか失敗すると、オブジェクトがエラーになる、または ICommunicationObject が中止されます。The Open method causes an ICommunicationObject to enter into the Opening state where it remains until the open operation succeeds, the open operation times out or fails and the object becomes faulted, or the ICommunicationObject is aborted.

Opened 状態では、ICommunicationObject は使用可能ですが (たとえば、メッセージは受信できます)、構成可能ではなくなります。In the Opened state, the ICommunicationObject is usable (for example, messages can be received), but it is no longer configurable.

また、非同期バージョンの open メソッドがあります。これは、BeginOpen の呼び出しで開始され、EndOpen(IAsyncResult) の呼び出しで完了します。There is also an asynchronous version of the open method that is initiated by calling BeginOpen and completed by calling EndOpen(IAsyncResult).

注意 (実装者)

この操作では指定の TimeoutException を超えた場合に timeout をスローする必要があります。The operation must throw a TimeoutException if the specified timeout is exceeded.

適用対象