Socket.SendFileAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| SendFileAsync(String, CancellationToken) |
Sendet die Datei |
| SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken) |
Sendet die Datei |
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.ValueTaskPublic Function SendFileAsync (fileName As String, Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParameter
- 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.ValueTaskPublic Function SendFileAsync (fileName As String, preBuffer As ReadOnlyMemory(Of Byte), postBuffer As ReadOnlyMemory(Of Byte), flags As TransmitFileOptions, Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParameter
- 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.
