ICommunicationObject.Open Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Zorgt ervoor dat een communicatieobject wordt overgezet van de gemaakte status in de geopende status.
Overloads
| Name | Description |
|---|---|
| Open() |
Zorgt ervoor dat een communicatieobject wordt overgezet van de gemaakte status in de geopende status. |
| Open(TimeSpan) |
Zorgt ervoor dat een communicatieobject binnen een opgegeven tijdsinterval van de gemaakte status overgaat naar de geopende status. |
Opmerkingen
Versies met en zonder expliciete time-out worden geleverd.
Open()
Zorgt ervoor dat een communicatieobject wordt overgezet van de gemaakte status in de geopende status.
public:
void Open();
public void Open();
abstract member Open : unit -> unit
Public Sub Open ()
Uitzonderingen
Kan ICommunicationObject de status niet openen en heeft de Faulted status opgegeven.
De standaardtime-out voor openen is verstreken voordat de ICommunicationObject status kon worden ingevoerd Opened en de Faulted status is ingevoerd.
Opmerkingen
Wanneer een ICommunicationObject instantie wordt geïnstantieerd, begint deze in de Created status. In de Created status kan het object worden geconfigureerd (bijvoorbeeld eigenschappen kunnen worden ingesteld of gebeurtenissen kunnen worden geregistreerd), maar het is nog niet bruikbaar om berichten te verzenden of te ontvangen. De Open methode zorgt ervoor dat er ICommunicationObjectOpening een status wordt ingevoerd waarin deze blijft totdat de geopende bewerking is geslaagd, er een time-out optreedt of mislukt en het object mislukt of het ICommunicationObject object wordt afgebroken.
Opened De status ICommunicationObject is bruikbaar (bijvoorbeeld berichten kunnen worden ontvangen), maar kan niet meer worden geconfigureerd.
Er is ook een asynchrone versie van de open methode die wordt gestart door aanroepen en voltooid door aanroepen BeginOpenEndOpen(IAsyncResult).
Van toepassing op
Open(TimeSpan)
Zorgt ervoor dat een communicatieobject binnen een opgegeven tijdsinterval van de gemaakte status overgaat naar de geopende status.
public:
void Open(TimeSpan timeout);
public void Open(TimeSpan timeout);
abstract member Open : TimeSpan -> unit
Public Sub Open (timeout As TimeSpan)
Parameters
- timeout
- TimeSpan
Hiermee TimeSpan geeft u op hoe lang de verzendbewerking moet worden voltooid voordat er een time-out optreedt.
Uitzonderingen
Kan ICommunicationObject de status niet openen en heeft de Faulted status opgegeven.
De opgegeven time-out is verstreken voordat de ICommunicationObject status kon worden ingevoerd Opened en de Faulted status is ingevoerd.
Opmerkingen
Wanneer een ICommunicationObject instantie wordt geïnstantieerd, begint deze in de Created status. In de Created status kan het object worden geconfigureerd (bijvoorbeeld eigenschappen kunnen worden ingesteld of gebeurtenissen kunnen worden geregistreerd), maar het is nog niet bruikbaar om berichten te verzenden of te ontvangen. De Open methode zorgt ervoor dat er ICommunicationObjectOpening een status wordt ingevoerd waarin deze blijft totdat de geopende bewerking is geslaagd, er een time-out optreedt of mislukt en het object mislukt of het ICommunicationObject object wordt afgebroken.
Opened De status ICommunicationObject is bruikbaar (bijvoorbeeld berichten kunnen worden ontvangen), maar kan niet meer worden geconfigureerd.
Er is ook een asynchrone versie van de open methode die wordt gestart door aanroepen en voltooid door aanroepen BeginOpenEndOpen(IAsyncResult).
Notities voor uitvoerders
De bewerking moet een TimeoutException opgegeven waarde geven als de opgegeven timeout waarde wordt overschreden.