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