Socket.SendFileAsync Método

Definição

Namespace:: System.Net.Sockets

Assemblies:: netstandard.dll, System.Net.Sockets.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

Nome	Description
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 os buffers de dados para um objeto conectado Socket usando o valor especificado TransmitFileOptions .

SendFileAsync(String, CancellationToken)

Origem:: Socket.Tasks.cs

Origem:: Socket.Tasks.cs

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

ValueTask

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

Exceções

ObjectDisposedException

O Socket objeto foi fechado.

NotSupportedException

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

FileNotFoundException

O arquivo fileName não foi encontrado.

SocketException

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 o equivalente síncrono 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

Origem:: Socket.Tasks.cs

Origem:: Socket.Tasks.cs

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

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