Socket.EndSendFile(IAsyncResult) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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.
EndSendFile(IAsyncResult) byla dříve volána pro asynchronní BeginSendFile(String, AsyncCallback, Object).
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.