Socket.SendFileAsync Método
Definição
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
| SendFileAsync(String, CancellationToken) |
Envia o arquivo |
| SendFileAsync(String, ReadOnlyMemory<Byte>, ReadOnlyMemory<Byte>, TransmitFileOptions, CancellationToken) |
Envia o arquivo |
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.ValueTaskPublic Function SendFileAsync (fileName As String, Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParâ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.ValueTaskPublic Function SendFileAsync (fileName As String, preBuffer As ReadOnlyMemory(Of Byte), postBuffer As ReadOnlyMemory(Of Byte), flags As TransmitFileOptions, Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParâ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.
