Socket.EndSendFile(IAsyncResult) Metoda

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

netstandard.dll, System.Net.Sockets.dll

Zdroj:

Socket.cs

Ukončí čekající asynchronní odeslání souboru.

public:
 void EndSendFile(IAsyncResult ^ asyncResult);

public void EndSendFile(IAsyncResult asyncResult);

member this.EndSendFile : IAsyncResult -> unit

Public Sub EndSendFile (asyncResult As IAsyncResult)

Parametry

asyncResult

IAsyncResult

Objekt IAsyncResult , který ukládá informace o stavu pro tuto asynchronní operaci.

Výjimky

NotSupportedException

Pouze .NET 8 nebo novější: Soket není připojený ke vzdálenému hostiteli.

ObjectDisposedException

Pouze rozhraní .NET Framework, .NET Core a .NET 5-6: Bylo Socket uzavřeno.

ArgumentNullException

asyncResult je prázdný.

ArgumentException

asyncResult nebyla vrácena voláním BeginSendFile(String, AsyncCallback, Object) metody.

InvalidOperationException

EndSendFile(IAsyncResult) byl dříve volán pro asynchronní BeginSendFile(String, AsyncCallback, Object).

SocketException

Při pokusu o přístup k soketu došlo k chybě.

nebo

Pouze .NET 7+ : Tato Socket možnost byla uzavřena.

Poznámky

Důležité

Toto je rozhraní API pro kompatibilitu. Pro nový vývoj nedoporučujeme používat metody APM (Begin* a End*). Místo toho použijte ekvivalenty založené na Taskzákladech.

EndSendFile dokončí operaci, kterou BeginSendspustil . Musíte předat vytvořenou IAsyncResult odpovídajícím BeginSend voláním.

Pokud používáte protokol bez připojení, EndSendFile blokuje se do odeslání datagramu. Pokud používáte protokol orientovaný na připojení, EndSendFile blokuje se do odeslání celého souboru. Není zaručeno, že se data, která odesíláte, zobrazí v síti okamžitě. Aby se zvýšila efektivita sítě, může základní systém zpozdit přenos, dokud se neshromáždí značné množství odchozích dat. Úspěšné dokončení BeginSendFile metody znamená, že základní systém měl místo pro ukládání dat do vyrovnávací paměti pro odesílání sítě.

Poznámka:

Pokud se zobrazí kód SocketExceptionchyby, použijte SocketException.ErrorCode vlastnost k získání konkrétního kódu chyby. Po získání tohoto kódu si přečtěte dokumentaci k chybě rozhraní API rozhraní WINDOWS Sockets verze 2 , kde najdete podrobný popis chyby.

Poznámka:

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.