Socket.EndSend 方法

定义

命名空间:

System.Net.Sockets

程序集:

System.Net.Sockets.dll

结束挂起的异步发送。

重载

EndSend(IAsyncResult)	结束挂起的异步发送。
EndSend(IAsyncResult, SocketError)	结束挂起的异步发送。

EndSend(IAsyncResult)

Source:

Socket.cs

结束挂起的异步发送。

public:
 int EndSend(IAsyncResult ^ asyncResult);

public int EndSend (IAsyncResult asyncResult);

member this.EndSend : IAsyncResult -> int

Public Function EndSend (asyncResult As IAsyncResult) As Integer

参数

asyncResult

IAsyncResult

IAsyncResult，它存储此异步操作的状态信息。

返回

Int32

如果成功，则将返回向 Socket 发送的字节数；否则会返回无效 Socket 错误。

例外

ArgumentNullException

asyncResult 为 null。

ArgumentException

对 BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) 方法的调用未返回 asyncResult。

InvalidOperationException

先前为异步发送已调用过 EndSend(IAsyncResult)。

SocketException

尝试访问套接字时出错。

- 或 -

仅限 .NET 7+： Socket 已关闭。

ObjectDisposedException

仅.NET Framework、.NET Core 和 .NET 5-6：Socket已关闭。

注解

重要

这是一个兼容性 API。 不建议使用 APM (Begin* 和 End*) 方法进行新开发。 请改用 Task基于 的等效项。

EndSend 完成由 BeginSend启动的操作。 需要传递 IAsyncResult 由匹配 BeginSend 调用创建的 。

如果使用无连接协议， EndSend 将阻止，直到发送数据报。 如果使用面向连接的协议，将阻止， EndSend 直到发送某些缓冲区。 如果 的 EndSend 返回值指示缓冲区未完全发送，请再次调用 BeginSend 方法，修改缓冲区以保存未发送的数据。

无法保证发送的数据会立即出现在网络上。 为了提高网络效率，基础系统可能会延迟传输，直到收集大量传出数据。 方法的 BeginSend 成功完成意味着基础系统有空间来缓冲网络发送的数据。

注意

如果收到 ， SocketException请使用 SocketException.ErrorCode 属性获取特定的错误代码。

注意

当给定线程退出时，将取消由给定线程启动的所有 I/O。 如果线程在操作完成之前退出，挂起的异步操作可能会失败。

注意

成功完成发送并不表示数据已成功传递。 如果传输系统中没有可用于保存要传输的数据的缓冲区空间，除非套接字已置于非阻止模式，否则发送将阻止。

备注

当你在应用程序中启用网络跟踪后，此成员将输出跟踪信息。 有关详细信息，请参阅 .NET Framework 中的网络跟踪。

另请参阅

• BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object)
• AsyncCallback
• AsyncState
• SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)
• NoDelay

EndSend(IAsyncResult, SocketError)

Source:

Socket.cs

结束挂起的异步发送。

public:
 int EndSend(IAsyncResult ^ asyncResult, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode);

public int EndSend (IAsyncResult asyncResult, out System.Net.Sockets.SocketError errorCode);

member this.EndSend : IAsyncResult * SocketError -> int

Public Function EndSend (asyncResult As IAsyncResult, ByRef errorCode As SocketError) As Integer

参数

asyncResult

IAsyncResult

IAsyncResult，它存储此异步操作的状态信息。

errorCode

SocketError

一个 SocketError 对象，它存储套接字错误。

返回

Int32

如果成功，则将返回向 Socket 发送的字节数；否则会返回无效 Socket 错误。

例外

ArgumentNullException

asyncResult 为 null。

ArgumentException

对 BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) 方法的调用未返回 asyncResult。

InvalidOperationException

先前为异步发送已调用过 EndSend(IAsyncResult)。

SocketException

尝试访问套接字时出错。

- 或 -

仅限 .NET 7+： Socket 已关闭。

ObjectDisposedException

仅.NET Framework、.NET Core 和 .NET 5-6：Socket已关闭。

注解

重要

这是一个兼容性 API。 不建议使用 APM (Begin* 和 End*) 方法进行新开发。 请改用 Task基于 的等效项。

EndSend 完成由 BeginSend启动的操作。 需要传递 IAsyncResult 由匹配 BeginSend 调用创建的 。

如果使用无连接协议， EndSend 将阻止，直到发送数据报。 如果使用面向连接的协议，将阻止， EndSend 直到发送某些缓冲区。 如果 的 EndSend 返回值指示缓冲区未完全发送，请再次调用 BeginSend 方法，修改缓冲区以保存未发送的数据。

无法保证发送的数据会立即出现在网络上。 为了提高网络效率，基础系统可能会延迟传输，直到收集大量传出数据。 方法的 BeginSend 成功完成意味着基础系统有空间来缓冲网络发送的数据。

注意

如果收到 ， SocketException请使用 SocketException.ErrorCode 属性获取特定的错误代码。

注意

当给定线程退出时，将取消由给定线程启动的所有 I/O。 如果线程在操作完成之前退出，挂起的异步操作可能会失败。

注意

成功完成发送并不表示数据已成功传递。 如果传输系统中没有可用于保存要传输的数据的缓冲区空间，除非套接字已置于非阻止模式，否则发送将阻止。

备注

当你在应用程序中启用网络跟踪后，此成员将输出跟踪信息。 有关详细信息，请参阅 .NET Framework 中的网络跟踪。

另请参阅

• BeginSend(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object)
• AsyncCallback
• AsyncState
• SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)
• NoDelay