Socket.SendFileAsync Metoda

Definice

Přetížení

SendFileAsync(String, CancellationToken)

Odešle soubor fileName do připojeného Socket objektu.

SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken)

Odešle soubor fileName a vyrovnávací paměti dat do připojeného Socket objektu pomocí zadané TransmitFileOptions hodnoty.

SendFileAsync(String, CancellationToken)

Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs

Odešle soubor fileName do připojeného Socket objektu.

public System.Threading.Tasks.ValueTask SendFileAsync (string? fileName, System.Threading.CancellationToken cancellationToken = default);
member this.SendFileAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Function SendFileAsync (fileName As String, Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parametry

fileName
String

A String , který obsahuje cestu a název souboru, který má být odeslán. Tento parametr může být null.

cancellationToken
CancellationToken

Token zrušení, který lze použít ke zrušení asynchronní operace.

Návraty

Úloha hodnoty, která představuje asynchronní operaci odeslání souboru.

Výjimky

Objekt Socket byl uzavřen.

Objekt Socket není připojen ke vzdálenému hostiteli.

Soubor fileName nebyl nalezen.

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

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem SendFile(String).

Platí pro

SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken)

Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs
Zdroj:
Socket.Tasks.cs

Odešle soubor fileName a vyrovnávací paměti dat do připojeného Socket objektu pomocí zadané TransmitFileOptions hodnoty.

public System.Threading.Tasks.ValueTask SendFileAsync (string? fileName, ReadOnlyMemory<byte> preBuffer, ReadOnlyMemory<byte> postBuffer, System.Net.Sockets.TransmitFileOptions flags, System.Threading.CancellationToken cancellationToken = default);
member this.SendFileAsync : string * ReadOnlyMemory<byte> * ReadOnlyMemory<byte> * System.Net.Sockets.TransmitFileOptions * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Function SendFileAsync (fileName As String, preBuffer As ReadOnlyMemory(Of Byte), postBuffer As ReadOnlyMemory(Of Byte), flags As TransmitFileOptions, Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parametry

fileName
String

A String , který obsahuje cestu a název souboru, který má být odeslán. Tento parametr může být null.

preBuffer
ReadOnlyMemory<Byte>

Pole Byte obsahující data, která mají být odeslána před odesláním souboru. Tento parametr může být null.

postBuffer
ReadOnlyMemory<Byte>

Pole Byte obsahující data, která mají být odeslána po odeslání souboru. Tento parametr může být null.

flags
TransmitFileOptions

Jedna nebo více TransmitFileOptions hodnot.

cancellationToken
CancellationToken

Token zrušení, který lze použít ke zrušení asynchronní operace.

Návraty

Úloha hodnoty, která představuje asynchronní operaci odeslání souboru.

Výjimky

Objekt Socket byl uzavřen.

Objekt Socket není připojen ke vzdálenému hostiteli.

Soubor fileName nebyl nalezen.

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

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Platí pro