Compartir vía


Socket.SendFileAsync Método

Definición

Sobrecargas

SendFileAsync(String, CancellationToken)

Envía el archivo fileName a un objeto conectado Socket .

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

Envía el archivo fileName y búferes de datos a un objeto Socket conectado mediante el valor TransmitFileOptions especificado.

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.

Se aplica a