Socket.EndSendFile(IAsyncResult) Metoda

Definice

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

Pouze .NET 8+: Soket není připojený ke vzdálenému hostiteli.

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

asyncResult je prázdný.

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

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

-nebo-

Pouze .NET 7+: Byl Socket uzavřen.

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 Task.

EndSendFile dokončí operaci spuštěnou nástrojem BeginSend. Musíte předat IAsyncResult vytvořené odpovídající BeginSend volání.

Pokud používáte protokol bez připojení, EndSendFile blokuje se až do odeslání datagramu. Pokud používáte protokol orientovaný na připojení, blokuje se až EndSendFile do odeslání celého souboru. Neexistuje žádná záruka, že se odeslaná data zobrazí v síti okamžitě. Za účelem zvýšení efektivity sítě může základní systém zpozdit přenos, dokud se neshromáždí významné množství odchozích dat. Úspěšné dokončení BeginSendFile metody znamená, že základní systém měl prostor pro ukládání dat do vyrovnávací paměti pro odeslání do sítě.

Poznámka

Pokud se zobrazí SocketException, použijte SocketException.ErrorCode vlastnost k získání konkrétního kódu chyby. Jakmile tento kód získáte, projděte si podrobný popis chyby v dokumentaci k rozhraní API windows Sockets verze 2 .

Poznámka

Tento člen poskytuje trasovací informace, když je ve vaší aplikaci povoleno trasování sítě. Další informace najdete v tématu Trasování sítě v rozhraní .NET Framework.

Platí pro