Socket.SendFileAsync Método

Definição

Espaço de Nomes:: System.Net.Sockets

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

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Sobrecargas

Name	Description
SendFileAsync(String, CancellationToken)	Envia o ficheiro `fileName` para um objeto ligado Socket .
SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken)	Envia o ficheiro `fileName` e os buffers de dados para um objeto ligado 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 ficheiro fileName para um objeto ligado 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

A String que contém o caminho e o nome do ficheiro a enviar. Este parâmetro pode ser null.

cancellationToken: CancellationToken

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

Devoluções

ValueTask

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

Exceções

ObjectDisposedException

O Socket objeto foi encerrado.

NotSupportedException

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

FileNotFoundException

O ficheiro fileName não foi encontrado.

SocketException

Ocorreu um erro ao tentar aceder ao soquete.

OperationCanceledException

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

Observações

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas 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 ficheiro fileName e os buffers de dados para um objeto ligado 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