System.Net.Security.xml 46 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <doc>
  3. <assembly>
  4. <name>System.Net.Security</name>
  5. </assembly>
  6. <members>
  7. <member name="T:System.Net.Security.EncryptionPolicy">
  8. <summary>要使用的 EncryptionPolicy。</summary>
  9. </member>
  10. <member name="F:System.Net.Security.EncryptionPolicy.AllowNoEncryption">
  11. <summary>虽然优先考虑使用完全加密,但若获得服务器同意,也可以使用 NULL 密码(不加密)。</summary>
  12. </member>
  13. <member name="F:System.Net.Security.EncryptionPolicy.NoEncryption">
  14. <summary>允许不加密,并要求在另一个终结点可以处理 NULL 密码的情况下使用 NULL 密码。</summary>
  15. </member>
  16. <member name="F:System.Net.Security.EncryptionPolicy.RequireEncryption">
  17. <summary>要求加密,并且绝不允许使用 NULL 密码。</summary>
  18. </member>
  19. <member name="T:System.Net.Security.LocalCertificateSelectionCallback">
  20. <summary>选择用于身份验证的本地安全套接字层 (SSL) 证书。</summary>
  21. <returns>
  22. <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> 用于建立 SSL 连接。</returns>
  23. <param name="sender">一个对象,它包含此验证的状态信息。</param>
  24. <param name="targetHost">客户端指定的主机服务器。</param>
  25. <param name="localCertificates">
  26. <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection" /> 包含本地证书。</param>
  27. <param name="remoteCertificate">用于对远程方进行身份验证的证书。</param>
  28. <param name="acceptableIssuers">远程方可接受的证书颁发者的 <see cref="T:System.String" /> 数组。</param>
  29. </member>
  30. <member name="T:System.Net.Security.RemoteCertificateValidationCallback">
  31. <summary>验证用于身份验证的远程安全套接字层 (SSL) 证书。</summary>
  32. <returns>
  33. <see cref="T:System.Boolean" /> 值,它确定是否接受指定证书进行身份验证。</returns>
  34. <param name="sender">一个对象,它包含此验证的状态信息。</param>
  35. <param name="certificate">用于对远程方进行身份验证的证书。</param>
  36. <param name="chain">与远程证书关联的证书颁发机构链。</param>
  37. <param name="sslPolicyErrors">与远程证书关联的一个或多个错误。</param>
  38. </member>
  39. <member name="T:System.Net.Security.SslStream">
  40. <summary>提供一个用于客户端-服务器通信的流,此流使用安全套接字层 (SSL) 安全协议对服务器及客户端(可选)进行身份验证。</summary>
  41. </member>
  42. <member name="M:System.Net.Security.SslStream.#ctor(System.IO.Stream)">
  43. <summary>使用指定 <see cref="T:System.IO.Stream" /> 初始化 <see cref="T:System.Net.Security.SslStream" /> 类的新实例。</summary>
  44. <param name="innerStream">
  45. <see cref="T:System.IO.Stream" /> 对象,<see cref="T:System.Net.Security.SslStream" /> 使用此对象发送和接收数据。</param>
  46. <exception cref="T:System.ArgumentException">
  47. <paramref name="innerStream" /> 不可读。- 或 -<paramref name="innerStream" /> 不可写。</exception>
  48. <exception cref="T:System.ArgumentNullException">
  49. <paramref name="innerStream" /> 为 null。- 或 -<paramref name="innerStream" /> 等于 <see cref="F:System.IO.Stream.Null" />。</exception>
  50. </member>
  51. <member name="M:System.Net.Security.SslStream.#ctor(System.IO.Stream,System.Boolean)">
  52. <summary>使用指定的 <see cref="T:System.IO.Stream" /> 和流封闭行为初始化 <see cref="T:System.Net.Security.SslStream" /> 类的新实例。</summary>
  53. <param name="innerStream">
  54. <see cref="T:System.IO.Stream" /> 对象,<see cref="T:System.Net.Security.SslStream" /> 使用此对象发送和接收数据。</param>
  55. <param name="leaveInnerStreamOpen">一个布尔值,它指示 <see cref="T:System.Net.Security.SslStream" /> 用来发送和接收数据的 <see cref="T:System.IO.Stream" /> 对象的封闭行为。此参数指示内部流是否保持打开状态。</param>
  56. <exception cref="T:System.ArgumentException">
  57. <paramref name="innerStream" /> 不可读。- 或 -<paramref name="innerStream" /> 不可写。</exception>
  58. <exception cref="T:System.ArgumentNullException">
  59. <paramref name="innerStream" /> 为 null。- 或 -<paramref name="innerStream" /> 等于 <see cref="F:System.IO.Stream.Null" />。</exception>
  60. </member>
  61. <member name="M:System.Net.Security.SslStream.#ctor(System.IO.Stream,System.Boolean,System.Net.Security.RemoteCertificateValidationCallback)">
  62. <summary>使用指定的 <see cref="T:System.IO.Stream" />、流关闭行为和证书验证委托初始化 <see cref="T:System.Net.Security.SslStream" /> 类的新实例。</summary>
  63. <param name="innerStream">
  64. <see cref="T:System.IO.Stream" /> 对象,<see cref="T:System.Net.Security.SslStream" /> 使用此对象发送和接收数据。</param>
  65. <param name="leaveInnerStreamOpen">一个布尔值,它指示 <see cref="T:System.Net.Security.SslStream" /> 用来发送和接收数据的 <see cref="T:System.IO.Stream" /> 对象的封闭行为。此参数指示内部流是否保持打开状态。</param>
  66. <param name="userCertificateValidationCallback">
  67. <see cref="T:System.Net.Security.RemoteCertificateValidationCallback" /> 委托,负责验证远程方提供的证书。</param>
  68. <exception cref="T:System.ArgumentException">
  69. <paramref name="innerStream" /> 不可读。- 或 -<paramref name="innerStream" /> 不可写。</exception>
  70. <exception cref="T:System.ArgumentNullException">
  71. <paramref name="innerStream" /> 为 null。- 或 -<paramref name="innerStream" /> 等于 <see cref="F:System.IO.Stream.Null" />。</exception>
  72. </member>
  73. <member name="M:System.Net.Security.SslStream.#ctor(System.IO.Stream,System.Boolean,System.Net.Security.RemoteCertificateValidationCallback,System.Net.Security.LocalCertificateSelectionCallback)">
  74. <summary>使用指定的 <see cref="T:System.IO.Stream" />、流关闭行为、证书验证委托和证书选择委托初始化 <see cref="T:System.Net.Security.SslStream" /> 类的新实例。</summary>
  75. <param name="innerStream">
  76. <see cref="T:System.IO.Stream" /> 对象,<see cref="T:System.Net.Security.SslStream" /> 使用此对象发送和接收数据。</param>
  77. <param name="leaveInnerStreamOpen">一个布尔值,它指示 <see cref="T:System.Net.Security.SslStream" /> 用来发送和接收数据的 <see cref="T:System.IO.Stream" /> 对象的封闭行为。此参数指示内部流是否保持打开状态。</param>
  78. <param name="userCertificateValidationCallback">
  79. <see cref="T:System.Net.Security.RemoteCertificateValidationCallback" /> 委托,负责验证远程方提供的证书。</param>
  80. <param name="userCertificateSelectionCallback">
  81. <see cref="T:System.Net.Security.LocalCertificateSelectionCallback" /> 委托,负责选择用于身份验证的证书。</param>
  82. <exception cref="T:System.ArgumentException">
  83. <paramref name="innerStream" /> 不可读。- 或 -<paramref name="innerStream" /> 不可写。</exception>
  84. <exception cref="T:System.ArgumentNullException">
  85. <paramref name="innerStream" /> 为 null。- 或 -<paramref name="innerStream" /> 等于 <see cref="F:System.IO.Stream.Null" />。</exception>
  86. </member>
  87. <member name="M:System.Net.Security.SslStream.#ctor(System.IO.Stream,System.Boolean,System.Net.Security.RemoteCertificateValidationCallback,System.Net.Security.LocalCertificateSelectionCallback,System.Net.Security.EncryptionPolicy)">
  88. <summary>使用指定的 <see cref="T:System.IO.Stream" /> 初始化 <see cref="T:System.Net.Security.SslStream" /> 类的新实例</summary>
  89. <param name="innerStream">
  90. <see cref="T:System.IO.Stream" /> 对象,<see cref="T:System.Net.Security.SslStream" /> 使用此对象发送和接收数据。</param>
  91. <param name="leaveInnerStreamOpen">一个布尔值,它指示 <see cref="T:System.Net.Security.SslStream" /> 用来发送和接收数据的 <see cref="T:System.IO.Stream" /> 对象的封闭行为。此参数指示内部流是否保持打开状态。</param>
  92. <param name="userCertificateValidationCallback">
  93. <see cref="T:System.Net.Security.RemoteCertificateValidationCallback" /> 委托,负责验证远程方提供的证书。</param>
  94. <param name="userCertificateSelectionCallback">
  95. <see cref="T:System.Net.Security.LocalCertificateSelectionCallback" /> 委托,负责选择用于身份验证的证书。</param>
  96. <param name="encryptionPolicy">要使用的 <see cref="T:System.Net.Security.EncryptionPolicy" />。</param>
  97. <exception cref="T:System.ArgumentException">
  98. <paramref name="innerStream" /> 不可读。- 或 -<paramref name="innerStream" /> 不可写。- 或 -<paramref name="encryptionPolicy" /> 无效。</exception>
  99. <exception cref="T:System.ArgumentNullException">
  100. <paramref name="innerStream" /> 为 null。- 或 -<paramref name="innerStream" /> 等于 <see cref="F:System.IO.Stream.Null" />。</exception>
  101. </member>
  102. <member name="M:System.Net.Security.SslStream.AuthenticateAsClient(System.String)">
  103. <summary>客户端调用此方法,以便对客户端-服务器连接中的服务器及客户端(可选)进行身份验证。</summary>
  104. <param name="targetHost">共享此 <see cref="T:System.Net.Security.SslStream" /> 的服务器的名称。</param>
  105. <exception cref="T:System.ArgumentNullException">
  106. <paramref name="targetHost" /> 为 null。</exception>
  107. <exception cref="T:System.Security.Authentication.AuthenticationException">身份验证失败,此对象处于不可用状态。</exception>
  108. <exception cref="T:System.InvalidOperationException">已进行了身份验证。- 或 -此前已尝试过使用此 <see cref="T:System.Net.Security.SslStream" /> 进行服务器身份验证。- 或 -身份验证已在进行。</exception>
  109. <exception cref="T:System.ObjectDisposedException">此对象已关闭。</exception>
  110. </member>
  111. <member name="M:System.Net.Security.SslStream.AuthenticateAsClient(System.String,System.Security.Cryptography.X509Certificates.X509CertificateCollection,System.Security.Authentication.SslProtocols,System.Boolean)">
  112. <summary>客户端调用此方法,以便对客户端-服务器连接中的服务器及客户端(可选)进行身份验证。身份验证过程使用指定的证书集合和 SSL 协议。</summary>
  113. <param name="targetHost">将共享此 <see cref="T:System.Net.Security.SslStream" /> 的服务器的名称。</param>
  114. <param name="clientCertificates">包含客户端证书的 <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection" />。</param>
  115. <param name="enabledSslProtocols">代表用于身份验证的协议的 <see cref="T:System.Security.Authentication.SslProtocols" /> 值。</param>
  116. <param name="checkCertificateRevocation">一个 <see cref="T:System.Boolean" /> 值,指定在身份验证过程中是否检查证书吊销列表。</param>
  117. </member>
  118. <member name="M:System.Net.Security.SslStream.AuthenticateAsClientAsync(System.String)">
  119. <summary>客户端调用此方法,对客户端-服务器连接中的服务器及客户端(可选)进行身份验证以作为异步操作。</summary>
  120. <returns>返回 <see cref="T:System.Threading.Tasks.Task" />表示异步操作的任务对象。</returns>
  121. <param name="targetHost">共享此 <see cref="T:System.Net.Security.SslStream" /> 的服务器的名称。</param>
  122. <exception cref="T:System.ArgumentNullException">
  123. <paramref name="targetHost" /> 为 null。</exception>
  124. <exception cref="T:System.Security.Authentication.AuthenticationException">身份验证失败,此对象处于不可用状态。</exception>
  125. <exception cref="T:System.InvalidOperationException">已进行了身份验证。- 或 -此前已尝试过使用此 <see cref="T:System.Net.Security.SslStream" /> 进行服务器身份验证。- 或 -身份验证已在进行。</exception>
  126. <exception cref="T:System.ObjectDisposedException">此对象已关闭。</exception>
  127. </member>
  128. <member name="M:System.Net.Security.SslStream.AuthenticateAsClientAsync(System.String,System.Security.Cryptography.X509Certificates.X509CertificateCollection,System.Security.Authentication.SslProtocols,System.Boolean)">
  129. <summary>客户端调用此方法,对客户端-服务器连接中的服务器及客户端(可选)进行身份验证以作为异步操作。身份验证过程使用指定的证书集合和 SSL 协议。</summary>
  130. <returns>返回 <see cref="T:System.Threading.Tasks.Task" />表示异步操作的任务对象。</returns>
  131. <param name="targetHost">将共享此 <see cref="T:System.Net.Security.SslStream" /> 的服务器的名称。</param>
  132. <param name="clientCertificates">包含客户端证书的 <see cref="T:System.Security.Cryptography.X509Certificates.X509CertificateCollection" />。</param>
  133. <param name="enabledSslProtocols">代表用于身份验证的协议的 <see cref="T:System.Security.Authentication.SslProtocols" /> 值。</param>
  134. <param name="checkCertificateRevocation">一个 <see cref="T:System.Boolean" /> 值,指定在身份验证过程中是否检查证书吊销列表。</param>
  135. </member>
  136. <member name="M:System.Net.Security.SslStream.AuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate)">
  137. <summary>服务器调用此方法,以便使用指定的证书对客户端-服务器连接中的服务器及客户端(可选)进行身份验证。</summary>
  138. <param name="serverCertificate">用于对服务器进行身份验证的证书。</param>
  139. <exception cref="T:System.ArgumentNullException">
  140. <paramref name="serverCertificate" /> 为 null。</exception>
  141. <exception cref="T:System.Security.Authentication.AuthenticationException">身份验证失败,此对象处于不可用状态。</exception>
  142. <exception cref="T:System.InvalidOperationException">已进行了身份验证。- 或 -此前已尝试过使用此 <see cref="T:System.Net.Security.SslStream" /> 进行客户端身份验证。- 或 -身份验证已在进行。</exception>
  143. <exception cref="T:System.ObjectDisposedException">此对象已关闭。</exception>
  144. <exception cref="T:System.PlatformNotSupportedException">Windows 95、Windows 98 或 Windows Millennium 不支持 <see cref="Overload:System.Net.Security.SslStream.AuthenticateAsServer" /> 方法。</exception>
  145. </member>
  146. <member name="M:System.Net.Security.SslStream.AuthenticateAsServer(System.Security.Cryptography.X509Certificates.X509Certificate,System.Boolean,System.Security.Authentication.SslProtocols,System.Boolean)">
  147. <summary>服务器调用此方法,使用指定的证书、要求和安全协议对客户端-服务器连接中的服务器及客户端(可选)进行身份验证。</summary>
  148. <param name="serverCertificate">用于对服务器进行身份验证的 X509Certificate。</param>
  149. <param name="clientCertificateRequired">一个 <see cref="T:System.Boolean" /> 值,指定客户端是否必须为身份验证提供证书。</param>
  150. <param name="enabledSslProtocols">代表用于身份验证的协议的 <see cref="T:System.Security.Authentication.SslProtocols" /> 值。</param>
  151. <param name="checkCertificateRevocation">一个 <see cref="T:System.Boolean" /> 值,指定在身份验证过程中是否检查证书吊销列表。</param>
  152. <exception cref="T:System.ArgumentNullException">
  153. <paramref name="serverCertificate" /> 为 null。</exception>
  154. <exception cref="T:System.ArgumentException">
  155. <paramref name="enabledSslProtocols" /> 不是有效的 <see cref="T:System.Security.Authentication.SslProtocols" /> 值。</exception>
  156. <exception cref="T:System.Security.Authentication.AuthenticationException">身份验证失败,此对象处于不可用状态。</exception>
  157. <exception cref="T:System.InvalidOperationException">已进行了身份验证。- 或 -此前已尝试过使用此 <see cref="T:System.Net.Security.SslStream" /> 进行客户端身份验证。- 或 -身份验证已在进行。</exception>
  158. <exception cref="T:System.ObjectDisposedException">此对象已关闭。</exception>
  159. <exception cref="T:System.PlatformNotSupportedException">Windows 95、Windows 98 或 Windows Millennium 不支持 <see cref="Overload:System.Net.Security.SslStream.AuthenticateAsServer" /> 方法。</exception>
  160. </member>
  161. <member name="M:System.Net.Security.SslStream.AuthenticateAsServerAsync(System.Security.Cryptography.X509Certificates.X509Certificate)">
  162. <summary>服务器调用此方法,使用指定的证书对客户端-服务器连接中的服务器及客户端(可选)进行身份验证以作为异步操作。</summary>
  163. <returns>返回 <see cref="T:System.Threading.Tasks.Task" />表示异步操作的任务对象。</returns>
  164. <param name="serverCertificate">用于对服务器进行身份验证的证书。</param>
  165. <exception cref="T:System.ArgumentNullException">
  166. <paramref name="serverCertificate" /> 为 null。</exception>
  167. <exception cref="T:System.Security.Authentication.AuthenticationException">身份验证失败,此对象处于不可用状态。</exception>
  168. <exception cref="T:System.InvalidOperationException">已进行了身份验证。- 或 -此前已尝试过使用此 <see cref="T:System.Net.Security.SslStream" /> 进行客户端身份验证。- 或 -身份验证已在进行。</exception>
  169. <exception cref="T:System.ObjectDisposedException">此对象已关闭。</exception>
  170. <exception cref="T:System.PlatformNotSupportedException">Windows 95、Windows 98 或 Windows Millennium 不支持 <see cref="Overload:System.Net.Security.SslStream.AuthenticateAsServerAsync" /> 方法。</exception>
  171. </member>
  172. <member name="M:System.Net.Security.SslStream.AuthenticateAsServerAsync(System.Security.Cryptography.X509Certificates.X509Certificate,System.Boolean,System.Security.Authentication.SslProtocols,System.Boolean)">
  173. <summary>服务器调用此方法,使用指定的证书、要求和安全协议对客户端-服务器连接中的服务器及客户端(可选)进行身份验证以作为异步操作。</summary>
  174. <returns>返回 <see cref="T:System.Threading.Tasks.Task" />表示异步操作的任务对象。</returns>
  175. <param name="serverCertificate">用于对服务器进行身份验证的 X509Certificate。</param>
  176. <param name="clientCertificateRequired">一个 <see cref="T:System.Boolean" /> 值,指定客户端是否必须为身份验证提供证书。</param>
  177. <param name="enabledSslProtocols">代表用于身份验证的协议的 <see cref="T:System.Security.Authentication.SslProtocols" /> 值。</param>
  178. <param name="checkCertificateRevocation">一个 <see cref="T:System.Boolean" /> 值,指定在身份验证过程中是否检查证书吊销列表。</param>
  179. </member>
  180. <member name="P:System.Net.Security.SslStream.CanRead">
  181. <summary>获取一个 <see cref="T:System.Boolean" /> 值,该值指示基础流是否可读。</summary>
  182. <returns>如果已进行身份验证且基础流可读,则为 true;否则为 false。</returns>
  183. </member>
  184. <member name="P:System.Net.Security.SslStream.CanSeek">
  185. <summary>获取一个 <see cref="T:System.Boolean" /> 值,该值指示基础流是否可查找。</summary>
  186. <returns>该属性始终返回 false。</returns>
  187. </member>
  188. <member name="P:System.Net.Security.SslStream.CanTimeout">
  189. <summary>获取一个 <see cref="T:System.Boolean" /> 值,该值指示基础流是否支持超时。</summary>
  190. <returns>如果基础流支持超时,则为 true;否则为 false。</returns>
  191. </member>
  192. <member name="P:System.Net.Security.SslStream.CanWrite">
  193. <summary>获取一个 <see cref="T:System.Boolean" /> 值,该值指示基础流是否可写。</summary>
  194. <returns>如果已进行身份验证且基础流可写,则为 true;否则为 false。</returns>
  195. </member>
  196. <member name="P:System.Net.Security.SslStream.CheckCertRevocationStatus">
  197. <summary>获取一个 <see cref="T:System.Boolean" /> 值,该值指示在证书验证过程中是否检查证书吊销列表。</summary>
  198. <returns>如果检查证书吊销列表,则为 true;否则为 false。</returns>
  199. </member>
  200. <member name="P:System.Net.Security.SslStream.CipherAlgorithm">
  201. <summary>获取一个值,该值确定此 <see cref="T:System.Net.Security.SslStream" /> 使用的批量加密算法。</summary>
  202. <returns>一个 <see cref="T:System.Security.Authentication.CipherAlgorithmType" /> 值。</returns>
  203. <exception cref="T:System.InvalidOperationException">
  204. <see cref="P:System.Net.Security.SslStream.CipherAlgorithm" /> 属性是在身份验证过程未完成时访问的或者身份验证过程失败。</exception>
  205. </member>
  206. <member name="P:System.Net.Security.SslStream.CipherStrength">
  207. <summary>获取一个值,该值确定此 <see cref="T:System.Net.Security.SslStream" /> 使用的密码算法的强度。</summary>
  208. <returns>
  209. <see cref="T:System.Int32" /> 值,该值指定算法的强度(以位为单位)。</returns>
  210. </member>
  211. <member name="M:System.Net.Security.SslStream.Flush">
  212. <summary>导致所有缓冲数据都要写入基础设备。</summary>
  213. </member>
  214. <member name="P:System.Net.Security.SslStream.HashAlgorithm">
  215. <summary>获取用于生成消息身份验证代码 (MAC) 的算法。</summary>
  216. <returns>一个 <see cref="T:System.Security.Authentication.HashAlgorithmType" /> 值。</returns>
  217. <exception cref="T:System.InvalidOperationException">
  218. <see cref="P:System.Net.Security.SslStream.HashAlgorithm" /> 属性是在身份验证过程未完成时访问的或者身份验证过程失败。</exception>
  219. </member>
  220. <member name="P:System.Net.Security.SslStream.HashStrength">
  221. <summary>获取一个值,该值标识此实例使用的哈希算法的强度。</summary>
  222. <returns>一个 <see cref="T:System.Int32" /> 值,指定 <see cref="T:System.Security.Authentication.HashAlgorithmType" /> 算法的强度(以位为单位)。有效值为 128 或 160。</returns>
  223. </member>
  224. <member name="P:System.Net.Security.SslStream.KeyExchangeAlgorithm">
  225. <summary>获取此 <see cref="T:System.Net.Security.SslStream" /> 使用的密钥交换算法。</summary>
  226. <returns>一个 <see cref="T:System.Security.Authentication.ExchangeAlgorithmType" /> 值。</returns>
  227. </member>
  228. <member name="P:System.Net.Security.SslStream.KeyExchangeStrength">
  229. <summary>获取一个值,该值指示此实例使用的密钥交换算法的强度。</summary>
  230. <returns>一个 <see cref="T:System.Int32" /> 值,指定 <see cref="T:System.Security.Authentication.ExchangeAlgorithmType" /> 算法的强度(以位为单位)。</returns>
  231. </member>
  232. <member name="P:System.Net.Security.SslStream.Length">
  233. <summary>获取基础流的长度。</summary>
  234. <returns>
  235. <see cref="T:System.Int64" />。基础流的长度。</returns>
  236. <exception cref="T:System.NotSupportedException">当基础流为 <see cref="T:System.Net.Sockets.NetworkStream" /> 时,不支持获取此属性的值。</exception>
  237. </member>
  238. <member name="P:System.Net.Security.SslStream.LocalCertificate">
  239. <summary>获取用于对本地终结点进行身份验证的证书。</summary>
  240. <returns>一个 X509Certificate 对象,它表示为身份验证提供的证书;或者,如果没有提供证书,则为 null。</returns>
  241. <exception cref="T:System.InvalidOperationException">身份验证失败或没有进行身份验证。</exception>
  242. </member>
  243. <member name="P:System.Net.Security.SslStream.Position">
  244. <summary>获取或设置基础流中的当前位置。</summary>
  245. <returns>
  246. <see cref="T:System.Int64" />。基础流中的当前位置。</returns>
  247. <exception cref="T:System.NotSupportedException">不支持设置此属性。- 或 -当基础流为 <see cref="T:System.Net.Sockets.NetworkStream" /> 时,不支持获取此属性的值。</exception>
  248. </member>
  249. <member name="M:System.Net.Security.SslStream.Read(System.Byte[],System.Int32,System.Int32)">
  250. <summary>读取此流中的数据并将其存储在指定的数组中。</summary>
  251. <returns>
  252. <see cref="T:System.Int32" /> 值,该值指定读取的字节数。如果再也没有要读取的数据,将返回 0。</returns>
  253. <param name="buffer">一个 <see cref="T:System.Byte" /> 数组,该数组接收从此流读取的字节。</param>
  254. <param name="offset">
  255. <see cref="T:System.Int32" />,它包含 <paramref name="buffer" /> 中从零开始的位置,从此处开始存储从此流读取的数据。</param>
  256. <param name="count">
  257. <see cref="T:System.Int32" />,包含要从此流读取的最大字节数。</param>
  258. <exception cref="T:System.ArgumentNullException">
  259. <paramref name="buffer" /> 为 null。</exception>
  260. <exception cref="T:System.ArgumentException">
  261. <paramref name="offset" />
  262. <paramref name="&lt;" />
  263. <paramref name="0" />.<paramref name="-or-" /><paramref name="offset" /> 大于 <paramref name="buffer" /> 的长度。- 或 -<paramref name="offset" /> 与计数之和大于 <paramref name="buffer" /> 的长度。</exception>
  264. <exception cref="T:System.IO.IOException">读操作失败。检查内部异常(如果存在)以确定失败的原因。</exception>
  265. <exception cref="T:System.NotSupportedException">已存在一个正在执行的读取操作。</exception>
  266. <exception cref="T:System.ObjectDisposedException">此对象已关闭。</exception>
  267. <exception cref="T:System.InvalidOperationException">未进行身份验证。</exception>
  268. </member>
  269. <member name="P:System.Net.Security.SslStream.ReadTimeout">
  270. <summary>获取或设置读操作等待数据的时间。</summary>
  271. <returns>
  272. <see cref="T:System.Int32" />,指定同步读操作失败前经过的时间。</returns>
  273. </member>
  274. <member name="P:System.Net.Security.SslStream.RemoteCertificate">
  275. <summary>获取用于对远程终结点进行身份验证的证书。</summary>
  276. <returns>一个 X509Certificate 对象,它表示为身份验证提供的证书;或者,如果没有提供证书,则为 null。</returns>
  277. <exception cref="T:System.InvalidOperationException">身份验证失败或没有进行身份验证。</exception>
  278. </member>
  279. <member name="M:System.Net.Security.SslStream.Seek(System.Int64,System.IO.SeekOrigin)">
  280. <summary>引发 <see cref="T:System.NotSupportedException" />。</summary>
  281. <returns>总是引发 <see cref="T:System.NotSupportedException" />。</returns>
  282. <param name="offset">忽略此值。</param>
  283. <param name="origin">忽略此值。</param>
  284. <exception cref="T:System.NotSupportedException">
  285. <see cref="T:System.Net.Security.SslStream" /> 对象不支持查找。</exception>
  286. </member>
  287. <member name="M:System.Net.Security.SslStream.SetLength(System.Int64)">
  288. <summary>设置基础流的长度。</summary>
  289. <param name="value">
  290. <see cref="T:System.Int64" /> 值,该值指定流的长度。</param>
  291. </member>
  292. <member name="P:System.Net.Security.SslStream.SslProtocol">
  293. <summary>获取一个值,该值指示用于对此连接进行身份验证的安全协议。</summary>
  294. <returns>代表用于身份验证的协议的 <see cref="T:System.Security.Authentication.SslProtocols" /> 值。</returns>
  295. </member>
  296. <member name="P:System.Net.Security.SslStream.TransportContext">
  297. <summary>获取用于采用扩展保护的身份验证的 <see cref="T:System.Net.TransportContext" />。</summary>
  298. <returns>一个 <see cref="T:System.Net.TransportContext" /> 对象,它包含用于扩展保护的通道绑定令牌 (CBT)。</returns>
  299. </member>
  300. <member name="M:System.Net.Security.SslStream.Write(System.Byte[])">
  301. <summary>将指定的数据写入此流。</summary>
  302. <param name="buffer">一个 <see cref="T:System.Byte" /> 数组,该数组提供要写入流中的字节。</param>
  303. <exception cref="T:System.ArgumentNullException">
  304. <paramref name="buffer" /> 为 null。</exception>
  305. <exception cref="T:System.IO.IOException">写操作失败。</exception>
  306. <exception cref="T:System.NotSupportedException">已存在一个正在执行的写操作。</exception>
  307. <exception cref="T:System.ObjectDisposedException">此对象已关闭。</exception>
  308. <exception cref="T:System.InvalidOperationException">未进行身份验证。</exception>
  309. </member>
  310. <member name="M:System.Net.Security.SslStream.Write(System.Byte[],System.Int32,System.Int32)">
  311. <summary>使用指定的缓冲区和偏移将指定数目的 <see cref="T:System.Byte" /> 写入基础流。</summary>
  312. <param name="buffer">一个 <see cref="T:System.Byte" /> 数组,该数组提供要写入流中的字节。</param>
  313. <param name="offset">
  314. <see cref="T:System.Int32" />,它包含 <paramref name="buffer" /> 中从零开始的位置,将从此位置开始读取要写入流中的字节。</param>
  315. <param name="count">
  316. <see cref="T:System.Int32" />,包含要从 <paramref name="buffer" /> 中读取的字节数。</param>
  317. <exception cref="T:System.ArgumentNullException">
  318. <paramref name="buffer" /> 为 null。</exception>
  319. <exception cref="T:System.ArgumentException">
  320. <paramref name="offset" />
  321. <paramref name="&lt;" />
  322. <paramref name="0" />.<paramref name="-or-" /><paramref name="offset" /> 大于 <paramref name="buffer" /> 的长度。- 或 -<paramref name="offset" /> 与计数之和大于 <paramref name="buffer" /> 的长度。</exception>
  323. <exception cref="T:System.IO.IOException">写操作失败。</exception>
  324. <exception cref="T:System.NotSupportedException">已存在一个正在执行的写操作。</exception>
  325. <exception cref="T:System.ObjectDisposedException">此对象已关闭。</exception>
  326. <exception cref="T:System.InvalidOperationException">未进行身份验证。</exception>
  327. </member>
  328. <member name="P:System.Net.Security.SslStream.WriteTimeout">
  329. <summary>获取或设置写操作等待数据的时间。</summary>
  330. <returns>
  331. <see cref="T:System.Int32" />,指定同步写操作失败前经过的时间。</returns>
  332. </member>
  333. <member name="T:System.Security.Authentication.AuthenticationException">
  334. <summary>当身份验证流的身份验证失败时引发的异常。</summary>
  335. </member>
  336. <member name="M:System.Security.Authentication.AuthenticationException.#ctor">
  337. <summary>不使用任何消息初始化 <see cref="T:System.Security.Authentication.AuthenticationException" /> 类的新实例。</summary>
  338. </member>
  339. <member name="M:System.Security.Authentication.AuthenticationException.#ctor(System.String)">
  340. <summary>用指定消息初始化 <see cref="T:System.Security.Authentication.AuthenticationException" /> 类的新实例。</summary>
  341. <param name="message">描述身份验证失败的 <see cref="T:System.String" />。</param>
  342. </member>
  343. <member name="M:System.Security.Authentication.AuthenticationException.#ctor(System.String,System.Exception)">
  344. <summary>使用指定的消息和内部异常初始化 <see cref="T:System.Security.Authentication.AuthenticationException" /> 类的新实例。</summary>
  345. <param name="message">描述身份验证失败的 <see cref="T:System.String" />。</param>
  346. <param name="innerException">导致当前异常的 <see cref="T:System.Exception" />。</param>
  347. </member>
  348. <member name="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy">
  349. <summary>
  350. <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" /> 类表示服务器用来验证传入客户端连接的扩展保护策略。</summary>
  351. </member>
  352. <member name="M:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.#ctor(System.Security.Authentication.ExtendedProtection.PolicyEnforcement)">
  353. <summary>初始化 <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" /> 类的新实例,该类指定应何时强制实施扩展保护策略。</summary>
  354. <param name="policyEnforcement">一个 <see cref="T:System.Security.Authentication.ExtendedProtection.PolicyEnforcement" /> 值,指示应何时强制实施扩展的保护策略。</param>
  355. </member>
  356. <member name="M:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.#ctor(System.Security.Authentication.ExtendedProtection.PolicyEnforcement,System.Security.Authentication.ExtendedProtection.ChannelBinding)">
  357. <summary>初始化 <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" /> 类的新实例,该类指定应何时强制实施扩展保护策略以及指定要使用的通道绑定令牌 (CBT)。</summary>
  358. <param name="policyEnforcement">一个 <see cref="T:System.Security.Authentication.ExtendedProtection.PolicyEnforcement" /> 值,指示应何时强制实施扩展的保护策略。</param>
  359. <param name="customChannelBinding">
  360. <see cref="T:System.Security.Authentication.ExtendedProtection.ChannelBinding" />,它包含用于验证的自定义通道绑定。</param>
  361. <exception cref="T:System.ArgumentException">
  362. <paramref name="policyEnforcement" /> 指定为 <see cref="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Never" />。</exception>
  363. <exception cref="T:System.ArgumentNullException">
  364. <paramref name="customChannelBinding " />为 null。</exception>
  365. </member>
  366. <member name="M:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.#ctor(System.Security.Authentication.ExtendedProtection.PolicyEnforcement,System.Security.Authentication.ExtendedProtection.ProtectionScenario,System.Collections.ICollection)">
  367. <summary>初始化 <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" /> 类的新实例,该类指定应何时强制实施扩展保护策略、此策略强制实施的保护类型以及用于与客户端的 SPN 相匹配的自定义服务提供程序名称 (SPN) 列表。</summary>
  368. <param name="policyEnforcement">一个 <see cref="T:System.Security.Authentication.ExtendedProtection.PolicyEnforcement" /> 值,指示应何时强制实施扩展的保护策略。</param>
  369. <param name="protectionScenario">一个 <see cref="T:System.Security.Authentication.ExtendedProtection.ProtectionScenario" /> 值,该值指示此策略强制实施的保护类型。</param>
  370. <param name="customServiceNames">
  371. <see cref="T:System.Collections.ICollection" />,它包含用于与客户端的 SPN 相匹配的自定义 SPN 列表。</param>
  372. <exception cref="T:System.ArgumentException">
  373. <paramref name="policyEnforcement" /> 指定为 <see cref="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Never" />。</exception>
  374. <exception cref="T:System.ArgumentNullException">
  375. <paramref name="customServiceNames " /> 是 null 或空列表。</exception>
  376. </member>
  377. <member name="M:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.#ctor(System.Security.Authentication.ExtendedProtection.PolicyEnforcement,System.Security.Authentication.ExtendedProtection.ProtectionScenario,System.Security.Authentication.ExtendedProtection.ServiceNameCollection)">
  378. <summary>初始化 <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" /> 类的新实例,该类指定应何时强制实施扩展保护策略、此策略强制实施的保护类型以及用于与客户端的 SPN 相匹配的自定义服务提供程序名称 (SPN) 列表。</summary>
  379. <param name="policyEnforcement">一个 <see cref="T:System.Security.Authentication.ExtendedProtection.PolicyEnforcement" /> 值,指示应何时强制实施扩展的保护策略。</param>
  380. <param name="protectionScenario">一个 <see cref="T:System.Security.Authentication.ExtendedProtection.ProtectionScenario" /> 值,该值指示此策略强制实施的保护类型。</param>
  381. <param name="customServiceNames">
  382. <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" />,它包含用于与客户端的 SPN 相匹配的自定义 SPN 列表。</param>
  383. <exception cref="T:System.ArgumentException">
  384. <paramref name="policyEnforcement" /> 指定为 <see cref="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Never" />。</exception>
  385. <exception cref="T:System.ArgumentNullException">
  386. <paramref name="customServiceNames " /> 是 null 或空列表。</exception>
  387. </member>
  388. <member name="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomChannelBinding">
  389. <summary>获取用于验证的自定义通道绑定令牌 (CBT)。</summary>
  390. <returns>
  391. <see cref="T:System.Security.Authentication.ExtendedProtection.ChannelBinding" />,它包含用于验证的自定义通道绑定。</returns>
  392. </member>
  393. <member name="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomServiceNames">
  394. <summary>获取用于与客户端的 SPN 相匹配的自定义服务提供程序名称 (SPN) 列表。</summary>
  395. <returns>
  396. <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" />,它包含用于与客户端的 SPN 相匹配的自定义 SPN 列表。</returns>
  397. </member>
  398. <member name="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.OSSupportsExtendedProtection">
  399. <summary>指示操作系统是否支持带扩展保护的集成 Windows 身份验证。</summary>
  400. <returns>如果操作系统支持带扩展保护的集成 Windows 身份验证,则为 true;否则为 false。</returns>
  401. </member>
  402. <member name="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.PolicyEnforcement">
  403. <summary>获取应强制实施扩展保护策略的时间。</summary>
  404. <returns>一个 <see cref="T:System.Security.Authentication.ExtendedProtection.PolicyEnforcement" /> 值,指示应何时强制实施扩展的保护策略。</returns>
  405. </member>
  406. <member name="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.ProtectionScenario">
  407. <summary>获取扩展保护策略强制实施的保护类型。</summary>
  408. <returns>一个 <see cref="T:System.Security.Authentication.ExtendedProtection.ProtectionScenario" /> 值,该值指示此策略强制实施的保护类型。</returns>
  409. </member>
  410. <member name="M:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.ToString">
  411. <summary>获取扩展保护策略实例的字符串表示形式。</summary>
  412. <returns>一个 <see cref="T:System.String" /> 实例,它包含 <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" /> 实例的表示形式。</returns>
  413. </member>
  414. <member name="T:System.Security.Authentication.ExtendedProtection.PolicyEnforcement">
  415. <summary>
  416. <see cref="T:System.Security.Authentication.ExtendedProtection.PolicyEnforcement" /> 枚举指定应何时强制实施 <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" />。</summary>
  417. </member>
  418. <member name="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Always">
  419. <summary>总是强制实施 <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" />。不支持扩展保护的客户端无法进行身份验证。</summary>
  420. </member>
  421. <member name="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Never">
  422. <summary>绝不强制实施 <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" />,并禁用扩展保护。</summary>
  423. </member>
  424. <member name="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.WhenSupported">
  425. <summary>仅在客户端和服务器支持扩展保护时强制实施 <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" />。</summary>
  426. </member>
  427. <member name="T:System.Security.Authentication.ExtendedProtection.ProtectionScenario">
  428. <summary>
  429. <see cref="T:System.Security.Authentication.ExtendedProtection.ProtectionScenario" /> 枚举指定此策略强制实施的保护方案。</summary>
  430. </member>
  431. <member name="F:System.Security.Authentication.ExtendedProtection.ProtectionScenario.TransportSelected">
  432. <summary>此传输将在安全保护方案和标准保护方案之间进行选择,具体取决于所使用的通道的类型。对于安全保护,将在安全通道中包装集成 Windows 身份验证,并包含无需执行服务提供程序名称 (SPN) 验证的精确匹配的通道绑定令牌。对于标准保护,可以选择在带可选通道绑定令牌的安全通道中包装集成 Windows 身份验证,但必须执行 SPN 验证。因此,如果请求是通过安全通道传入的,则检查通道绑定令牌 (CBT);否则检查 SPN。</summary>
  433. </member>
  434. <member name="F:System.Security.Authentication.ExtendedProtection.ProtectionScenario.TrustedProxy">
  435. <summary>在由受信任的代理终结的安全通道中包装集成 Windows 身份验证,并且包含需要 SPN 验证的通道绑定令牌。这要求存在 CBT,但在检查 SPN 时不会检查 CBT。</summary>
  436. </member>
  437. <member name="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection">
  438. <summary>
  439. <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> 类是服务主体名称的只读集合。</summary>
  440. </member>
  441. <member name="M:System.Security.Authentication.ExtendedProtection.ServiceNameCollection.#ctor(System.Collections.ICollection)">
  442. <summary>基于现有 <see cref="T:System.Collections.ICollection" /> 初始化 <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> 类的新的只读实例。</summary>
  443. <param name="items">
  444. <see cref="T:System.Collections.ICollection" /> 类的一个实例,其中包含要用于初始化该类的服务名称的指定值。</param>
  445. <exception cref="T:System.ArgumentNullException">
  446. <paramref name="item " />为 null。</exception>
  447. <exception cref="T:System.ArgumentException">
  448. <paramref name="item" /> 为空。</exception>
  449. </member>
  450. <member name="M:System.Security.Authentication.ExtendedProtection.ServiceNameCollection.Contains(System.String)">
  451. <summary>返回一个值,该值指示指定字符串是否出现在此 <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> 实例中。</summary>
  452. <returns>返回 <see cref="T:System.Boolean" />。如果 <paramref name="searchServiceName" /> 参数在此 <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> 实例中出现,则为 true;否则为 false。</returns>
  453. <param name="searchServiceName">要搜寻的字符串。</param>
  454. </member>
  455. <member name="P:System.Security.Authentication.ExtendedProtection.ServiceNameCollection.Count"></member>
  456. <member name="M:System.Security.Authentication.ExtendedProtection.ServiceNameCollection.GetEnumerator"></member>
  457. <member name="M:System.Security.Authentication.ExtendedProtection.ServiceNameCollection.Merge(System.Collections.IEnumerable)">
  458. <summary>将当前的 <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> 与指定的值合并以创建一个包含联合的新 <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" />。</summary>
  459. <returns>一个新的 <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> 实例,它包含已与指定的值合并的现有 <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> 实例的联合。</returns>
  460. <param name="serviceNames">
  461. <see cref="T:System.Collections.IEnumerable" /> 类的一个实例,其中包含要合并的服务名称的指定值。</param>
  462. <exception cref="T:System.ArgumentNullException">
  463. <paramref name="serviceNames " />为 null。</exception>
  464. <exception cref="T:System.ArgumentException">
  465. <paramref name="serviceNames" /> 为空。</exception>
  466. </member>
  467. <member name="M:System.Security.Authentication.ExtendedProtection.ServiceNameCollection.Merge(System.String)">
  468. <summary>将当前的 <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> 与指定的值合并以创建一个包含联合的新 <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" />。</summary>
  469. <returns>一个新的 <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> 实例,它包含已与指定的值合并的现有 <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> 实例的联合。</returns>
  470. <param name="serviceName">一个字符串,它包含要用于初始化该类的服务名称的指定值。</param>
  471. <exception cref="T:System.ArgumentNullException">
  472. <paramref name="serviceNames " />为 null。</exception>
  473. <exception cref="T:System.ArgumentException">
  474. <paramref name="serviceNames" /> 为空。</exception>
  475. </member>
  476. <member name="M:System.Security.Authentication.ExtendedProtection.ServiceNameCollection.System#Collections#ICollection#CopyTo(System.Array,System.Int32)"></member>
  477. <member name="P:System.Security.Authentication.ExtendedProtection.ServiceNameCollection.System#Collections#ICollection#IsSynchronized"></member>
  478. <member name="P:System.Security.Authentication.ExtendedProtection.ServiceNameCollection.System#Collections#ICollection#SyncRoot"></member>
  479. </members>
  480. </doc>