ICommunicationObject.Open 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.
Gör att ett kommunikationsobjekt övergår från det skapade tillståndet till det öppnade tillståndet.
Överlagringar
| Name | Description |
|---|---|
| Open() |
Gör att ett kommunikationsobjekt övergår från det skapade tillståndet till det öppnade tillståndet. |
| Open(TimeSpan) |
Gör att ett kommunikationsobjekt övergår från det skapade tillståndet till det öppna tillståndet inom ett angivet tidsintervall. |
Kommentarer
Versioner med och utan explicit timeout tillhandahålls.
Open()
Gör att ett kommunikationsobjekt övergår från det skapade tillståndet till det öppnade tillståndet.
public:
void Open();
public void Open();
abstract member Open : unit -> unit
Public Sub Open ()
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 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.
Det finns också en asynkron version av den öppna metoden som initieras genom att anropa BeginOpen och slutföras genom att anropa EndOpen(IAsyncResult).
Gäller för
Open(TimeSpan)
Gör att ett kommunikationsobjekt övergår från det skapade tillståndet till det öppna tillståndet inom ett angivet tidsintervall.
public:
void Open(TimeSpan timeout);
public void Open(TimeSpan timeout);
abstract member Open : TimeSpan -> unit
Public Sub Open (timeout As TimeSpan)
Parametrar
- timeout
- TimeSpan
Det TimeSpan som anger hur länge sändningsåtgärden måste slutföras innan tidsgränsen nås.
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.
Det finns också en asynkron version av den öppna metoden som initieras genom att anropa BeginOpen och slutföras genom att anropa EndOpen(IAsyncResult).
Anteckningar till implementerare
Åtgärden måste utlösa en TimeoutException om den angivna timeout överskrids.