Socket.BeginDisconnect(Boolean, AsyncCallback, Object) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Net.Sockets

Zestaw:: System.Net.Sockets.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Źródło:: Socket.cs

Źródło:: Socket.cs

Źródło:: Socket.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Rozpoczyna żądanie asynchroniczne, aby odłączyć się od zdalnego punktu końcowego.

public:
 IAsyncResult ^ BeginDisconnect(bool reuseSocket, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginDisconnect (bool reuseSocket, AsyncCallback? callback, object? state);

public IAsyncResult BeginDisconnect (bool reuseSocket, AsyncCallback callback, object state);

member this.BeginDisconnect : bool * AsyncCallback * obj -> IAsyncResult

Public Function BeginDisconnect (reuseSocket As Boolean, callback As AsyncCallback, state As Object) As IAsyncResult

Parametry

reuseSocket: Boolean

true jeśli to gniazdo można ponownie użyć po zamknięciu połączenia; w przeciwnym razie , false.

callback: AsyncCallback

Delegat AsyncCallback .

state: Object

Obiekt zawierający informacje o stanie dla tego żądania.

Zwraca

IAsyncResult

IAsyncResult Obiekt, który odwołuje się do operacji asynchronicznej.

Wyjątki

ObjectDisposedException

Socket Obiekt został zamknięty.

SocketException

.NET Framework i .NET 5 i starsze tylko: wystąpił błąd podczas próby uzyskania dostępu do gniazda.

Uwagi

Ważne

Jest to interfejs API zgodności. Nie zalecamy używania metod APM (Begin* i End*) do nowego programowania. Zamiast tego należy użyć Taskodpowiedników opartych na protokole .

Jeśli używasz protokołu zorientowanego na połączenie, możesz wywołać BeginDisconnect metodę w celu zainicjowania odłączenia od zdalnego punktu końcowego. Jeśli reuseSocket jest to true, możesz ponownie użyć gniazda.

Możesz przekazać wywołanie zwrotne implementujące AsyncCallback polecenie , BeginDisconnect aby otrzymywać powiadomienia o zakończeniu operacji rozłączania. Należy pamiętać, że jeśli bazowy stos sieciowy ukończy operację synchronicznie, wywołanie zwrotne może zostać wykonane w tekście podczas wywołania metody BeginDisconnect. W takim przypadku CompletedSynchronously właściwość zwrócona IAsyncResult zostanie ustawiona na wartość , aby wskazać true , że metoda została ukończona synchronicznie. AsyncState Użyj właściwości obiektu , IAsyncResult aby uzyskać obiekt stanu przekazany do BeginDisconnect metody.

Operacja musi zostać ukończona BeginDisconnect przez wywołanie EndDisconnect metody . Zazwyczaj metoda jest wywoływana przez podanego AsyncCallback delegata. EndDisconnect zablokuje wątek wywołujący do momentu ukończenia operacji.

Uwaga

Jeśli wystąpi SocketException wyjątek, użyj SocketException.ErrorCode właściwości , aby uzyskać określony kod błędu.

Uwaga

Ten element członkowski generuje informacje ze śledzenia pod warunkiem włączenia funkcji śledzenia sieci w aplikacji. Aby uzyskać więcej informacji, zobacz Śledzenie sieci w .NET Framework.

Dotyczy