Socket.SendFileAsync Método

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

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

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

ValueTask

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

Exceções

ObjectDisposedException

O objeto Socket foi fechado.

NotSupportedException

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

FileNotFoundException

O arquivo fileName não foi encontrado.

SocketException

Ocorreu um erro ao tentar acessar o soquete.

OperationCanceledException

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

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

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

ValueTask

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

Exceções

ObjectDisposedException

O objeto Socket foi fechado.

NotSupportedException

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

FileNotFoundException

O arquivo fileName não foi encontrado.

SocketException

Ocorreu um erro ao tentar acessar o soquete.

OperationCanceledException

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