Partilhar via


Socket.SendFileAsync Método

Definição

Sobrecargas

SendFileAsync(String, CancellationToken)

Envia o arquivo fileName para um objeto conectado Socket .

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

Envia o arquivo fileName e buffers de dados a um Socket conectado usando o valor TransmitFileOptions especificado.

SendFileAsync(String, CancellationToken)

Origem:
Socket.Tasks.cs
Origem:
Socket.Tasks.cs
Origem:
Socket.Tasks.cs

Envia o arquivo fileName para um 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

Um String que contém o caminho e o nome do arquivo a ser enviado. Esse parâmetro pode ser null.

cancellationToken
CancellationToken

Um token de cancelamento que pode ser usado para cancelar a operação assíncrona.

Retornos

Uma tarefa de valor que representa a operação de envio de arquivo assíncrona.

Exceções

O objeto Socket foi fechado.

O Socket objeto não está conectado a um host remoto.

O arquivo fileName não foi encontrado.

Ocorreu um erro ao tentar acessar o soquete.

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por SendFile(String).

Aplica-se a

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

Origem:
Socket.Tasks.cs
Origem:
Socket.Tasks.cs
Origem:
Socket.Tasks.cs

Envia o arquivo fileName e buffers de dados a um Socket conectado usando o 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

Um String que contém o caminho e o nome do arquivo a ser enviado. Esse parâmetro pode ser null.

preBuffer
ReadOnlyMemory<Byte>

Uma matriz Byte que contém dados a serem enviados antes de o arquivo ser enviado. Esse parâmetro pode ser null.

postBuffer
ReadOnlyMemory<Byte>

Uma matriz Byte que contém dados a serem enviados depois de o arquivo ser enviado. Esse parâmetro pode ser null.

flags
TransmitFileOptions

Um ou mais valores TransmitFileOptions.

cancellationToken
CancellationToken

Um token de cancelamento que pode ser usado para cancelar a operação assíncrona.

Retornos

Uma tarefa de valor que representa a operação de envio de arquivo assíncrona.

Exceções

O objeto Socket foi fechado.

O Socket objeto não está conectado a um host remoto.

O arquivo fileName não foi encontrado.

Ocorreu um erro ao tentar acessar o soquete.

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Aplica-se a