ICommunicationObject.BeginOpen Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Påbörjar en asynkron åtgärd för att öppna ett kommunikationsobjekt.
Överlagringar
| Name | Description |
|---|---|
| BeginOpen(AsyncCallback, Object) |
Påbörjar en asynkron åtgärd för att öppna ett kommunikationsobjekt. |
| BeginOpen(TimeSpan, AsyncCallback, Object) |
Påbörjar en asynkron åtgärd för att öppna ett kommunikationsobjekt inom ett angivet tidsintervall. |
Kommentarer
Metoden BeginOpen gör att en ICommunicationObject går in i det Opening tillstånd där den förblir tills dess övergång till Opened tillståndet har slutförts eller misslyckas.
Versioner med och utan explicit timeout tillhandahålls.
BeginOpen(AsyncCallback, Object)
Påbörjar en asynkron åtgärd för att öppna ett kommunikationsobjekt.
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
Parametrar
- callback
- AsyncCallback
Ombudet AsyncCallback som tar emot meddelande om slutförandet av den asynkrona öppna åtgärden.
- state
- Object
Ett objekt som anges av programmet och som innehåller tillståndsinformation som är associerad med den asynkrona öppna åtgärden.
Returer
Det IAsyncResult som refererar till den asynkrona öppna åtgärden.
Undantag
Det ICommunicationObject gick inte att öppna och har angett tillståndet Faulted .
Standardtimeouten ICommunicationObject för öppen förflutit innan tillståndet kunde anges Opened och statusen har angetts Faulted .
Kommentarer
När en ICommunicationObject instansieras börjar den i tillståndet Created . I tillståndet Created kan objektet konfigureras (till exempel kan egenskaper anges eller händelser kan registreras), men det går ännu inte att använda för att skicka eller ta emot meddelanden. Metoden BeginOpen gör att en ICommunicationObject går in i det Opening tillstånd där den förblir tills den öppna åtgärden lyckas, den öppna åtgärden överskrider tidsgränsen eller misslyckas och objektet blir fel eller ICommunicationObject avbryts.
I tillståndet OpenedICommunicationObject är användbar (till exempel kan meddelanden tas emot), men den kan inte längre konfigureras.
Gäller för
BeginOpen(TimeSpan, AsyncCallback, Object)
Påbörjar en asynkron åtgärd för att öppna ett kommunikationsobjekt inom ett angivet tidsintervall.
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
Parametrar
- timeout
- TimeSpan
Det TimeSpan som anger hur länge sändningsåtgärden måste slutföras innan tidsgränsen nås.
- callback
- AsyncCallback
Ombudet AsyncCallback som tar emot meddelande om slutförandet av den asynkrona öppna åtgärden.
- state
- Object
Ett objekt som anges av programmet och som innehåller tillståndsinformation som är associerad med den asynkrona öppna åtgärden.
Returer
Det IAsyncResult som refererar till den asynkrona öppna åtgärden.
Undantag
Det ICommunicationObject gick inte att öppna och har angett tillståndet Faulted .
Den angivna tidsgränsen ICommunicationObject förflutit innan tillståndet kunde anges Opened och har angett tillståndet Faulted .
Kommentarer
När en ICommunicationObject instansieras börjar den i tillståndet Created . I tillståndet Created kan objektet konfigureras (till exempel kan egenskaper anges eller händelser kan registreras), men det går ännu inte att använda för att skicka eller ta emot meddelanden. Metoden Open gör att en ICommunicationObject går in i det Opening tillstånd där den förblir tills den öppna åtgärden lyckas, den öppna åtgärden överskrider tidsgränsen eller misslyckas och objektet blir fel eller ICommunicationObject avbryts.
I tillståndet OpenedICommunicationObject är användbar (till exempel kan meddelanden tas emot), men den kan inte längre konfigureras.
Anteckningar till implementerare
Åtgärden måste utlösa en TimeoutException om den angivna timeout överskrids.