Socket.SendFileAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
SendFileAsync(String, CancellationToken) |
Envía el archivo |
SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken) |
Envía el archivo |
SendFileAsync(String, CancellationToken)
- Source:
- Socket.Tasks.cs
- Source:
- Socket.Tasks.cs
- Source:
- Socket.Tasks.cs
Envía el archivo fileName
a un objeto conectado Socket .
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
Parámetros
- fileName
- String
String que contiene la ruta de acceso y el nombre del archivo que se va a enviar. Este parámetro puede ser null
.
- cancellationToken
- CancellationToken
Token de cancelación que se puede usar para cancelar la operación asincrónica.
Devoluciones
Tarea de valor que representa la operación de envío asincrónica del archivo.
Excepciones
El objeto Socket se ha cerrado.
El Socket objeto no está conectado a un host remoto.
No se encontró el archivo fileName
.
Error al intentar acceder al socket.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por SendFile(String).
Se aplica a
SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken)
- Source:
- Socket.Tasks.cs
- Source:
- Socket.Tasks.cs
- Source:
- Socket.Tasks.cs
Envía el archivo fileName
y búferes de datos a un objeto Socket conectado mediante el valor TransmitFileOptions especificado.
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
Parámetros
- fileName
- String
String que contiene la ruta de acceso y el nombre del archivo que se va a enviar. Este parámetro puede ser null
.
- preBuffer
- ReadOnlyMemory<Byte>
Una matriz Byte que contiene los datos que se van a enviar antes de enviar el archivo. Este parámetro puede ser null
.
- postBuffer
- ReadOnlyMemory<Byte>
Una matriz Byte que contiene los datos que se van a enviar después de enviar el archivo. Este parámetro puede ser null
.
- flags
- TransmitFileOptions
Uno o varios de los valores TransmitFileOptions.
- cancellationToken
- CancellationToken
Token de cancelación que se puede usar para cancelar la operación asincrónica.
Devoluciones
Tarea de valor que representa la operación de envío asincrónica del archivo.
Excepciones
El objeto Socket se ha cerrado.
El Socket objeto no está conectado a un host remoto.
No se encontró el archivo fileName
.
Error al intentar acceder al socket.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.