Nelze vybrat více než 25 témat Téma musí začínat písmenem nebo číslem, může obsahovat pomlčky („-“) a může být dlouhé až 35 znaků.
 
 
 
 
 
 

434 řádky
43 KiB

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <doc>
  3. <assembly>
  4. <name>System.Net.Sockets</name>
  5. </assembly>
  6. <members>
  7. <member name="T:System.Net.Sockets.ProtocolType">
  8. <summary>指定 <see cref="T:System.Net.Sockets.Socket" /> 类支持的协议。</summary>
  9. </member>
  10. <member name="F:System.Net.Sockets.ProtocolType.Tcp">
  11. <summary>传输控制协议。</summary>
  12. </member>
  13. <member name="F:System.Net.Sockets.ProtocolType.Udp">
  14. <summary>用户数据报协议。</summary>
  15. </member>
  16. <member name="F:System.Net.Sockets.ProtocolType.Unknown">
  17. <summary>未知协议。</summary>
  18. </member>
  19. <member name="F:System.Net.Sockets.ProtocolType.Unspecified">
  20. <summary>未指定的协议。</summary>
  21. </member>
  22. <member name="T:System.Net.Sockets.Socket">
  23. <summary>实现 Berkeley 套接字接口。</summary>
  24. </member>
  25. <member name="M:System.Net.Sockets.Socket.#ctor(System.Net.Sockets.AddressFamily,System.Net.Sockets.SocketType,System.Net.Sockets.ProtocolType)">
  26. <summary>使用指定的地址族、套接字类型和协议初始化 <see cref="T:System.Net.Sockets.Socket" /> 类的新实例。</summary>
  27. <param name="addressFamily">
  28. <see cref="T:System.Net.Sockets.AddressFamily" /> 值之一。</param>
  29. <param name="socketType">
  30. <see cref="T:System.Net.Sockets.SocketType" /> 值之一。</param>
  31. <param name="protocolType">
  32. <see cref="T:System.Net.Sockets.ProtocolType" /> 值之一。</param>
  33. <exception cref="T:System.Net.Sockets.SocketException">
  34. <paramref name="addressFamily" />、<paramref name="socketType" /> 和 <paramref name="protocolType" /> 的组合会导致无效套接字。</exception>
  35. </member>
  36. <member name="M:System.Net.Sockets.Socket.#ctor(System.Net.Sockets.SocketType,System.Net.Sockets.ProtocolType)">
  37. <summary>使用指定的地址族、套接字类型和协议初始化 <see cref="T:System.Net.Sockets.Socket" /> 类的新实例。</summary>
  38. <param name="socketType">
  39. <see cref="T:System.Net.Sockets.SocketType" /> 值之一。</param>
  40. <param name="protocolType">
  41. <see cref="T:System.Net.Sockets.ProtocolType" /> 值之一。</param>
  42. <exception cref="T:System.Net.Sockets.SocketException">
  43. <paramref name="socketType" /> 和 <paramref name="protocolType" /> 组合将导致套接字无效。</exception>
  44. </member>
  45. <member name="M:System.Net.Sockets.Socket.AcceptAsync(System.Net.Sockets.SocketAsyncEventArgs)">
  46. <summary>开始一个异步操作来接受一个传入的连接尝试。</summary>
  47. <returns>如果 I/O 操作挂起,将返回 true。操作完成时,将引发 <paramref name="e" /> 参数的 <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> 事件。如果 I/O 操作同步完成,将返回 false。将不会引发 <paramref name="e" /> 参数的 <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> 事件,并且可能在方法调用返回后立即检查作为参数传递的 <paramref name="e" /> 对象以检索操作的结果。</returns>
  48. <param name="e">要用于此异步套接字操作的 <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> 对象。</param>
  49. <exception cref="T:System.ArgumentException">参数无效。如果所提供的缓冲区不够大,将会发生此异常。缓冲区必须至少为 2 * (sizeof(SOCKADDR_STORAGE + 16) 字节。如果指定了多个缓冲区,即 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.BufferList" /> 属性不为 null,也会发生此异常。</exception>
  50. <exception cref="T:System.ArgumentOutOfRangeException">参数超出范围。如果 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.Count" /> 小于 0,将会发生此异常。</exception>
  51. <exception cref="T:System.InvalidOperationException">请求了无效操作。如果接收方 <see cref="T:System.Net.Sockets.Socket" /> 未侦听连接或者绑定了接受的套接字,将发生此异常。<see cref="M:System.Net.Sockets.Socket.Bind(System.Net.EndPoint)" /> 和 <see cref="M:System.Net.Sockets.Socket.Listen(System.Int32)" /> 方法必须先于 <see cref="M:System.Net.Sockets.Socket.AcceptAsync(System.Net.Sockets.SocketAsyncEventArgs)" /> 方法调用。如果套接字已连接或使用指定的 <paramref name="e" /> 参数的套接字操作已经在进行中,也会发生此异常。</exception>
  52. <exception cref="T:System.Net.Sockets.SocketException">试图访问套接字时发生错误。有关更多信息,请参见备注部分。</exception>
  53. <exception cref="T:System.NotSupportedException">此方法需要 Windows XP 或更高版本。</exception>
  54. <exception cref="T:System.ObjectDisposedException">
  55. <see cref="T:System.Net.Sockets.Socket" /> 已关闭。</exception>
  56. </member>
  57. <member name="P:System.Net.Sockets.Socket.AddressFamily">
  58. <summary>获取 <see cref="T:System.Net.Sockets.Socket" /> 的地址族。</summary>
  59. <returns>
  60. <see cref="T:System.Net.Sockets.AddressFamily" /> 值之一。</returns>
  61. </member>
  62. <member name="M:System.Net.Sockets.Socket.Bind(System.Net.EndPoint)">
  63. <summary>使 <see cref="T:System.Net.Sockets.Socket" /> 与一个本地终结点相关联。</summary>
  64. <param name="localEP">要与 <see cref="T:System.Net.Sockets.Socket" /> 关联的本地 <see cref="T:System.Net.EndPoint" />。</param>
  65. <exception cref="T:System.ArgumentNullException">
  66. <paramref name="localEP" /> 为 null。</exception>
  67. <exception cref="T:System.Net.Sockets.SocketException">试图访问套接字时发生错误。有关更多信息,请参见备注部分。</exception>
  68. <exception cref="T:System.ObjectDisposedException">
  69. <see cref="T:System.Net.Sockets.Socket" /> 已关闭。</exception>
  70. <exception cref="T:System.Security.SecurityException">调用堆栈上部的调用方无权执行所请求的操作。</exception>
  71. <PermissionSet>
  72. <IPermission class="System.Security.Permissions.EnvironmentPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  73. <IPermission class="System.Security.Permissions.FileIOPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  74. <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  75. <IPermission class="System.Net.SocketPermission, System, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  76. </PermissionSet>
  77. </member>
  78. <member name="M:System.Net.Sockets.Socket.CancelConnectAsync(System.Net.Sockets.SocketAsyncEventArgs)">
  79. <summary>取消一个对远程主机连接的异步请求。</summary>
  80. <param name="e">
  81. <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> 对象,该对象用于通过调用 <see cref="M:System.Net.Sockets.Socket.ConnectAsync(System.Net.Sockets.SocketType,System.Net.Sockets.ProtocolType,System.Net.Sockets.SocketAsyncEventArgs)" /> 方法之一,请求与远程主机的连接。</param>
  82. <exception cref="T:System.ArgumentNullException">
  83. <paramref name="e" /> 参数不能为 null,并且 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.RemoteEndPoint" /> 不能为空。</exception>
  84. <exception cref="T:System.Net.Sockets.SocketException">试图访问套接字时发生错误。</exception>
  85. <exception cref="T:System.ObjectDisposedException">
  86. <see cref="T:System.Net.Sockets.Socket" /> 已关闭。</exception>
  87. <exception cref="T:System.Security.SecurityException">调用堆栈上部的调用方无权执行所请求的操作。</exception>
  88. </member>
  89. <member name="M:System.Net.Sockets.Socket.ConnectAsync(System.Net.Sockets.SocketAsyncEventArgs)">
  90. <summary>开始一个对远程主机连接的异步请求。</summary>
  91. <returns>如果 I/O 操作挂起,将返回 true。操作完成时,将引发 <paramref name="e" /> 参数的 <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> 事件。如果 I/O 操作同步完成,将返回 false。在这种情况下,将不会引发 <paramref name="e" /> 参数的 <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> 事件,并且可能在方法调用返回后立即检查作为参数传递的 <paramref name="e" /> 对象以检索操作的结果。</returns>
  92. <param name="e">要用于此异步套接字操作的 <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> 对象。</param>
  93. <exception cref="T:System.ArgumentException">参数无效。如果指定了多个缓冲区,即 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.BufferList" /> 属性不为 null,将会发生此异常。</exception>
  94. <exception cref="T:System.ArgumentNullException">
  95. <paramref name="e" /> 参数不能为 null,并且 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.RemoteEndPoint" /> 不能为空。</exception>
  96. <exception cref="T:System.InvalidOperationException">
  97. <see cref="T:System.Net.Sockets.Socket" /> 正在侦听或已经在使用 <paramref name="e" /> 参数中指定的 <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> 对象执行套接字操作。</exception>
  98. <exception cref="T:System.Net.Sockets.SocketException">试图访问套接字时发生错误。有关更多信息,请参见备注部分。</exception>
  99. <exception cref="T:System.NotSupportedException">此方法需要 Windows XP 或更高版本。如果本地终结点和 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.RemoteEndPoint" /> 不是相同的地址族,也会发生此异常。</exception>
  100. <exception cref="T:System.ObjectDisposedException">
  101. <see cref="T:System.Net.Sockets.Socket" /> 已关闭。</exception>
  102. <exception cref="T:System.Security.SecurityException">调用堆栈上部的调用方无权执行所请求的操作。</exception>
  103. </member>
  104. <member name="M:System.Net.Sockets.Socket.ConnectAsync(System.Net.Sockets.SocketType,System.Net.Sockets.ProtocolType,System.Net.Sockets.SocketAsyncEventArgs)">
  105. <summary>开始一个对远程主机连接的异步请求。</summary>
  106. <returns>如果 I/O 操作挂起,将返回 true。操作完成时,将引发 <paramref name="e" /> 参数的 <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> 事件。如果 I/O 操作同步完成,将返回 false。在这种情况下,将不会引发 <paramref name="e" /> 参数的 <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> 事件,并且可能在方法调用返回后立即检查作为参数传递的 <paramref name="e" /> 对象以检索操作的结果。</returns>
  107. <param name="socketType">
  108. <see cref="T:System.Net.Sockets.SocketType" /> 值之一。</param>
  109. <param name="protocolType">
  110. <see cref="T:System.Net.Sockets.ProtocolType" /> 值之一。</param>
  111. <param name="e">要用于此异步套接字操作的 <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> 对象。</param>
  112. <exception cref="T:System.ArgumentException">参数无效。如果指定了多个缓冲区,即 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.BufferList" /> 属性不为 null,将会发生此异常。</exception>
  113. <exception cref="T:System.ArgumentNullException">
  114. <paramref name="e" /> 参数不能为 null,并且 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.RemoteEndPoint" /> 不能为空。</exception>
  115. <exception cref="T:System.InvalidOperationException">
  116. <see cref="T:System.Net.Sockets.Socket" /> 正在侦听或已经在使用 <paramref name="e" /> 参数中指定的 <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> 对象执行套接字操作。</exception>
  117. <exception cref="T:System.Net.Sockets.SocketException">试图访问套接字时发生错误。有关更多信息,请参见备注部分。</exception>
  118. <exception cref="T:System.NotSupportedException">此方法需要 Windows XP 或更高版本。如果本地终结点和 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.RemoteEndPoint" /> 不是相同的地址族,也会发生此异常。</exception>
  119. <exception cref="T:System.ObjectDisposedException">
  120. <see cref="T:System.Net.Sockets.Socket" /> 已关闭。</exception>
  121. <exception cref="T:System.Security.SecurityException">调用堆栈上部的调用方无权执行所请求的操作。</exception>
  122. </member>
  123. <member name="P:System.Net.Sockets.Socket.Connected">
  124. <summary>获取一个值,该值指示 <see cref="T:System.Net.Sockets.Socket" /> 是在上次 <see cref="Overload:System.Net.Sockets.Socket.Send" /> 还是 <see cref="Overload:System.Net.Sockets.Socket.Receive" /> 操作时连接到远程主机。</summary>
  125. <returns>如果 <see cref="T:System.Net.Sockets.Socket" /> 在最近操作时连接到远程资源,则为 true;否则为 false。</returns>
  126. </member>
  127. <member name="M:System.Net.Sockets.Socket.Dispose">
  128. <summary>释放由 <see cref="T:System.Net.Sockets.Socket" /> 类的当前实例占用的所有资源。</summary>
  129. </member>
  130. <member name="M:System.Net.Sockets.Socket.Dispose(System.Boolean)">
  131. <summary>释放由 <see cref="T:System.Net.Sockets.Socket" /> 使用的非托管资源,并可根据需要释放托管资源。</summary>
  132. <param name="disposing">如果为 true,则释放托管资源和非托管资源;如果为 false,则仅释放非托管资源。</param>
  133. </member>
  134. <member name="M:System.Net.Sockets.Socket.Finalize">
  135. <summary>释放 <see cref="T:System.Net.Sockets.Socket" /> 类使用的资源。</summary>
  136. </member>
  137. <member name="M:System.Net.Sockets.Socket.Listen(System.Int32)">
  138. <summary>将 <see cref="T:System.Net.Sockets.Socket" /> 置于侦听状态。</summary>
  139. <param name="backlog">挂起连接队列的最大长度。</param>
  140. <exception cref="T:System.Net.Sockets.SocketException">试图访问套接字时发生错误。有关更多信息,请参见备注部分。</exception>
  141. <exception cref="T:System.ObjectDisposedException">
  142. <see cref="T:System.Net.Sockets.Socket" /> 已关闭。</exception>
  143. <PermissionSet>
  144. <IPermission class="System.Security.Permissions.EnvironmentPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  145. <IPermission class="System.Security.Permissions.FileIOPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  146. <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
  147. </PermissionSet>
  148. </member>
  149. <member name="P:System.Net.Sockets.Socket.LocalEndPoint">
  150. <summary>获取本地终结点。</summary>
  151. <returns>
  152. <see cref="T:System.Net.Sockets.Socket" /> 当前用以进行通信的 <see cref="T:System.Net.EndPoint" />。</returns>
  153. <exception cref="T:System.Net.Sockets.SocketException">试图访问套接字时发生错误。有关更多信息,请参见备注部分。</exception>
  154. <exception cref="T:System.ObjectDisposedException">
  155. <see cref="T:System.Net.Sockets.Socket" /> 已关闭。</exception>
  156. <PermissionSet>
  157. <IPermission class="System.Security.Permissions.EnvironmentPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  158. <IPermission class="System.Security.Permissions.FileIOPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  159. <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
  160. </PermissionSet>
  161. </member>
  162. <member name="P:System.Net.Sockets.Socket.NoDelay">
  163. <summary>获取或设置 <see cref="T:System.Boolean" /> 值,该值指定流 <see cref="T:System.Net.Sockets.Socket" /> 是否正在使用 Nagle 算法。</summary>
  164. <returns>如果 <see cref="T:System.Net.Sockets.Socket" /> 使用 Nagle 算法,则为 false;否则为 true。默认值为 false。</returns>
  165. <exception cref="T:System.Net.Sockets.SocketException">试图访问 <see cref="T:System.Net.Sockets.Socket" /> 时发生错误。有关更多信息,请参见备注部分。</exception>
  166. <exception cref="T:System.ObjectDisposedException">
  167. <see cref="T:System.Net.Sockets.Socket" /> 已关闭。</exception>
  168. <PermissionSet>
  169. <IPermission class="System.Security.Permissions.EnvironmentPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  170. <IPermission class="System.Security.Permissions.FileIOPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  171. <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  172. </PermissionSet>
  173. </member>
  174. <member name="P:System.Net.Sockets.Socket.OSSupportsIPv4">
  175. <summary>指示基础操作系统和网络适配器是否支持 Internet 协议第 4 版 (IPv4)。</summary>
  176. <returns>如果操作系统和网络适配器支持 IPv4 协议,则为 true;否则为 false。</returns>
  177. </member>
  178. <member name="P:System.Net.Sockets.Socket.OSSupportsIPv6">
  179. <summary>指示基础操作系统和网络适配器是否支持 Internet 协议第 6 版 (IPv6)。</summary>
  180. <returns>如果操作系统和网络适配器支持 IPv6 协议,则为 true;否则为 false。</returns>
  181. </member>
  182. <member name="P:System.Net.Sockets.Socket.ProtocolType">
  183. <summary>获取 <see cref="T:System.Net.Sockets.Socket" /> 的协议类型。</summary>
  184. <returns>
  185. <see cref="T:System.Net.Sockets.ProtocolType" /> 值之一。</returns>
  186. </member>
  187. <member name="M:System.Net.Sockets.Socket.ReceiveAsync(System.Net.Sockets.SocketAsyncEventArgs)">
  188. <summary>开始一个异步请求以便从连接的 <see cref="T:System.Net.Sockets.Socket" /> 对象中接收数据。</summary>
  189. <returns>如果 I/O 操作挂起,将返回 true。操作完成时,将引发 <paramref name="e" /> 参数的 <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> 事件。如果 I/O 操作同步完成,将返回 false。在这种情况下,将不会引发 <paramref name="e" /> 参数的 <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> 事件,并且可能在方法调用返回后立即检查作为参数传递的 <paramref name="e" /> 对象以检索操作的结果。</returns>
  190. <param name="e">要用于此异步套接字操作的 <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> 对象。</param>
  191. <exception cref="T:System.ArgumentException">参数无效。<paramref name="e" /> 参数的 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.Buffer" /> 或 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.BufferList" /> 属性必须引用有效的缓冲区。可以设置这两个属性中的某一个,但不能同时设置这两个属性。</exception>
  192. <exception cref="T:System.InvalidOperationException">已经在使用 <paramref name="e" /> 参数中指定的 <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> 对象执行套接字操作。</exception>
  193. <exception cref="T:System.NotSupportedException">此方法需要 Windows XP 或更高版本。</exception>
  194. <exception cref="T:System.ObjectDisposedException">
  195. <see cref="T:System.Net.Sockets.Socket" /> 已关闭。</exception>
  196. <exception cref="T:System.Net.Sockets.SocketException">试图访问套接字时发生错误。有关更多信息,请参见备注部分。</exception>
  197. </member>
  198. <member name="P:System.Net.Sockets.Socket.ReceiveBufferSize">
  199. <summary>获取或设置一个值,它指定 <see cref="T:System.Net.Sockets.Socket" /> 接收缓冲区的大小。</summary>
  200. <returns>
  201. <see cref="T:System.Int32" />,它包含接收缓冲区的大小(以字节为单位)。默认值为 8192。</returns>
  202. <exception cref="T:System.Net.Sockets.SocketException">试图访问套接字时发生错误。</exception>
  203. <exception cref="T:System.ObjectDisposedException">
  204. <see cref="T:System.Net.Sockets.Socket" /> 已关闭。</exception>
  205. <exception cref="T:System.ArgumentOutOfRangeException">为设置操作指定的值小于 0。</exception>
  206. <PermissionSet>
  207. <IPermission class="System.Security.Permissions.EnvironmentPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  208. <IPermission class="System.Security.Permissions.FileIOPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  209. <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  210. </PermissionSet>
  211. </member>
  212. <member name="M:System.Net.Sockets.Socket.ReceiveFromAsync(System.Net.Sockets.SocketAsyncEventArgs)">
  213. <summary>开始从指定网络设备中异步接收数据。</summary>
  214. <returns>如果 I/O 操作挂起,将返回 true。操作完成时,将引发 <paramref name="e" /> 参数的 <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> 事件。如果 I/O 操作同步完成,将返回 false。在这种情况下,将不会引发 <paramref name="e" /> 参数的 <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> 事件,并且可能在方法调用返回后立即检查作为参数传递的 <paramref name="e" /> 对象以检索操作的结果。</returns>
  215. <param name="e">要用于此异步套接字操作的 <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> 对象。</param>
  216. <exception cref="T:System.ArgumentNullException">
  217. <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.RemoteEndPoint" /> 不能为 null。</exception>
  218. <exception cref="T:System.InvalidOperationException">已经在使用 <paramref name="e" /> 参数中指定的 <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> 对象执行套接字操作。</exception>
  219. <exception cref="T:System.NotSupportedException">此方法需要 Windows XP 或更高版本。</exception>
  220. <exception cref="T:System.ObjectDisposedException">
  221. <see cref="T:System.Net.Sockets.Socket" /> 已关闭。</exception>
  222. <exception cref="T:System.Net.Sockets.SocketException">试图访问套接字时发生错误。</exception>
  223. </member>
  224. <member name="P:System.Net.Sockets.Socket.RemoteEndPoint">
  225. <summary>获取远程终结点。</summary>
  226. <returns>当前和 <see cref="T:System.Net.Sockets.Socket" /> 通信的 <see cref="T:System.Net.EndPoint" />。</returns>
  227. <exception cref="T:System.Net.Sockets.SocketException">试图访问套接字时发生错误。有关更多信息,请参见备注部分。</exception>
  228. <exception cref="T:System.ObjectDisposedException">
  229. <see cref="T:System.Net.Sockets.Socket" /> 已关闭。</exception>
  230. <PermissionSet>
  231. <IPermission class="System.Security.Permissions.EnvironmentPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  232. <IPermission class="System.Security.Permissions.FileIOPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  233. <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
  234. </PermissionSet>
  235. </member>
  236. <member name="M:System.Net.Sockets.Socket.SendAsync(System.Net.Sockets.SocketAsyncEventArgs)">
  237. <summary>将数据异步发送到连接的 <see cref="T:System.Net.Sockets.Socket" /> 对象。</summary>
  238. <returns>如果 I/O 操作挂起,将返回 true。操作完成时,将引发 <paramref name="e" /> 参数的 <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> 事件。如果 I/O 操作同步完成,将返回 false。在这种情况下,将不会引发 <paramref name="e" /> 参数的 <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> 事件,并且可能在方法调用返回后立即检查作为参数传递的 <paramref name="e" /> 对象以检索操作的结果。</returns>
  239. <param name="e">要用于此异步套接字操作的 <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> 对象。</param>
  240. <exception cref="T:System.ArgumentException">
  241. <paramref name="e" /> 参数的 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.Buffer" /> 或 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.BufferList" /> 属性必须引用有效的缓冲区。可以设置这两个属性中的某一个,但不能同时设置这两个属性。</exception>
  242. <exception cref="T:System.InvalidOperationException">已经在使用 <paramref name="e" /> 参数中指定的 <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> 对象执行套接字操作。</exception>
  243. <exception cref="T:System.NotSupportedException">此方法需要 Windows XP 或更高版本。</exception>
  244. <exception cref="T:System.ObjectDisposedException">
  245. <see cref="T:System.Net.Sockets.Socket" /> 已关闭。</exception>
  246. <exception cref="T:System.Net.Sockets.SocketException">
  247. <see cref="T:System.Net.Sockets.Socket" /> 尚未连接或者尚未通过 <see cref="M:System.Net.Sockets.Socket.Accept" />、<see cref="M:System.Net.Sockets.Socket.AcceptAsync(System.Net.Sockets.SocketAsyncEventArgs)" /> 或 <see cref="Overload:System.Net.Sockets.Socket.BeginAccept" /> 方法获得。</exception>
  248. </member>
  249. <member name="P:System.Net.Sockets.Socket.SendBufferSize">
  250. <summary>获取或设置一个值,该值指定 <see cref="T:System.Net.Sockets.Socket" /> 发送缓冲区的大小。</summary>
  251. <returns>
  252. <see cref="T:System.Int32" />,它包含发送缓冲区的大小(以字节为单位)。默认值为 8192。</returns>
  253. <exception cref="T:System.Net.Sockets.SocketException">试图访问套接字时发生错误。</exception>
  254. <exception cref="T:System.ObjectDisposedException">
  255. <see cref="T:System.Net.Sockets.Socket" /> 已关闭。</exception>
  256. <exception cref="T:System.ArgumentOutOfRangeException">为设置操作指定的值小于 0。</exception>
  257. <PermissionSet>
  258. <IPermission class="System.Security.Permissions.EnvironmentPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  259. <IPermission class="System.Security.Permissions.FileIOPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  260. <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  261. </PermissionSet>
  262. </member>
  263. <member name="M:System.Net.Sockets.Socket.SendToAsync(System.Net.Sockets.SocketAsyncEventArgs)">
  264. <summary>向特定远程主机异步发送数据。</summary>
  265. <returns>如果 I/O 操作挂起,将返回 true。操作完成时,将引发 <paramref name="e" /> 参数的 <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> 事件。如果 I/O 操作同步完成,将返回 false。在这种情况下,将不会引发 <paramref name="e" /> 参数的 <see cref="E:System.Net.Sockets.SocketAsyncEventArgs.Completed" /> 事件,并且可能在方法调用返回后立即检查作为参数传递的 <paramref name="e" /> 对象以检索操作的结果。</returns>
  266. <param name="e">要用于此异步套接字操作的 <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> 对象。</param>
  267. <exception cref="T:System.ArgumentNullException">
  268. <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.RemoteEndPoint" /> 不能为 null。</exception>
  269. <exception cref="T:System.InvalidOperationException">已经在使用 <paramref name="e" /> 参数中指定的 <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> 对象执行套接字操作。</exception>
  270. <exception cref="T:System.NotSupportedException">此方法需要 Windows XP 或更高版本。</exception>
  271. <exception cref="T:System.ObjectDisposedException">
  272. <see cref="T:System.Net.Sockets.Socket" /> 已关闭。</exception>
  273. <exception cref="T:System.Net.Sockets.SocketException">指定的协议是面向连接的,但 <see cref="T:System.Net.Sockets.Socket" /> 尚未连接。</exception>
  274. </member>
  275. <member name="M:System.Net.Sockets.Socket.Shutdown(System.Net.Sockets.SocketShutdown)">
  276. <summary>禁用某 <see cref="T:System.Net.Sockets.Socket" /> 上的发送和接收。</summary>
  277. <param name="how">
  278. <see cref="T:System.Net.Sockets.SocketShutdown" /> 值之一,它指定不再允许执行的操作。</param>
  279. <exception cref="T:System.Net.Sockets.SocketException">试图访问套接字时发生错误。有关更多信息,请参见备注部分。</exception>
  280. <exception cref="T:System.ObjectDisposedException">
  281. <see cref="T:System.Net.Sockets.Socket" /> 已关闭。</exception>
  282. <PermissionSet>
  283. <IPermission class="System.Security.Permissions.EnvironmentPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  284. <IPermission class="System.Security.Permissions.FileIOPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  285. <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Flags="UnmanagedCode, ControlEvidence" />
  286. </PermissionSet>
  287. </member>
  288. <member name="P:System.Net.Sockets.Socket.Ttl">
  289. <summary>获取或设置一个值,指定 <see cref="T:System.Net.Sockets.Socket" /> 发送的 Internet 协议 (IP) 数据包的生存时间 (TTL) 值。</summary>
  290. <returns>TTL 值。</returns>
  291. <exception cref="T:System.ArgumentOutOfRangeException">TTL 值不能设置为负数。</exception>
  292. <exception cref="T:System.NotSupportedException">只有对于在 <see cref="F:System.Net.Sockets.AddressFamily.InterNetwork" /> 或 <see cref="F:System.Net.Sockets.AddressFamily.InterNetworkV6" /> 族中的套接字,才可以设置此属性。</exception>
  293. <exception cref="T:System.Net.Sockets.SocketException">试图访问套接字时发生错误。在尝试将 TTL 设置为大于 255 的值时,也将返回此错误。</exception>
  294. <exception cref="T:System.ObjectDisposedException">
  295. <see cref="T:System.Net.Sockets.Socket" /> 已关闭。</exception>
  296. <PermissionSet>
  297. <IPermission class="System.Security.Permissions.EnvironmentPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  298. <IPermission class="System.Security.Permissions.FileIOPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  299. <IPermission class="System.Security.Permissions.SecurityPermission, mscorlib, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" version="1" Unrestricted="true" />
  300. </PermissionSet>
  301. </member>
  302. <member name="T:System.Net.Sockets.SocketAsyncEventArgs">
  303. <summary>表示异步套接字操作。</summary>
  304. </member>
  305. <member name="M:System.Net.Sockets.SocketAsyncEventArgs.#ctor">
  306. <summary>创建一个空的 <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> 实例。</summary>
  307. <exception cref="T:System.NotSupportedException">该平台不受支持。</exception>
  308. </member>
  309. <member name="P:System.Net.Sockets.SocketAsyncEventArgs.AcceptSocket">
  310. <summary>获取或设置要使用的套接字或创建用于接受与异步套接字方法的连接的套接字。</summary>
  311. <returns>要使用的 <see cref="T:System.Net.Sockets.Socket" /> 或者创建用于接受与异步套接字方法的连接的套接字。</returns>
  312. </member>
  313. <member name="P:System.Net.Sockets.SocketAsyncEventArgs.Buffer">
  314. <summary>获取要用于异步套接字方法的数据缓冲区。</summary>
  315. <returns>一个 <see cref="T:System.Byte" /> 数组,表示要用于异步套接字方法的数据缓冲区。</returns>
  316. </member>
  317. <member name="P:System.Net.Sockets.SocketAsyncEventArgs.BufferList">
  318. <summary>获取或设置一个要用于异步套接字方法的数据缓冲区数组。</summary>
  319. <returns>一个 <see cref="T:System.Collections.IList" />,表示要用于异步套接字方法的数据缓冲区数组。</returns>
  320. <exception cref="T:System.ArgumentException">存在不明确的缓冲区,这些缓冲区是在 set 操作上指定的。如果 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.Buffer" /> 属性已设置为非空值并且尝试将 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.BufferList" /> 属性设置为非空值,将引发此异常。</exception>
  321. </member>
  322. <member name="P:System.Net.Sockets.SocketAsyncEventArgs.BytesTransferred">
  323. <summary>获取在套接字操作中传输的字节数。</summary>
  324. <returns>一个 <see cref="T:System.Int32" />,包含在套接字操作中传输的字节数。</returns>
  325. </member>
  326. <member name="E:System.Net.Sockets.SocketAsyncEventArgs.Completed">
  327. <summary>用于完成异步操作的事件。</summary>
  328. </member>
  329. <member name="P:System.Net.Sockets.SocketAsyncEventArgs.ConnectByNameError">
  330. <summary>当使用 <see cref="T:System.Net.DnsEndPoint" /> 时,在出现连接故障的情况下获取异常。</summary>
  331. <returns>一个 <see cref="T:System.Exception" />,指示在为 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.RemoteEndPoint" /> 属性指定 <see cref="T:System.Net.DnsEndPoint" /> 时发生连接错误的原因。</returns>
  332. </member>
  333. <member name="P:System.Net.Sockets.SocketAsyncEventArgs.ConnectSocket">
  334. <summary>成功完成 <see cref="Overload:System.Net.Sockets.Socket.ConnectAsync" /> 方法后创建和连接的 <see cref="T:System.Net.Sockets.Socket" /> 对象。</summary>
  335. <returns>连接的 <see cref="T:System.Net.Sockets.Socket" /> 对象。</returns>
  336. </member>
  337. <member name="P:System.Net.Sockets.SocketAsyncEventArgs.Count">
  338. <summary>获取可在异步操作中发送或接收的最大数据量(以字节为单位)。</summary>
  339. <returns>一个 <see cref="T:System.Int32" />,包含可发送或接收的最大数据量(以字节为单位)。</returns>
  340. </member>
  341. <member name="M:System.Net.Sockets.SocketAsyncEventArgs.Dispose">
  342. <summary>释放由 <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> 实例使用的非托管资源,并可选择释放托管资源。</summary>
  343. </member>
  344. <member name="M:System.Net.Sockets.SocketAsyncEventArgs.Finalize">
  345. <summary>释放 <see cref="T:System.Net.Sockets.SocketAsyncEventArgs" /> 类使用的资源。</summary>
  346. </member>
  347. <member name="P:System.Net.Sockets.SocketAsyncEventArgs.LastOperation">
  348. <summary>获取最近使用此上下文对象执行的套接字操作类型。</summary>
  349. <returns>一个 <see cref="T:System.Net.Sockets.SocketAsyncOperation" /> 实例,指示最近使用此上下文对象执行的套接字操作类型。</returns>
  350. </member>
  351. <member name="P:System.Net.Sockets.SocketAsyncEventArgs.Offset">
  352. <summary>获取 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.Buffer" /> 属性引用的数据缓冲区的偏移量(以字节为单位)。</summary>
  353. <returns>一个 <see cref="T:System.Int32" />,包含 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.Buffer" /> 属性引用的数据缓冲区的偏移量(以字节为单位)。</returns>
  354. </member>
  355. <member name="M:System.Net.Sockets.SocketAsyncEventArgs.OnCompleted(System.Net.Sockets.SocketAsyncEventArgs)">
  356. <summary>表示异步操作完成时调用的方法。</summary>
  357. <param name="e">终止的事件。</param>
  358. </member>
  359. <member name="P:System.Net.Sockets.SocketAsyncEventArgs.RemoteEndPoint">
  360. <summary>获取或设置异步操作的远程 IP 终结点。</summary>
  361. <returns>一个 <see cref="T:System.Net.EndPoint" />,表示异步操作的远程 IP 终结点。</returns>
  362. </member>
  363. <member name="M:System.Net.Sockets.SocketAsyncEventArgs.SetBuffer(System.Byte[],System.Int32,System.Int32)">
  364. <summary>设置要用于异步套接字方法的数据缓冲区。</summary>
  365. <param name="buffer">要用于异步套接字方法的数据缓冲区。</param>
  366. <param name="offset">数据缓冲区中操作开始位置处的偏移量,以字节为单位。</param>
  367. <param name="count">可在缓冲区中发送或接收的最大数据量(以字节为单位)。</param>
  368. <exception cref="T:System.ArgumentException">指定的缓冲区不明确。如果 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.Buffer" /> 属性不为 null,<see cref="P:System.Net.Sockets.SocketAsyncEventArgs.BufferList" /> 属性也不为 null,将发生此异常。</exception>
  369. <exception cref="T:System.ArgumentOutOfRangeException">参数超出范围。如果 <paramref name="offset" /> 参数小于零或大于 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.Buffer" /> 属性中的数组长度,将发生此异常。如果 <paramref name="count" /> 参数小于零或大于 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.Buffer" /> 属性中的数组长度减去 <paramref name="offset" /> 参数的值,也会发生此异常。</exception>
  370. </member>
  371. <member name="M:System.Net.Sockets.SocketAsyncEventArgs.SetBuffer(System.Int32,System.Int32)">
  372. <summary>设置要用于异步套接字方法的数据缓冲区。</summary>
  373. <param name="offset">数据缓冲区中操作开始位置处的偏移量,以字节为单位。</param>
  374. <param name="count">可在缓冲区中发送或接收的最大数据量(以字节为单位)。</param>
  375. <exception cref="T:System.ArgumentOutOfRangeException">参数超出范围。如果 <paramref name="offset" /> 参数小于零或大于 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.Buffer" /> 属性中的数组长度,将发生此异常。如果 <paramref name="count" /> 参数小于零或大于 <see cref="P:System.Net.Sockets.SocketAsyncEventArgs.Buffer" /> 属性中的数组长度减去 <paramref name="offset" /> 参数的值,也会发生此异常。</exception>
  376. </member>
  377. <member name="P:System.Net.Sockets.SocketAsyncEventArgs.SocketError">
  378. <summary>获取或设置异步套接字操作的结果。</summary>
  379. <returns>一个 <see cref="T:System.Net.Sockets.SocketError" />,表示异步套接字操作的结果。</returns>
  380. </member>
  381. <member name="P:System.Net.Sockets.SocketAsyncEventArgs.UserToken">
  382. <summary>获取或设置与此异步套接字操作关联的用户或应用程序对象。</summary>
  383. <returns>一个对象,表示与此异步套接字操作关联的用户或应用程序对象。</returns>
  384. </member>
  385. <member name="T:System.Net.Sockets.SocketAsyncOperation">
  386. <summary>最近使用此上下文对象执行的异步套接字操作的类型。</summary>
  387. </member>
  388. <member name="F:System.Net.Sockets.SocketAsyncOperation.Accept">
  389. <summary>一个套接字 Accept 操作。</summary>
  390. </member>
  391. <member name="F:System.Net.Sockets.SocketAsyncOperation.Connect">
  392. <summary>一个套接字 Connect 操作。</summary>
  393. </member>
  394. <member name="F:System.Net.Sockets.SocketAsyncOperation.None">
  395. <summary>没有套接字操作。</summary>
  396. </member>
  397. <member name="F:System.Net.Sockets.SocketAsyncOperation.Receive">
  398. <summary>一个套接字 Receive 操作。</summary>
  399. </member>
  400. <member name="F:System.Net.Sockets.SocketAsyncOperation.ReceiveFrom">
  401. <summary>一个套接字 ReceiveFrom 操作。</summary>
  402. </member>
  403. <member name="F:System.Net.Sockets.SocketAsyncOperation.Send">
  404. <summary>一个套接字 Send 操作。</summary>
  405. </member>
  406. <member name="F:System.Net.Sockets.SocketAsyncOperation.SendTo">
  407. <summary>一个套接字 SendTo 操作。</summary>
  408. </member>
  409. <member name="T:System.Net.Sockets.SocketShutdown">
  410. <summary>定义 <see cref="M:System.Net.Sockets.Socket.Shutdown(System.Net.Sockets.SocketShutdown)" /> 方法使用的常量。</summary>
  411. </member>
  412. <member name="F:System.Net.Sockets.SocketShutdown.Both">
  413. <summary>为发送和接收禁用 <see cref="T:System.Net.Sockets.Socket" />。此字段为常数。</summary>
  414. </member>
  415. <member name="F:System.Net.Sockets.SocketShutdown.Receive">
  416. <summary>禁用接收的 <see cref="T:System.Net.Sockets.Socket" />。此字段为常数。</summary>
  417. </member>
  418. <member name="F:System.Net.Sockets.SocketShutdown.Send">
  419. <summary>禁用发送的 <see cref="T:System.Net.Sockets.Socket" />。此字段为常数。</summary>
  420. </member>
  421. <member name="T:System.Net.Sockets.SocketType">
  422. <summary>指定 <see cref="T:System.Net.Sockets.Socket" /> 类的实例表示的套接字类型。</summary>
  423. </member>
  424. <member name="F:System.Net.Sockets.SocketType.Dgram">
  425. <summary>支持数据报,即最大长度固定(通常很小)的无连接、不可靠消息。消息可能会丢失或重复并可能在到达时不按顺序排列。<see cref="F:System.Net.Sockets.SocketType.Dgram" /> 类型的 <see cref="T:System.Net.Sockets.Socket" /> 在发送和接收数据之前不需要任何连接,并且可以与多个对方主机进行通信。<see cref="F:System.Net.Sockets.SocketType.Dgram" /> 使用数据报协议 (<see cref="F:System.Net.Sockets.ProtocolType.Udp" />) 和 <see cref="F:System.Net.Sockets.AddressFamily.InterNetwork" /><see cref="T:System.Net.Sockets.AddressFamily" />。</summary>
  426. </member>
  427. <member name="F:System.Net.Sockets.SocketType.Stream">
  428. <summary>支持可靠、双向、基于连接的字节流,而不重复数据,也不保留边界。此类型的 Socket 与单个对方主机通信,并且在通信开始之前需要建立远程主机连接。<see cref="F:System.Net.Sockets.SocketType.Stream" /> 使用传输控制协议 (<see cref="F:System.Net.Sockets.ProtocolType.Tcp" />) <see cref="T:System.Net.Sockets.ProtocolType" /> 和 InterNetwork<see cref="T:System.Net.Sockets.AddressFamily" />。</summary>
  429. </member>
  430. <member name="F:System.Net.Sockets.SocketType.Unknown">
  431. <summary>指定未知的 Socket 类型。</summary>
  432. </member>
  433. </members>
  434. </doc>