ICommunicationObject.BeginOpen Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu öffnen.
Überlädt
| BeginOpen(AsyncCallback, Object) |
Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu öffnen. |
| BeginOpen(TimeSpan, AsyncCallback, Object) |
Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt innerhalb eines festgelegten Zeitraums zu öffnen. |
Hinweise
Die BeginOpen Methode verursacht einen ICommunicationObject Einstieg in den Opening Zustand, in dem Opened er bleibt, bis der Übergang zum Zustand abgeschlossen ist oder fehlschlägt.
Versionen mit und ohne explizites Timeout werden bereitgestellt.
BeginOpen(AsyncCallback, Object)
Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt zu öffnen.
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 IAsyncResultParameter
- callback
- AsyncCallback
Der AsyncCallback-Delegat, der die Benachrichtigung erhält, dass der asynchrone Öffnungsvorgang abgeschlossen wurde.
- state
- Object
Ein durch die Anwendung festgelegtes Objekt, das dem asynchronen Öffnungsvorgang zugeordnete Zustandsinformationen enthält.
Gibt zurück
Der IAsyncResult-Wert, der auf den asynchronen Öffnungsvorgang verweist.
Ausnahmen
ICommunicationObject kann nicht geöffnet werden und hat den Faulted-Zustand angenommen.
Das standardmäßige Öffnungstimeout ist verstrichen, bevor ICommunicationObject den Opened-Zustand annehmen konnte. Es hat jetzt den Faulted-Zustand.
Hinweise
Wenn ein ICommunicationObject Instanziiert wird, beginnt er im Created Zustand. Im Created-Zustand kann das Objekt konfiguriert werden (so können beispielsweise Eigenschaften eingerichtet oder Ereignisse registriert werden), es kann jedoch noch nicht zum Versenden und Empfangen von Nachrichten verwendet werden. Die BeginOpen Methode führt ICommunicationObject dazu, dass eine Eingabe in den Opening Zustand erfolgt, in dem es bleibt, bis der geöffnete Vorgang erfolgreich verläuft, der geöffnete Vorgang ausfällt oder fehlschlägt und das Objekt fehlschlägt, oder das ICommunicationObject Objekt wird abgebrochen.
Opened Im Zustand ist die ICommunicationObject Verwendung (z. B. Nachrichten können empfangen werden), aber es ist nicht mehr konfigurierbar.
Gilt für
BeginOpen(TimeSpan, AsyncCallback, Object)
Startet einen asynchronen Vorgang, um ein Kommunikationsobjekt innerhalb eines festgelegten Zeitraums zu öffnen.
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 IAsyncResultParameter
- timeout
- TimeSpan
Der TimeSpan-Wert, der angibt, welcher Zeitraum für den Sendevorgang bleibt, bevor ein Timeout eintritt.
- callback
- AsyncCallback
Der AsyncCallback-Delegat, der die Benachrichtigung erhält, dass der asynchrone Öffnungsvorgang abgeschlossen wurde.
- state
- Object
Ein durch die Anwendung festgelegtes Objekt, das dem asynchronen Öffnungsvorgang zugeordnete Zustandsinformationen enthält.
Gibt zurück
Der IAsyncResult-Wert, der auf den asynchronen Öffnungsvorgang verweist.
Ausnahmen
ICommunicationObject kann nicht geöffnet werden und hat den Faulted-Zustand angenommen.
Das festgelegte Timeout ist verstrichen, bevor ICommunicationObject den Opened-Zustand annehmen konnte. Es weist jetzt den Faulted-Zustand auf.
Hinweise
Wenn ein ICommunicationObject Instanziiert wird, beginnt er im Created Zustand. Im Created-Zustand kann das Objekt konfiguriert werden (so können beispielsweise Eigenschaften eingerichtet oder Ereignisse registriert werden), es kann jedoch noch nicht zum Versenden und Empfangen von Nachrichten verwendet werden. Die Open Methode führt ICommunicationObject dazu, dass eine Eingabe in den Opening Zustand erfolgt, in dem es bleibt, bis der geöffnete Vorgang erfolgreich verläuft, der geöffnete Vorgang ausfällt oder fehlschlägt und das Objekt fehlschlägt, oder das ICommunicationObject Objekt wird abgebrochen.
Opened Im Zustand ist die ICommunicationObject Verwendung (z. B. Nachrichten können empfangen werden), aber es ist nicht mehr konfigurierbar.
Hinweise für Ausführende
Der Vorgang muss einen TimeoutException Auslösen, wenn der angegebene timeout Wert überschritten wird.