Freigeben über


Socket.SendFileAsync Methode

Definition

Ü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
Quelle:
Socket.Tasks.cs
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

Ein Werttask, der den asynchronen Dateisendevorgang darstellt.

Ausnahmen

Das Socket-Objekt wurde geschlossen.

Das Socket Objekt ist nicht mit einem Remotehost verbunden.

Die Datei fileName wurde nicht gefunden.

Fehler beim Versuch, auf den Socket zuzugreifen.

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

Gilt für:

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

Quelle:
Socket.Tasks.cs
Quelle:
Socket.Tasks.cs
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

Ein Werttask, der den asynchronen Dateisendevorgang darstellt.

Ausnahmen

Das Socket-Objekt wurde geschlossen.

Das Socket Objekt ist nicht mit einem Remotehost verbunden.

Die Datei fileName wurde nicht gefunden.

Fehler beim Versuch, auf den Socket zuzugreifen.

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

Gilt für: