Socket.SendFileAsync Methode

Definition

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Überlädt

SendFileAsync(String, CancellationToken)	Sendet die Datei fileName an ein verbundenes Socket Objekt.
SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken)	Sendet die Datei fileName und puffert Daten mit dem angegebenen TransmitFileOptions-Wert in einem verbundenen Socket-Objekt.

SendFileAsync(String, CancellationToken)

Quelle:

Socket.Tasks.cs

Sendet die Datei fileName an ein verbundenes Socket Objekt.

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

Parameter

fileName

String

Ein String, der den Pfad und Namen der Datei enthält, die gesendet werden soll. Dieser Parameter kann null sein.

cancellationToken

CancellationToken

Ein Abbruchtoken, das zum Abbrechen des asynchronen Vorgangs verwendet werden kann.

Gibt zurück

ValueTask

Ein Werttask, der den asynchronen Dateisendevorgang darstellt.

Ausnahmen

ObjectDisposedException

Das Socket-Objekt wurde geschlossen.

NotSupportedException

Das Socket Objekt ist nicht mit einem Remotehost verbunden.

FileNotFoundException

Die Datei fileName wurde nicht gefunden.

SocketException

Fehler beim Versuch, auf den Socket zuzugreifen.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden SendFile(String).

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

Quelle:

Socket.Tasks.cs

Sendet die Datei fileName und puffert Daten mit dem angegebenen TransmitFileOptions-Wert in einem verbundenen Socket-Objekt.

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

Parameter

fileName

String

Ein String, der den Pfad und Namen der Datei enthält, die gesendet werden soll. Dieser Parameter kann null sein.

preBuffer

ReadOnlyMemory<Byte>

Ein Byte-Array, das Daten enthält, die gesendet werden sollen, bevor die Datei gesendet wird. Dieser Parameter kann nullsein.

postBuffer

ReadOnlyMemory<Byte>

Ein Byte-Array, das Daten enthält, die gesendet werden sollen, nachdem die Datei gesendet wurde. Dieser Parameter kann null sein.

flags

TransmitFileOptions

Mindestens ein TransmitFileOptions-Wert.

cancellationToken

CancellationToken

Ein Abbruchtoken, das zum Abbrechen des asynchronen Vorgangs verwendet werden kann.

Gibt zurück

ValueTask

Ein Werttask, der den asynchronen Dateisendevorgang darstellt.

Ausnahmen

ObjectDisposedException

Das Socket-Objekt wurde geschlossen.

NotSupportedException

Das Socket Objekt ist nicht mit einem Remotehost verbunden.

FileNotFoundException

Die Datei fileName wurde nicht gefunden.

SocketException

Fehler beim Versuch, auf den Socket zuzugreifen.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.