ICommunicationObject.BeginOpen Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Zahájí asynchronní operaci otevření komunikačního objektu.
Přetížení
BeginOpen(AsyncCallback, Object) |
Zahájí asynchronní operaci otevření komunikačního objektu. |
BeginOpen(TimeSpan, AsyncCallback, Object) |
Zahájí asynchronní operaci otevření komunikačního objektu v zadaném časovém intervalu. |
Poznámky
Metoda BeginOpen způsobí, že ICommunicationObject vstoupí do Opening stavu, ve kterém zůstává, dokud se jeho přechod na Opened stav nedokončí nebo selže.
K dispozici jsou verze s explicitním vypršením časového limitu.
BeginOpen(AsyncCallback, Object)
Zahájí asynchronní operaci otevření komunikačního objektu.
public:
IAsyncResult ^ BeginOpen(AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginOpen (AsyncCallback callback, object state);
abstract member BeginOpen : AsyncCallback * obj -> IAsyncResult
Public Function BeginOpen (callback As AsyncCallback, state As Object) As IAsyncResult
Parametry
- callback
- AsyncCallback
Delegát AsyncCallback , který obdrží oznámení o dokončení asynchronní otevřené operace.
- state
- Object
Objekt určený aplikací, který obsahuje informace o stavu přidružené k asynchronní otevřené operaci.
Návraty
Odkazuje IAsyncResult na asynchronní otevřenou operaci.
Výjimky
Nepodařilo ICommunicationObject se otevřít a vstoupil do Faulted stavu.
Výchozí časový limit otevření uplynul před tím, než ICommunicationObject mohl vstoupit do Opened stavu a vstoupil do Faulted stavu.
Poznámky
ICommunicationObject Když je vytvořena instance, začíná ve Created stavu. Created Ve stavu lze objekt nakonfigurovat (například vlastnosti lze nastavit nebo lze zaregistrovat události), ale zatím není možné posílat nebo přijímat zprávy. Metoda BeginOpen způsobí ICommunicationObject vstup do Opening stavu, ve kterém zůstává, dokud otevřená operace nebude úspěšná, vyprší časový limit operace otevření nebo selže a objekt se stane chybným nebo ICommunicationObject je přerušen.
Opened Ve stavu ICommunicationObject je použitelné (například zprávy mohou být přijaty), ale už není konfigurovatelné.
Platí pro
BeginOpen(TimeSpan, AsyncCallback, Object)
Zahájí asynchronní operaci otevření komunikačního objektu v zadaném časovém intervalu.
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 -> IAsyncResult
Public Function BeginOpen (timeout As TimeSpan, callback As AsyncCallback, state As Object) As IAsyncResult
Parametry
- timeout
- TimeSpan
Určuje TimeSpan , jak dlouho se má operace odesílání dokončit před uplynutím časového limitu.
- callback
- AsyncCallback
Delegát AsyncCallback , který obdrží oznámení o dokončení asynchronní otevřené operace.
- state
- Object
Objekt určený aplikací, který obsahuje informace o stavu přidružené k asynchronní otevřené operaci.
Návraty
Odkazuje IAsyncResult na asynchronní otevřenou operaci.
Výjimky
Nepodařilo ICommunicationObject se otevřít a vstoupil do Faulted stavu.
Zadaný časový limit uplynul před tím, než ICommunicationObject byl schopen vstoupit do Opened stavu a vstoupil do Faulted stavu.
Poznámky
ICommunicationObject Když je vytvořena instance, začíná ve Created stavu. Created Ve stavu lze objekt nakonfigurovat (například vlastnosti lze nastavit nebo lze zaregistrovat události), ale zatím není možné posílat nebo přijímat zprávy. Metoda Open způsobí ICommunicationObject vstup do Opening stavu, ve kterém zůstává, dokud otevřená operace nebude úspěšná, vyprší časový limit operace otevření nebo selže a objekt se stane chybným nebo ICommunicationObject je přerušen.
Opened Ve stavu ICommunicationObject je použitelné (například zprávy mohou být přijaty), ale už není konfigurovatelné.
Poznámky pro implementátory
Operace musí vyvolat TimeoutException výjimku, pokud je zadaná hodnota timeout
překročena.