ICommunicationObject.Open 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í.
Způsobí přechod komunikačního objektu z vytvořeného stavu do otevřeného stavu.
Přetížení
Open() |
Způsobí přechod komunikačního objektu z vytvořeného stavu do otevřeného stavu. |
Open(TimeSpan) |
Způsobí přechod komunikačního objektu z vytvořeného stavu do otevřeného stavu v zadaném časovém intervalu. |
Poznámky
K dispozici jsou verze s explicitním vypršením časového limitu.
Open()
Způsobí přechod komunikačního objektu z vytvořeného stavu do otevřeného stavu.
public:
void Open();
public void Open ();
abstract member Open : unit -> unit
Public Sub Open ()
Výjimky
Nepodařilo ICommunicationObject se otevřít a vstoupil do Faulted stavu.
Výchozí časový limit otevřeného časového limitu ICommunicationObject uplynul před tím, než bylo možné zadat Opened stav a zadal Faulted stav.
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 zaregistrovat události), ale zatím není možné odesílat nebo přijímat zprávy. Metoda Open způsobí ICommunicationObject , že vstoupí do Opening stavu, kde zůstane, dokud otevřená operace nebude úspěšná, doba otevření operace vyprší nebo selže a objekt bude chybný nebo ICommunicationObject je přerušen.
Opened Ve stavu ICommunicationObject je použitelné (například zprávy lze přijímat), ale už není konfigurovatelné.
Existuje také asynchronní verze otevřené metody, která je iniciovaná voláním BeginOpen a dokončením volání EndOpen(IAsyncResult).
Platí pro
Open(TimeSpan)
Způsobí přechod komunikačního objektu z vytvořeného stavu do otevřeného stavu v zadaném časovém intervalu.
public:
void Open(TimeSpan timeout);
public void Open (TimeSpan timeout);
abstract member Open : TimeSpan -> unit
Public Sub Open (timeout As TimeSpan)
Parametry
- timeout
- TimeSpan
Určuje TimeSpan , jak dlouho se má operace odesílání dokončit před uplynutím časového limitu.
Výjimky
Nepodařilo ICommunicationObject se otevřít a vstoupil do Faulted stavu.
Zadaný časový limit uplynul před tím, než ICommunicationObject mohl vstoupit Opened do stavu a vstoupil do Faulted stavu.
Poznámky
Když dojde k ICommunicationObject vytvoření instance, začne ve Created stavu. Created Ve stavu lze objekt nakonfigurovat (například vlastnosti lze nastavit nebo zaregistrovat události), ale zatím není možné odesílat nebo přijímat zprávy. Metoda Open způsobí ICommunicationObject , že vstoupí do Opening stavu, kde zůstane, dokud otevřená operace nebude úspěšná, doba otevření operace vyprší nebo selže a objekt bude chybný nebo ICommunicationObject je přerušen.
Opened Ve stavu ICommunicationObject je použitelné (například zprávy lze přijímat), ale už není konfigurovatelné.
Existuje také asynchronní verze otevřené metody, která je iniciovaná voláním BeginOpen a dokončením volání EndOpen(IAsyncResult).
Poznámky pro implementátory
Operace musí vyvolat TimeoutException , pokud je zadaná timeout
hodnota překročena.