Socket.SendAsync Método

Definição

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Sobrecargas

SendAsync(ReadOnlyMemory<Byte>, CancellationToken)	Envia dados em um soquete conectado.
SendAsync(IList<ArraySegment<Byte>>, SocketFlags)	Envia dados em um soquete conectado.
SendAsync(ArraySegment<Byte>, SocketFlags)	Envia dados em um soquete conectado.
SendAsync(ReadOnlyMemory<Byte>, SocketFlags, CancellationToken)	Envia dados em um soquete conectado.
SendAsync(IList<ArraySegment<Byte>>)	Envia dados em um soquete conectado.
SendAsync(ArraySegment<Byte>)	Envia dados em um soquete conectado.
SendAsync(SocketAsyncEventArgs)	Envia dados de forma assíncrona para um objeto Socket conectado.

SendAsync(ReadOnlyMemory<Byte>, CancellationToken)

Origem:

Socket.Tasks.cs

Envia dados em um soquete conectado.

public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);

member this.SendAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parâmetros

buffer

ReadOnlyMemory<Byte>

O buffer para os dados a serem enviados.

cancellationToken

CancellationToken

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

Retornos

ValueTask<Int32>

Uma tarefa assíncrona que é concluída com o número de bytes enviados.

Exceções

OperationCanceledException

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

SendAsync(IList<ArraySegment<Byte>>, SocketFlags)

Origem:

Socket.Tasks.cs

Envia dados em um soquete conectado.

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers, System::Net::Sockets::SocketFlags socketFlags);

public System.Threading.Tasks.Task<int> SendAsync (System.Collections.Generic.IList<ArraySegment<byte>> buffers, System.Net.Sockets.SocketFlags socketFlags);

member this.SendAsync : System.Collections.Generic.IList<ArraySegment<byte>> * System.Net.Sockets.SocketFlags -> System.Threading.Tasks.Task<int>

Public Function SendAsync (buffers As IList(Of ArraySegment(Of Byte)), socketFlags As SocketFlags) As Task(Of Integer)

Parâmetros

buffers

IList<ArraySegment<Byte>>

Uma lista de buffers para os dados a serem enviados.

socketFlags

SocketFlags

Uma combinação bit a bit de valores SocketFlags que serão usados ao enviar os dados.

Retornos

Task<Int32>

Uma tarefa assíncrona que é concluída com o número de bytes enviados.

Exceções

ArgumentNullException

buffers é null.

SocketException

Ocorreu um erro ao tentar acessar o soquete.

ObjectDisposedException

O Socket foi fechado.

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 Send(IList<ArraySegment<Byte>>, SocketFlags).

SendAsync(ArraySegment<Byte>, SocketFlags)

Origem:

Socket.Tasks.cs

Envia dados em um soquete conectado.

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(ArraySegment<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags);

public System.Threading.Tasks.Task<int> SendAsync (ArraySegment<byte> buffer, System.Net.Sockets.SocketFlags socketFlags);

member this.SendAsync : ArraySegment<byte> * System.Net.Sockets.SocketFlags -> System.Threading.Tasks.Task<int>

Public Function SendAsync (buffer As ArraySegment(Of Byte), socketFlags As SocketFlags) As Task(Of Integer)

Parâmetros

buffer

ArraySegment<Byte>

O buffer para os dados a serem enviados.

socketFlags

SocketFlags

Uma combinação bit a bit de valores SocketFlags que serão usados ao enviar os dados.

Retornos

Task<Int32>

Uma tarefa assíncrona que é concluída com o número de bytes enviados.

Exceções

SocketException

Ocorreu um erro ao tentar acessar o soquete.

ObjectDisposedException

O Socket foi fechado.

SendAsync(ReadOnlyMemory<Byte>, SocketFlags, CancellationToken)

Origem:

Socket.Tasks.cs

Envia dados em um soquete conectado.

public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, System.Threading.CancellationToken cancellationToken = default);

member this.SendAsync : ReadOnlyMemory<byte> * System.Net.Sockets.SocketFlags * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendAsync (buffer As ReadOnlyMemory(Of Byte), socketFlags As SocketFlags, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parâmetros

buffer

ReadOnlyMemory<Byte>

O buffer para os dados a serem enviados.

socketFlags

SocketFlags

Uma combinação bit a bit de valores SocketFlags que serão usados ao enviar os dados.

cancellationToken

CancellationToken

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

Retornos

ValueTask<Int32>

Uma tarefa assíncrona que é concluída com o número de bytes enviados.

Exceções

SocketException

Ocorreu um erro ao tentar acessar o soquete.

ObjectDisposedException

O Socket foi fechado.

OperationCanceledException

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

SendAsync(IList<ArraySegment<Byte>>)

Origem:

Socket.Tasks.cs

Envia dados em um soquete conectado.

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers);

public System.Threading.Tasks.Task<int> SendAsync (System.Collections.Generic.IList<ArraySegment<byte>> buffers);

member this.SendAsync : System.Collections.Generic.IList<ArraySegment<byte>> -> System.Threading.Tasks.Task<int>

Public Function SendAsync (buffers As IList(Of ArraySegment(Of Byte))) As Task(Of Integer)

Parâmetros

buffers

IList<ArraySegment<Byte>>

Uma lista de buffers para os dados a serem enviados.

Retornos

Task<Int32>

Uma tarefa assíncrona que é concluída com o número de bytes enviados.

Exceções

ArgumentNullException

buffers é null.

SocketException

Ocorreu um erro ao tentar acessar o soquete.

ObjectDisposedException

O Socket foi fechado.

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 Send(IList<ArraySegment<Byte>>).

SendAsync(ArraySegment<Byte>)

Origem:

Socket.Tasks.cs

Envia dados em um soquete conectado.

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(ArraySegment<System::Byte> buffer);

public System.Threading.Tasks.Task<int> SendAsync (ArraySegment<byte> buffer);

member this.SendAsync : ArraySegment<byte> -> System.Threading.Tasks.Task<int>

Public Function SendAsync (buffer As ArraySegment(Of Byte)) As Task(Of Integer)

Parâmetros

buffer

ArraySegment<Byte>

O buffer para os dados a serem enviados.

Retornos

Task<Int32>

Uma tarefa assíncrona que é concluída com o número de bytes enviados.

Exceções

SocketException

Ocorreu um erro ao tentar acessar o soquete.

ObjectDisposedException

O Socket foi fechado.

SendAsync(SocketAsyncEventArgs)

Origem:

Socket.cs

Envia dados de forma assíncrona para um objeto Socket conectado.

public:
 bool SendAsync(System::Net::Sockets::SocketAsyncEventArgs ^ e);

public bool SendAsync (System.Net.Sockets.SocketAsyncEventArgs e);

member this.SendAsync : System.Net.Sockets.SocketAsyncEventArgs -> bool

Public Function SendAsync (e As SocketAsyncEventArgs) As Boolean

Parâmetros

e

SocketAsyncEventArgs

O objeto SocketAsyncEventArgs a ser usado nessa operação de soquete assíncrono.

Retornos

Boolean

true se a operação de E/S está pendente. O evento Completed no parâmetro e será acionado após a conclusão da operação.

false se a operação de E/S foi concluída de forma síncrona. Nesse caso, o evento Completed no parâmetro e não será gerado e o objeto e passado como um parâmetro poderá ser examinado imediatamente depois que a chamada do método for retornada para recuperar o resultado da operação.

Exceções

ArgumentException

As propriedades Buffer ou BufferList no parâmetro e devem referenciar buffers válidos. Uma ou a outra dessas propriedades poderá ser definida, mas não ambas ao mesmo tempo.

InvalidOperationException

Uma operação de soquete já estava em andamento com o objeto SocketAsyncEventArgs especificado no parâmetro e.

ObjectDisposedException

O Socket foi fechado.

SocketException

O Socket ainda não está conectado ou não foi obtido por meio de um método Accept(), AcceptAsync(SocketAsyncEventArgs) ou BeginAccept.

Comentários

O SendAsync método é usado para gravar dados de saída de um ou mais buffers em um soquete orientado a conexão. No entanto, esse método também pode ser usado em soquetes sem conexão que especificaram um host remoto em uma operação de conexão.

O SendAsync método inicia uma operação de envio assíncrona para o host remoto estabelecido no Acceptmétodo , AcceptAsync, BeginAccept, BeginConnect, Connectou ConnectAsync .

As seguintes propriedades e eventos no System.Net.Sockets.SocketAsyncEventArgs objeto são necessários para chamar esse método com êxito:

• SocketAsyncEventArgs.Buffer ou SocketAsyncEventArgs.BufferList

• SocketAsyncEventArgs.Count se SocketAsyncEventArgs.Buffer estiver definido

• SocketAsyncEventArgs.Offset se SocketAsyncEventArgs.Buffer estiver definido

• SocketAsyncEventArgs.Completed

O chamador pode definir a SocketAsyncEventArgs.UserToken propriedade como qualquer objeto de estado de usuário desejado antes de chamar o SendAsync método , para que as informações possam ser recuperadas no método de retorno de chamada. Se o retorno de chamada precisar de mais informações do que um único objeto, uma classe pequena poderá ser criada para manter as outras informações de estado necessárias como membros.

O SendAsync método gerará uma exceção se você não chamar Acceptprimeiro , AcceptAsync, BeginAcceptBeginConnect, Connectou ConnectAsync.

Chamar o SendAsync método oferece a capacidade de enviar dados dentro de um thread de execução separado.

Para soquetes orientados a mensagens, não exceda o tamanho máximo da mensagem do provedor de serviços de soquetes do Windows subjacente. Se os dados forem muito longos para passar atomicamente pelo provedor de serviços subjacente, nenhum dado será transmitido e o SendAsync método gerará um SocketException com o SocketAsyncEventArgs.SocketError definido para o código de erro nativo Winsock WSAEMSGSIZE (10040).

Observe que a conclusão bem-sucedida do SendAsync método não indica que os dados foram entregues com êxito.

Confira também

• SocketAsyncEventArgs
• Buffer
• BufferList
• Completed
• Count
• Offset
• UserToken