ICommunicationObject.BeginOpen 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.
Begint een asynchrone bewerking om een communicatieobject te openen.
Overloads
| Name | Description |
|---|---|
| BeginOpen(AsyncCallback, Object) |
Begint een asynchrone bewerking om een communicatieobject te openen. |
| BeginOpen(TimeSpan, AsyncCallback, Object) |
Begint een asynchrone bewerking om een communicatieobject binnen een opgegeven tijdsinterval te openen. |
Opmerkingen
De BeginOpen methode zorgt ervoor dat de ICommunicationObjectOpening status wordt ingevoerd waar deze blijft totdat de overgang naar de Opened status is voltooid of mislukt.
Versies met en zonder expliciete time-out worden geleverd.
BeginOpen(AsyncCallback, Object)
Begint een asynchrone bewerking om een communicatieobject te openen.
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
Parameters
- callback
- AsyncCallback
De AsyncCallback gemachtigde die een melding ontvangt van de voltooiing van de asynchrone open bewerking.
- state
- Object
Een object, opgegeven door de toepassing, dat statusinformatie bevat die is gekoppeld aan de asynchrone open bewerking.
Retouren
De IAsyncResult bewerking die verwijst naar de asynchrone open bewerking.
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 BeginOpen 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.
Van toepassing op
BeginOpen(TimeSpan, AsyncCallback, Object)
Begint een asynchrone bewerking om een communicatieobject binnen een opgegeven tijdsinterval te openen.
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
Parameters
- timeout
- TimeSpan
Hiermee TimeSpan geeft u op hoe lang de verzendbewerking moet worden voltooid voordat er een time-out optreedt.
- callback
- AsyncCallback
De AsyncCallback gemachtigde die een melding ontvangt van de voltooiing van de asynchrone open bewerking.
- state
- Object
Een object, opgegeven door de toepassing, dat statusinformatie bevat die is gekoppeld aan de asynchrone open bewerking.
Retouren
De IAsyncResult bewerking die verwijst naar de asynchrone open bewerking.
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.
Notities voor uitvoerders
De bewerking moet een TimeoutException opgegeven waarde geven als de opgegeven timeout waarde wordt overschreden.