Socket.EndSendFile(IAsyncResult) Método

Definição

Namespace:

System.Net.Sockets

Assemblies:

netstandard.dll, System.Net.Sockets.dll

Origem:

Socket.cs

Encerra um envio assíncrono pendente de um arquivo.

public:
 void EndSendFile(IAsyncResult ^ asyncResult);

public void EndSendFile(IAsyncResult asyncResult);

member this.EndSendFile : IAsyncResult -> unit

Public Sub EndSendFile (asyncResult As IAsyncResult)

Parâmetros

asyncResult

IAsyncResult

Um IAsyncResult objeto que armazena informações de estado para essa operação assíncrona.

Exceções

NotSupportedException

Somente .NET 8+: o soquete não está conectado a um host remoto.

ObjectDisposedException

Somente .NET Framework, .NET Core e .NET 5-6: o Socket foi fechado.

ArgumentNullException

asyncResult está vazio.

ArgumentException

asyncResult não foi retornado por uma chamada para o BeginSendFile(String, AsyncCallback, Object) método.

InvalidOperationException

EndSendFile(IAsyncResult) foi chamado anteriormente para o assíncrono BeginSendFile(String, AsyncCallback, Object).

SocketException

Erro ao tentar acessar o soquete.

- ou -

Somente .NET 7+: o Socket foi fechado.

Comentários

Importante

Essa é uma API de compatibilidade. Não recomendamos usar os métodos APM (Begin* e End*) para o novo desenvolvimento. Em vez disso, use os Taskequivalentes baseados.

EndSendFile conclui a operação iniciada por BeginSend. Você precisa passar a IAsyncResult chamada criada pela chamada correspondente BeginSend .

Se você estiver usando um protocolo sem conexão, EndSendFile bloqueará até que o datagram seja enviado. Se você estiver usando um protocolo orientado à conexão, EndSendFile bloqueará até que todo o arquivo seja enviado. Não há nenhuma garantia de que os dados enviados serão exibidos na rede imediatamente. Para aumentar a eficiência de rede, o sistema subjacente pode atrasar a transmissão até que uma quantidade significativa de dados de saída seja coletada. Uma conclusão bem-sucedida do BeginSendFile método significa que o sistema subjacente teve espaço para armazenar em buffer seus dados para um envio de rede.

Observação

Se você receber um SocketException, use a SocketException.ErrorCode propriedade para obter o código de erro específico. Depois de obter esse código, consulte a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.

Observação

Esse membro gera informações de rastreamento quando você habilita o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede no .NET Framework.