You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

1009 lines
98 KiB

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <doc>
  3. <assembly>
  4. <name>System.Text.Encoding.Extensions</name>
  5. </assembly>
  6. <members>
  7. <member name="T:System.Text.ASCIIEncoding">
  8. <summary>表示 Unicode 字符的 ASCII 字符编码。</summary>
  9. <filterpriority>1</filterpriority>
  10. </member>
  11. <member name="M:System.Text.ASCIIEncoding.#ctor">
  12. <summary>初始化 <see cref="T:System.Text.ASCIIEncoding" /> 类的新实例。</summary>
  13. </member>
  14. <member name="M:System.Text.ASCIIEncoding.GetByteCount(System.Char*,System.Int32)">
  15. <summary>计算对从指定的字符指针开始的一组字符进行编码时产生的字节数。</summary>
  16. <returns>对指定字符进行编码后生成的字节数。</returns>
  17. <param name="chars">指向第一个要编码的字符的指针。</param>
  18. <param name="count">要编码的字符的数目。</param>
  19. <exception cref="T:System.ArgumentNullException">
  20. <paramref name="chars" /> 为 null。</exception>
  21. <exception cref="T:System.ArgumentOutOfRangeException">
  22. <paramref name="count" /> 小于零。- 或 -产生的字节数超过了作为一个整数返回时允许的最大字节数。</exception>
  23. <exception cref="T:System.Text.EncoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得完整的解释)-和-将 <see cref="P:System.Text.Encoding.EncoderFallback" /> 设置为 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  24. <filterpriority>1</filterpriority>
  25. </member>
  26. <member name="M:System.Text.ASCIIEncoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
  27. <summary>计算对指定字符数组中的一组字符进行编码时产生的字节数。</summary>
  28. <returns>对指定字符进行编码后生成的字节数。</returns>
  29. <param name="chars">包含要编码的字符集的字符数组。</param>
  30. <param name="index">第一个要编码的字符的索引。</param>
  31. <param name="count">要编码的字符的数目。</param>
  32. <exception cref="T:System.ArgumentNullException">
  33. <paramref name="chars" /> 为 null。</exception>
  34. <exception cref="T:System.ArgumentOutOfRangeException">
  35. <paramref name="index" /> 或 <paramref name="count" /> 小于零。- 或 -<paramref name="index" /> 和 <paramref name="count" /> 不表示 <paramref name="chars" /> 中的有效范围。- 或 -产生的字节数超过了作为一个整数返回时允许的最大字节数。</exception>
  36. <exception cref="T:System.Text.EncoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得完整的解释)-和-将 <see cref="P:System.Text.Encoding.EncoderFallback" /> 设置为 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  37. <filterpriority>1</filterpriority>
  38. </member>
  39. <member name="M:System.Text.ASCIIEncoding.GetByteCount(System.String)">
  40. <summary>计算对指定 <see cref="T:System.String" /> 中的字符进行编码时所产生的字节数。</summary>
  41. <returns>对指定字符进行编码后生成的字节数。</returns>
  42. <param name="chars">包含要编码的字符集的 <see cref="T:System.String" />。</param>
  43. <exception cref="T:System.ArgumentNullException">
  44. <paramref name="chars" /> 为 null。</exception>
  45. <exception cref="T:System.ArgumentOutOfRangeException">产生的字节数超过了作为一个整数返回时允许的最大字节数。</exception>
  46. <exception cref="T:System.Text.EncoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得完整的解释)-和-将 <see cref="P:System.Text.Encoding.EncoderFallback" /> 设置为 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  47. <filterpriority>1</filterpriority>
  48. </member>
  49. <member name="M:System.Text.ASCIIEncoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
  50. <summary>将从指定的字符指针开始的一组字符编码为一个字节序列,并从指定的字节指针开始存储该字节序列。</summary>
  51. <returns>在由 <paramref name="bytes" /> 指示的位置处写入的实际字节数。</returns>
  52. <param name="chars">指向第一个要编码的字符的指针。</param>
  53. <param name="charCount">要编码的字符的数目。</param>
  54. <param name="bytes">一个指针,指向开始写入所产生的字节序列的位置。</param>
  55. <param name="byteCount">最多写入的字节数。</param>
  56. <exception cref="T:System.ArgumentNullException">
  57. <paramref name="chars" /> 为 null。- 或 -<paramref name="bytes" /> 为 null。</exception>
  58. <exception cref="T:System.ArgumentOutOfRangeException">
  59. <paramref name="charCount" /> 或 <paramref name="byteCount" /> 小于零。</exception>
  60. <exception cref="T:System.ArgumentException">
  61. <paramref name="byteCount" /> 少于所产生的字节数。</exception>
  62. <exception cref="T:System.Text.EncoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得完整的解释)-和-将 <see cref="P:System.Text.Encoding.EncoderFallback" /> 设置为 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  63. <filterpriority>1</filterpriority>
  64. </member>
  65. <member name="M:System.Text.ASCIIEncoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
  66. <summary>将指定字符数组中的一组字符编码到指定的字节数组中。</summary>
  67. <returns>写入 <paramref name="bytes" /> 的实际字节数。</returns>
  68. <param name="chars">包含要编码的字符集的字符数组。</param>
  69. <param name="charIndex">第一个要编码的字符的索引。</param>
  70. <param name="charCount">要编码的字符的数目。</param>
  71. <param name="bytes">要包含所产生的字节序列的字节数组。</param>
  72. <param name="byteIndex">开始写入所产生的字节序列的索引位置。</param>
  73. <exception cref="T:System.ArgumentNullException">
  74. <paramref name="chars" /> 为 null。- 或 -<paramref name="bytes" /> 为 null。</exception>
  75. <exception cref="T:System.ArgumentOutOfRangeException">
  76. <paramref name="charIndex" />、<paramref name="charCount" /> 或 <paramref name="byteIndex" /> 小于零。- 或 -<paramref name="charIndex" /> 和 <paramref name="charCount" /> 不表示 <paramref name="chars" /> 中的有效范围。- 或 -<paramref name="byteIndex" /> 不是 <paramref name="bytes" /> 中的有效索引。</exception>
  77. <exception cref="T:System.ArgumentException">
  78. <paramref name="bytes" /> 中从 <paramref name="byteIndex" /> 到数组结尾没有足够的容量来容纳所产生的字节。</exception>
  79. <exception cref="T:System.Text.EncoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得完整的解释)-和-将 <see cref="P:System.Text.Encoding.EncoderFallback" /> 设置为 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  80. <filterpriority>1</filterpriority>
  81. </member>
  82. <member name="M:System.Text.ASCIIEncoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
  83. <summary>将指定 <see cref="T:System.String" /> 中的一组字符编码到指定的字节数组中。</summary>
  84. <returns>写入 <paramref name="bytes" /> 的实际字节数。</returns>
  85. <param name="chars">包含要编码的字符集的 <see cref="T:System.String" />。</param>
  86. <param name="charIndex">第一个要编码的字符的索引。</param>
  87. <param name="charCount">要编码的字符的数目。</param>
  88. <param name="bytes">要包含所产生的字节序列的字节数组。</param>
  89. <param name="byteIndex">开始写入所产生的字节序列的索引位置。</param>
  90. <exception cref="T:System.ArgumentNullException">
  91. <paramref name="s" /> 为 null。- 或 -<paramref name="bytes" /> 为 null。</exception>
  92. <exception cref="T:System.ArgumentOutOfRangeException">
  93. <paramref name="charIndex" />、<paramref name="charCount" /> 或 <paramref name="byteIndex" /> 小于零。- 或 -<paramref name="charIndex" /> 和 <paramref name="charCount" /> 不表示 <paramref name="chars" /> 中的有效范围。- 或 -<paramref name="byteIndex" /> 不是 <paramref name="bytes" /> 中的有效索引。</exception>
  94. <exception cref="T:System.ArgumentException">
  95. <paramref name="bytes" /> 中从 <paramref name="byteIndex" /> 到数组结尾没有足够的容量来容纳所产生的字节。</exception>
  96. <exception cref="T:System.Text.EncoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得完整的解释)-和-将 <see cref="P:System.Text.Encoding.EncoderFallback" /> 设置为 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  97. <filterpriority>1</filterpriority>
  98. </member>
  99. <member name="M:System.Text.ASCIIEncoding.GetCharCount(System.Byte*,System.Int32)">
  100. <summary>计算对一个字节序列(从指定的字节指针开始)进行解码所产生的字符数。</summary>
  101. <returns>对指定字节序列进行解码所产生的字符数。</returns>
  102. <param name="bytes">指向第一个要解码的字节的指针。</param>
  103. <param name="count">要解码的字节数。</param>
  104. <exception cref="T:System.ArgumentNullException">
  105. <paramref name="bytes" /> 为 null。</exception>
  106. <exception cref="T:System.ArgumentOutOfRangeException">
  107. <paramref name="count" /> 小于零。- 或 -产生的字节数超过了作为一个整数返回时允许的最大字节数。</exception>
  108. <exception cref="T:System.Text.DecoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得完整的解释)-和-将 <see cref="P:System.Text.Encoding.DecoderFallback" /> 设置为 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  109. <filterpriority>1</filterpriority>
  110. </member>
  111. <member name="M:System.Text.ASCIIEncoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
  112. <summary>计算对指定字节数组中的一个字节序列进行解码所产生的字符数。</summary>
  113. <returns>对指定字节序列进行解码所产生的字符数。</returns>
  114. <param name="bytes">包含要解码的字节序列的字节数组。</param>
  115. <param name="index">第一个要解码的字节的索引。</param>
  116. <param name="count">要解码的字节数。</param>
  117. <exception cref="T:System.ArgumentNullException">
  118. <paramref name="bytes" /> 为 null。</exception>
  119. <exception cref="T:System.ArgumentOutOfRangeException">
  120. <paramref name="index" /> 或 <paramref name="count" /> 小于零。- 或 -<paramref name="index" /> 和 <paramref name="count" /> 不表示 <paramref name="bytes" /> 中的有效范围。- 或 -产生的字节数超过了作为一个整数返回时允许的最大字节数。</exception>
  121. <exception cref="T:System.Text.DecoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得完整的解释)-和-将 <see cref="P:System.Text.Encoding.DecoderFallback" /> 设置为 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  122. <filterpriority>1</filterpriority>
  123. </member>
  124. <member name="M:System.Text.ASCIIEncoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
  125. <summary>将从指定的字节指针开始的一个字节序列解码为一组字符,并从指定的字符指针开始存储这组字符。</summary>
  126. <returns>在由 <paramref name="chars" /> 指示的位置处写入的实际字符数。</returns>
  127. <param name="bytes">指向第一个要解码的字节的指针。</param>
  128. <param name="byteCount">要解码的字节数。</param>
  129. <param name="chars">一个指针,指向开始写入所产生的字符集的位置。</param>
  130. <param name="charCount">要写入的最大字符数。</param>
  131. <exception cref="T:System.ArgumentNullException">
  132. <paramref name="bytes" /> 为 null。- 或 -<paramref name="chars" /> 为 null。</exception>
  133. <exception cref="T:System.ArgumentOutOfRangeException">
  134. <paramref name="byteCount" /> 或 <paramref name="charCount" /> 小于零。</exception>
  135. <exception cref="T:System.ArgumentException">
  136. <paramref name="charCount" /> 少于所产生的字符数。</exception>
  137. <exception cref="T:System.Text.DecoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得完整的解释)-和-将 <see cref="P:System.Text.Encoding.DecoderFallback" /> 设置为 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  138. <filterpriority>1</filterpriority>
  139. </member>
  140. <member name="M:System.Text.ASCIIEncoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
  141. <summary>将指定字节数组中的一个字节序列解码为指定的字符数组。</summary>
  142. <returns>写入 <paramref name="chars" /> 的实际字符数。</returns>
  143. <param name="bytes">包含要解码的字节序列的字节数组。</param>
  144. <param name="byteIndex">第一个要解码的字节的索引。</param>
  145. <param name="byteCount">要解码的字节数。</param>
  146. <param name="chars">要用于包含所产生的字符集的字符数组。</param>
  147. <param name="charIndex">开始写入所产生的字符集的索引位置。</param>
  148. <exception cref="T:System.ArgumentNullException">
  149. <paramref name="bytes" /> 为 null。- 或 -<paramref name="chars" /> 为 null。</exception>
  150. <exception cref="T:System.ArgumentOutOfRangeException">
  151. <paramref name="byteIndex" />、<paramref name="byteCount" /> 或 <paramref name="charIndex" /> 小于零。- 或 -<paramref name="byteindex" /> 和 <paramref name="byteCount" /> 不表示 <paramref name="bytes" /> 中的有效范围。- 或 -<paramref name="charIndex" /> 不是 <paramref name="chars" /> 中的有效索引。</exception>
  152. <exception cref="T:System.ArgumentException">
  153. <paramref name="chars" /> 中从 <paramref name="charIndex" /> 到数组结尾没有足够容量来容纳所产生的字符。</exception>
  154. <exception cref="T:System.Text.DecoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得完整的解释)-和-将 <see cref="P:System.Text.Encoding.DecoderFallback" /> 设置为 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  155. <filterpriority>1</filterpriority>
  156. </member>
  157. <member name="M:System.Text.ASCIIEncoding.GetDecoder">
  158. <summary>获取可以将 ASCII 编码的字节序列转换为 Unicode 字符序列的解码器。</summary>
  159. <returns>
  160. <see cref="T:System.Text.Decoder" /> 用于将 ASCII 编码的字节序列转换为 Unicode 字符序列。</returns>
  161. <filterpriority>1</filterpriority>
  162. </member>
  163. <member name="M:System.Text.ASCIIEncoding.GetEncoder">
  164. <summary>获取可将 Unicode 字符序列转换为 ASCII 编码的字节序列的编码器。</summary>
  165. <returns>一个 <see cref="T:System.Text.Encoder" />,它将一个 Unicode 字符序列转换为一个 ASCII 编码的字节序列。</returns>
  166. <filterpriority>1</filterpriority>
  167. </member>
  168. <member name="M:System.Text.ASCIIEncoding.GetMaxByteCount(System.Int32)">
  169. <summary>计算对指定数目的字符进行编码时产生的最大字节数。</summary>
  170. <returns>对指定数目的字符进行编码所产生的最大字节数。</returns>
  171. <param name="charCount">要编码的字符的数目。</param>
  172. <exception cref="T:System.ArgumentOutOfRangeException">
  173. <paramref name="charCount" /> 小于零。- 或 -产生的字节数超过了作为一个整数返回时允许的最大字节数。</exception>
  174. <filterpriority>1</filterpriority>
  175. </member>
  176. <member name="M:System.Text.ASCIIEncoding.GetMaxCharCount(System.Int32)">
  177. <summary>计算对指定数目的字节进行解码时产生的最大字符数。</summary>
  178. <returns>对指定数目的字节进行解码时所产生的最大字符数。</returns>
  179. <param name="byteCount">要解码的字节数。</param>
  180. <exception cref="T:System.ArgumentOutOfRangeException">
  181. <paramref name="byteCount" /> 小于零。- 或 -产生的字节数超过了作为一个整数返回时允许的最大字节数。</exception>
  182. <filterpriority>1</filterpriority>
  183. </member>
  184. <member name="M:System.Text.ASCIIEncoding.GetString(System.Byte[],System.Int32,System.Int32)">
  185. <summary>将字节数组中某个范围的字节解码为一个字符串。</summary>
  186. <returns>包含指定字节序列解码结果的 <see cref="T:System.String" />。</returns>
  187. <param name="bytes">包含要解码的字节序列的字节数组。</param>
  188. <param name="byteIndex">第一个要解码的字节的索引。</param>
  189. <param name="byteCount">要解码的字节数。</param>
  190. <exception cref="T:System.ArgumentNullException">
  191. <paramref name="bytes" /> 为 null。</exception>
  192. <exception cref="T:System.ArgumentOutOfRangeException">
  193. <paramref name="index" /> 或 <paramref name="count" /> 小于零。- 或 -<paramref name="index" /> 和 <paramref name="count" /> 不表示 <paramref name="bytes" /> 中的有效范围。</exception>
  194. <exception cref="T:System.Text.DecoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得完整的解释)-和-将 <see cref="P:System.Text.Encoding.DecoderFallback" /> 设置为 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  195. <filterpriority>1</filterpriority>
  196. </member>
  197. <member name="P:System.Text.ASCIIEncoding.IsSingleByte">
  198. <summary>获取一个可以指示当前编码是否使用单字节码位的值。</summary>
  199. <returns>此属性恒为 true。</returns>
  200. <filterpriority>2</filterpriority>
  201. </member>
  202. <member name="T:System.Text.UnicodeEncoding">
  203. <summary>表示 Unicode 字符的 UTF-16 编码。</summary>
  204. <filterpriority>1</filterpriority>
  205. </member>
  206. <member name="M:System.Text.UnicodeEncoding.#ctor">
  207. <summary>初始化 <see cref="T:System.Text.UnicodeEncoding" /> 类的新实例。</summary>
  208. </member>
  209. <member name="M:System.Text.UnicodeEncoding.#ctor(System.Boolean,System.Boolean)">
  210. <summary>初始化 <see cref="T:System.Text.UnicodeEncoding" /> 类的新实例。参数指定是否使用 Big-Endian 字节顺序以及 <see cref="M:System.Text.UnicodeEncoding.GetPreamble" /> 方法是否返回 Unicode 字节顺序标记。</summary>
  211. <param name="bigEndian">如果为 true,则使用 Big-Endian 字节顺序(从最高有效字节开始);如果为 false,则使用 Little-Endian 字节顺序(从最低有效字节开始)。</param>
  212. <param name="byteOrderMark">如果为 true,则指定 <see cref="M:System.Text.UnicodeEncoding.GetPreamble" /> 方法返回 Unicode 字节顺序标记;否则为 false。有关详细信息,请参阅备注部分。</param>
  213. </member>
  214. <member name="M:System.Text.UnicodeEncoding.#ctor(System.Boolean,System.Boolean,System.Boolean)">
  215. <summary>初始化 <see cref="T:System.Text.UnicodeEncoding" /> 类的新实例。参数指定是否使用 Big-Endian 字节顺序、是否提供 Unicode 字节顺序标记以及当检测到无效编码时是否引发异常。</summary>
  216. <param name="bigEndian">如果为 true,则使用 Big-Endian 字节顺序(从最高有效字节开始);如果为 false,则使用 Little-Endian 字节顺序(从最低有效字节开始)。</param>
  217. <param name="byteOrderMark">如果为 true,则指定 <see cref="M:System.Text.UnicodeEncoding.GetPreamble" /> 方法返回 Unicode 字节顺序标记;否则为 false。有关详细信息,请参阅备注部分。</param>
  218. <param name="throwOnInvalidBytes">如果为 true,则指定在检测到无效的编码时应当引发异常;否则为 false。</param>
  219. </member>
  220. <member name="M:System.Text.UnicodeEncoding.Equals(System.Object)">
  221. <summary>确定指定的 <see cref="T:System.Object" /> 是否等于当前的 <see cref="T:System.Text.UnicodeEncoding" /> 对象。</summary>
  222. <returns>如果 <paramref name="value" /> 是 <see cref="T:System.Text.UnicodeEncoding" /> 的一个实例并且等于当前对象,则为 true;否则,为 false。</returns>
  223. <param name="value">要与当前对象进行比较的对象。</param>
  224. <filterpriority>2</filterpriority>
  225. </member>
  226. <member name="M:System.Text.UnicodeEncoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
  227. <summary>计算对指定字符数组中的一组字符进行编码时产生的字节数。</summary>
  228. <returns>对指定字符进行编码后生成的字节数。</returns>
  229. <param name="chars">包含要编码的字符集的字符数组。</param>
  230. <param name="index">第一个要编码的字符的索引。</param>
  231. <param name="count">要编码的字符的数目。</param>
  232. <exception cref="T:System.ArgumentNullException">
  233. <paramref name="chars" /> is null (Nothing). </exception>
  234. <exception cref="T:System.ArgumentOutOfRangeException">
  235. <paramref name="index" /> or <paramref name="count" /> is less than zero.-or- <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="chars" />.-or- The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  236. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters. </exception>
  237. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for fuller explanation)-and-<see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
  238. <filterpriority>1</filterpriority>
  239. </member>
  240. <member name="M:System.Text.UnicodeEncoding.GetByteCount(System.String)">
  241. <summary>计算对指定字符串中的字符进行编码时所产生的字节数。</summary>
  242. <returns>对指定字符进行编码后生成的字节数。</returns>
  243. <param name="s">包含要编码的字符集的字符串。</param>
  244. <exception cref="T:System.ArgumentNullException">
  245. <paramref name="s" /> is null . </exception>
  246. <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  247. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s" /> contains an invalid sequence of characters. </exception>
  248. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for fuller explanation)-and-<see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
  249. <filterpriority>1</filterpriority>
  250. </member>
  251. <member name="M:System.Text.UnicodeEncoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
  252. <summary>将指定字符数组中的一组字符编码到指定的字节数组中。</summary>
  253. <returns>写入 <paramref name="bytes" /> 的实际字节数。</returns>
  254. <param name="chars">包含要编码的字符集的字符数组。</param>
  255. <param name="charIndex">第一个要编码的字符的索引。</param>
  256. <param name="charCount">要编码的字符的数目。</param>
  257. <param name="bytes">要包含所产生的字节序列的字节数组。</param>
  258. <param name="byteIndex">要开始写入所产生的字节序列的索引位置。</param>
  259. <exception cref="T:System.ArgumentNullException">
  260. <paramref name="chars" /> is null (Nothing).-or- <paramref name="bytes" /> is null (Nothing). </exception>
  261. <exception cref="T:System.ArgumentOutOfRangeException">
  262. <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.-or- <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.-or- <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />. </exception>
  263. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.-or- <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes. </exception>
  264. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for fuller explanation)-and-<see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
  265. <filterpriority>1</filterpriority>
  266. </member>
  267. <member name="M:System.Text.UnicodeEncoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
  268. <summary>将指定 <see cref="T:System.String" /> 中的一组字符编码到指定的字节数组中。</summary>
  269. <returns>写入 <paramref name="bytes" /> 的实际字节数。</returns>
  270. <param name="s">包含要编码的字符集的字符串。</param>
  271. <param name="charIndex">第一个要编码的字符的索引。</param>
  272. <param name="charCount">要编码的字符的数目。</param>
  273. <param name="bytes">要包含所产生的字节序列的字节数组。</param>
  274. <param name="byteIndex">要开始写入所产生的字节序列的索引位置。</param>
  275. <exception cref="T:System.ArgumentNullException">
  276. <paramref name="s" /> is null .-or- <paramref name="bytes" /> is null (Nothing). </exception>
  277. <exception cref="T:System.ArgumentOutOfRangeException">
  278. <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.-or- <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.-or- <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />. </exception>
  279. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s" /> contains an invalid sequence of characters.-or- <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes. </exception>
  280. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for fuller explanation)-and-<see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
  281. <filterpriority>1</filterpriority>
  282. </member>
  283. <member name="M:System.Text.UnicodeEncoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
  284. <summary>计算对指定字节数组中的一个字节序列进行解码所产生的字符数。</summary>
  285. <returns>对指定字节序列进行解码所产生的字符数。</returns>
  286. <param name="bytes">包含要解码的字节序列的字节数组。</param>
  287. <param name="index">第一个要解码的字节的索引。</param>
  288. <param name="count">要解码的字节数。</param>
  289. <exception cref="T:System.ArgumentNullException">
  290. <paramref name="bytes" /> is null (Nothing). </exception>
  291. <exception cref="T:System.ArgumentOutOfRangeException">
  292. <paramref name="index" /> or <paramref name="count" /> is less than zero.-or- <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.-or- The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  293. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes. </exception>
  294. <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for fuller explanation)-and-<see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
  295. <filterpriority>1</filterpriority>
  296. </member>
  297. <member name="M:System.Text.UnicodeEncoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
  298. <summary>将指定字节数组中的一个字节序列解码为指定的字符数组。</summary>
  299. <returns>写入 <paramref name="chars" /> 的实际字符数。</returns>
  300. <param name="bytes">包含要解码的字节序列的字节数组。</param>
  301. <param name="byteIndex">第一个要解码的字节的索引。</param>
  302. <param name="byteCount">要解码的字节数。</param>
  303. <param name="chars">要用于包含所产生的字符集的字符数组。</param>
  304. <param name="charIndex">开始写入所产生的字符集的索引位置。</param>
  305. <exception cref="T:System.ArgumentNullException">
  306. <paramref name="bytes" /> is null (Nothing).-or- <paramref name="chars" /> is null (Nothing). </exception>
  307. <exception cref="T:System.ArgumentOutOfRangeException">
  308. <paramref name="byteIndex" /> or <paramref name="byteCount" /> or <paramref name="charIndex" /> is less than zero.-or- <paramref name="byteindex" /> and <paramref name="byteCount" /> do not denote a valid range in <paramref name="bytes" />.-or- <paramref name="charIndex" /> is not a valid index in <paramref name="chars" />. </exception>
  309. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.-or- <paramref name="chars" /> does not have enough capacity from <paramref name="charIndex" /> to the end of the array to accommodate the resulting characters. </exception>
  310. <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for fuller explanation)-and-<see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
  311. <filterpriority>1</filterpriority>
  312. </member>
  313. <member name="M:System.Text.UnicodeEncoding.GetDecoder">
  314. <summary>获取可以将 UTF-16 编码的字节序列转换为 Unicode 字符序列的解码器。</summary>
  315. <returns>一个 <see cref="T:System.Text.Decoder" />,用于将 UTF-16 编码的字节序列转换为 Unicode 字符序列。</returns>
  316. <filterpriority>1</filterpriority>
  317. </member>
  318. <member name="M:System.Text.UnicodeEncoding.GetEncoder">
  319. <summary>获取可将 Unicode 字符序列转换为 UTF-16 编码的字节序列的编码器。</summary>
  320. <returns>将 Unicode 字符序列转换为 UTF-16 编码字节序列的 <see cref="T:System.Text.Encoder" /> 对象。</returns>
  321. <filterpriority>1</filterpriority>
  322. </member>
  323. <member name="M:System.Text.UnicodeEncoding.GetHashCode">
  324. <summary>返回当前实例的哈希代码。</summary>
  325. <returns>当前 <see cref="T:System.Text.UnicodeEncoding" /> 对象的哈希代码。</returns>
  326. <filterpriority>1</filterpriority>
  327. </member>
  328. <member name="M:System.Text.UnicodeEncoding.GetMaxByteCount(System.Int32)">
  329. <summary>计算对指定数目的字符进行编码时产生的最大字节数。</summary>
  330. <returns>对指定数目的字符进行编码所产生的最大字节数。</returns>
  331. <param name="charCount">要编码的字符的数目。</param>
  332. <exception cref="T:System.ArgumentOutOfRangeException">
  333. <paramref name="charCount" /> is less than zero.-or- The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  334. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for fuller explanation)-and-<see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
  335. <filterpriority>1</filterpriority>
  336. </member>
  337. <member name="M:System.Text.UnicodeEncoding.GetMaxCharCount(System.Int32)">
  338. <summary>计算对指定数目的字节进行解码时产生的最大字符数。</summary>
  339. <returns>对指定数目的字节进行解码时所产生的最大字符数。</returns>
  340. <param name="byteCount">要解码的字节数。</param>
  341. <exception cref="T:System.ArgumentOutOfRangeException">
  342. <paramref name="byteCount" /> is less than zero.-or- The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  343. <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for fuller explanation)-and-<see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
  344. <filterpriority>1</filterpriority>
  345. </member>
  346. <member name="M:System.Text.UnicodeEncoding.GetPreamble">
  347. <summary>如果此实例的构造函数请求一个字节顺序标记,则将返回用 UTF-16 格式编码的 Unicode 字节顺序标记。</summary>
  348. <returns>一个包含 Unicode 字节顺序标记的字节数组(如果 <see cref="T:System.Text.UnicodeEncoding" /> 对象配置为提供一个这样的字节数组)。否则,此方法返回一个零长度的字节数组。</returns>
  349. <filterpriority>1</filterpriority>
  350. </member>
  351. <member name="M:System.Text.UnicodeEncoding.GetString(System.Byte[],System.Int32,System.Int32)">
  352. <summary>将字节数组中某个范围的字节解码为一个字符串。</summary>
  353. <returns>包含指定字节序列解码结果的 <see cref="T:System.String" /> 对象。</returns>
  354. <param name="bytes">包含要解码的字节序列的字节数组。</param>
  355. <param name="index">第一个要解码的字节的索引。</param>
  356. <param name="count">要解码的字节数。</param>
  357. <exception cref="T:System.ArgumentNullException">
  358. <paramref name="bytes" /> is null (Nothing). </exception>
  359. <exception cref="T:System.ArgumentOutOfRangeException">
  360. <paramref name="index" /> or <paramref name="count" /> is less than zero.-or- <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />. </exception>
  361. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes. </exception>
  362. <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for fuller explanation)-and-<see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
  363. <filterpriority>1</filterpriority>
  364. </member>
  365. <member name="T:System.Text.UTF32Encoding">
  366. <summary>表示 Unicode 字符的 UTF-32 编码。</summary>
  367. <filterpriority>1</filterpriority>
  368. </member>
  369. <member name="M:System.Text.UTF32Encoding.#ctor">
  370. <summary>初始化 <see cref="T:System.Text.UTF32Encoding" /> 类的新实例。</summary>
  371. </member>
  372. <member name="M:System.Text.UTF32Encoding.#ctor(System.Boolean,System.Boolean)">
  373. <summary>初始化 <see cref="T:System.Text.UTF32Encoding" /> 类的新实例。参数指定是否使用 Big-Endian 字节顺序以及 <see cref="M:System.Text.UTF32Encoding.GetPreamble" /> 方法是否返回 Unicode Unicode 字节顺序标记。</summary>
  374. <param name="bigEndian">如果为 true,则使用 Big-Endian 字节顺序(从最高有效字节开始);如果为 false,则使用 Little-Endian 字节顺序(从最低有效字节开始)。</param>
  375. <param name="byteOrderMark">如果为 true,则指定提供 Unicode 字节顺序标记;否则为 false。</param>
  376. </member>
  377. <member name="M:System.Text.UTF32Encoding.#ctor(System.Boolean,System.Boolean,System.Boolean)">
  378. <summary>初始化 <see cref="T:System.Text.UTF32Encoding" /> 类的新实例。参数指定是否使用 Big-Endian 字节顺序、是否提供 Unicode 字节顺序标记以及当检测到无效编码时是否引发异常。</summary>
  379. <param name="bigEndian">如果为 true,则使用 Big-Endian 字节顺序(从最高有效字节开始);如果为 false,则使用 Little-Endian 字节顺序(从最低有效字节开始)。</param>
  380. <param name="byteOrderMark">如果为 true,则指定提供 Unicode 字节顺序标记;否则为 false。</param>
  381. <param name="throwOnInvalidCharacters">如果为 true,则指定在检测到无效的编码时应当引发异常;否则为 false。</param>
  382. </member>
  383. <member name="M:System.Text.UTF32Encoding.Equals(System.Object)">
  384. <summary>确定指定的 <see cref="T:System.Object" /> 是否等于当前的 <see cref="T:System.Text.UTF32Encoding" /> 对象。</summary>
  385. <returns>如果 <paramref name="value" /> 是 <see cref="T:System.Text.UTF32Encoding" /> 的一个实例并且等于当前对象,则为 true;否则,为 false。</returns>
  386. <param name="value">要与当前对象进行比较的 <see cref="T:System.Object" />。</param>
  387. <filterpriority>2</filterpriority>
  388. </member>
  389. <member name="M:System.Text.UTF32Encoding.GetByteCount(System.Char*,System.Int32)">
  390. <summary>计算对从指定的字符指针开始的一组字符进行编码时产生的字节数。</summary>
  391. <returns>对指定字符进行编码后生成的字节数。</returns>
  392. <param name="chars">指向第一个要编码的字符的指针。</param>
  393. <param name="count">要编码的字符的数目。</param>
  394. <exception cref="T:System.ArgumentNullException">
  395. <paramref name="chars" /> is null. </exception>
  396. <exception cref="T:System.ArgumentOutOfRangeException">
  397. <paramref name="count" /> is less than zero.-or- The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  398. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters. </exception>
  399. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
  400. <filterpriority>1</filterpriority>
  401. </member>
  402. <member name="M:System.Text.UTF32Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
  403. <summary>计算对指定字符数组中的一组字符进行编码时产生的字节数。</summary>
  404. <returns>对指定字符进行编码后生成的字节数。</returns>
  405. <param name="chars">包含要编码的字符集的字符数组。</param>
  406. <param name="index">第一个要编码的字符的索引。</param>
  407. <param name="count">要编码的字符的数目。</param>
  408. <exception cref="T:System.ArgumentNullException">
  409. <paramref name="chars" /> is null. </exception>
  410. <exception cref="T:System.ArgumentOutOfRangeException">
  411. <paramref name="index" /> or <paramref name="count" /> is less than zero.-or- <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="chars" />.-or- The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  412. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters. </exception>
  413. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
  414. <filterpriority>1</filterpriority>
  415. </member>
  416. <member name="M:System.Text.UTF32Encoding.GetByteCount(System.String)">
  417. <summary>计算对指定 <see cref="T:System.String" /> 中的字符进行编码时所产生的字节数。</summary>
  418. <returns>对指定字符进行编码后生成的字节数。</returns>
  419. <param name="s">包含要编码的字符集的 <see cref="T:System.String" />。</param>
  420. <exception cref="T:System.ArgumentNullException">
  421. <paramref name="s" /> is null. </exception>
  422. <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  423. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s" /> contains an invalid sequence of characters. </exception>
  424. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
  425. <filterpriority>1</filterpriority>
  426. </member>
  427. <member name="M:System.Text.UTF32Encoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
  428. <summary>将从指定的字符指针开始的一组字符编码为一个字节序列,并从指定的字节指针开始存储该字节序列。</summary>
  429. <returns>在由 <paramref name="bytes" /> 参数指示的位置处写入的实际字节数。</returns>
  430. <param name="chars">指向第一个要编码的字符的指针。</param>
  431. <param name="charCount">要编码的字符的数目。</param>
  432. <param name="bytes">一个指针,指向开始写入所产生的字节序列的位置。</param>
  433. <param name="byteCount">最多写入的字节数。</param>
  434. <exception cref="T:System.ArgumentNullException">
  435. <paramref name="chars" /> is null.-or- <paramref name="bytes" /> is null. </exception>
  436. <exception cref="T:System.ArgumentOutOfRangeException">
  437. <paramref name="charCount" /> or <paramref name="byteCount" /> is less than zero. </exception>
  438. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.-or- <paramref name="byteCount" /> is less than the resulting number of bytes. </exception>
  439. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
  440. <filterpriority>1</filterpriority>
  441. </member>
  442. <member name="M:System.Text.UTF32Encoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
  443. <summary>将指定字符数组中的一组字符编码到指定的字节数组中。</summary>
  444. <returns>写入 <paramref name="bytes" /> 的实际字节数。</returns>
  445. <param name="chars">包含要编码的字符集的字符数组。</param>
  446. <param name="charIndex">第一个要编码的字符的索引。</param>
  447. <param name="charCount">要编码的字符的数目。</param>
  448. <param name="bytes">要包含所产生的字节序列的字节数组。</param>
  449. <param name="byteIndex">要开始写入所产生的字节序列的索引位置。</param>
  450. <exception cref="T:System.ArgumentNullException">
  451. <paramref name="chars" /> is null.-or- <paramref name="bytes" /> is null. </exception>
  452. <exception cref="T:System.ArgumentOutOfRangeException">
  453. <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.-or- <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.-or- <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />. </exception>
  454. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.-or- <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes. </exception>
  455. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
  456. <filterpriority>1</filterpriority>
  457. </member>
  458. <member name="M:System.Text.UTF32Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
  459. <summary>将指定 <see cref="T:System.String" /> 中的一组字符编码到指定的字节数组中。</summary>
  460. <returns>写入 <paramref name="bytes" /> 的实际字节数。</returns>
  461. <param name="s">包含要编码的字符集的 <see cref="T:System.String" />。</param>
  462. <param name="charIndex">第一个要编码的字符的索引。</param>
  463. <param name="charCount">要编码的字符的数目。</param>
  464. <param name="bytes">要包含所产生的字节序列的字节数组。</param>
  465. <param name="byteIndex">要开始写入所产生的字节序列的索引位置。</param>
  466. <exception cref="T:System.ArgumentNullException">
  467. <paramref name="s" /> is null.-or- <paramref name="bytes" /> is null. </exception>
  468. <exception cref="T:System.ArgumentOutOfRangeException">
  469. <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.-or- <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.-or- <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />. </exception>
  470. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s" /> contains an invalid sequence of characters.-or- <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes. </exception>
  471. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
  472. <filterpriority>1</filterpriority>
  473. </member>
  474. <member name="M:System.Text.UTF32Encoding.GetCharCount(System.Byte*,System.Int32)">
  475. <summary>计算对一个字节序列(从指定的字节指针开始)进行解码所产生的字符数。</summary>
  476. <returns>对指定字节序列进行解码所产生的字符数。</returns>
  477. <param name="bytes">指向第一个要解码的字节的指针。</param>
  478. <param name="count">要解码的字节数。</param>
  479. <exception cref="T:System.ArgumentNullException">
  480. <paramref name="bytes" /> is null. </exception>
  481. <exception cref="T:System.ArgumentOutOfRangeException">
  482. <paramref name="count" /> is less than zero.-or- The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  483. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes. </exception>
  484. <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
  485. <filterpriority>1</filterpriority>
  486. </member>
  487. <member name="M:System.Text.UTF32Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
  488. <summary>计算对指定字节数组中的一个字节序列进行解码所产生的字符数。</summary>
  489. <returns>对指定字节序列进行解码所产生的字符数。</returns>
  490. <param name="bytes">包含要解码的字节序列的字节数组。</param>
  491. <param name="index">第一个要解码的字节的索引。</param>
  492. <param name="count">要解码的字节数。</param>
  493. <exception cref="T:System.ArgumentNullException">
  494. <paramref name="bytes" /> is null. </exception>
  495. <exception cref="T:System.ArgumentOutOfRangeException">
  496. <paramref name="index" /> or <paramref name="count" /> is less than zero.-or- <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.-or- The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  497. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes. </exception>
  498. <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
  499. <filterpriority>1</filterpriority>
  500. </member>
  501. <member name="M:System.Text.UTF32Encoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
  502. <summary>将从指定的字节指针开始的一个字节序列解码为一组字符,并从指定的字符指针开始存储这组字符。</summary>
  503. <returns>在由 <paramref name="chars" /> 指示的位置处写入的实际字符数。</returns>
  504. <param name="bytes">指向第一个要解码的字节的指针。</param>
  505. <param name="byteCount">要解码的字节数。</param>
  506. <param name="chars">一个指针,指向开始写入所产生的字符集的位置。</param>
  507. <param name="charCount">要写入的最大字符数。</param>
  508. <exception cref="T:System.ArgumentNullException">
  509. <paramref name="bytes" /> is null.-or- <paramref name="chars" /> is null. </exception>
  510. <exception cref="T:System.ArgumentOutOfRangeException">
  511. <paramref name="byteCount" /> or <paramref name="charCount" /> is less than zero. </exception>
  512. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.-or- <paramref name="charCount" /> is less than the resulting number of characters. </exception>
  513. <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
  514. <filterpriority>1</filterpriority>
  515. </member>
  516. <member name="M:System.Text.UTF32Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
  517. <summary>将指定字节数组中的一个字节序列解码为指定的字符数组。</summary>
  518. <returns>写入 <paramref name="chars" /> 的实际字符数。</returns>
  519. <param name="bytes">包含要解码的字节序列的字节数组。</param>
  520. <param name="byteIndex">第一个要解码的字节的索引。</param>
  521. <param name="byteCount">要解码的字节数。</param>
  522. <param name="chars">要用于包含所产生的字符集的字符数组。</param>
  523. <param name="charIndex">开始写入所产生的字符集的索引位置。</param>
  524. <exception cref="T:System.ArgumentNullException">
  525. <paramref name="bytes" /> is null.-or- <paramref name="chars" /> is null. </exception>
  526. <exception cref="T:System.ArgumentOutOfRangeException">
  527. <paramref name="byteIndex" /> or <paramref name="byteCount" /> or <paramref name="charIndex" /> is less than zero.-or- <paramref name="byteindex" /> and <paramref name="byteCount" /> do not denote a valid range in <paramref name="bytes" />.-or- <paramref name="charIndex" /> is not a valid index in <paramref name="chars" />. </exception>
  528. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.-or- <paramref name="chars" /> does not have enough capacity from <paramref name="charIndex" /> to the end of the array to accommodate the resulting characters. </exception>
  529. <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
  530. <filterpriority>1</filterpriority>
  531. </member>
  532. <member name="M:System.Text.UTF32Encoding.GetDecoder">
  533. <summary>获取可以将 UTF-32 编码的字节序列转换为 Unicode 字符序列的解码器。</summary>
  534. <returns>一个 <see cref="T:System.Text.Decoder" />,用于将 UTF-32 编码的字节序列转换为 Unicode 字符序列。</returns>
  535. <filterpriority>1</filterpriority>
  536. </member>
  537. <member name="M:System.Text.UTF32Encoding.GetEncoder">
  538. <summary>获取可将 Unicode 字符序列转换为 UTF-32 编码的字节序列的编码器。</summary>
  539. <returns>一个 <see cref="T:System.Text.Encoder" />,用于将 Unicode 字符序列转换为 UTF-32 编码的字节序列。</returns>
  540. <filterpriority>1</filterpriority>
  541. </member>
  542. <member name="M:System.Text.UTF32Encoding.GetHashCode">
  543. <summary>返回当前实例的哈希代码。</summary>
  544. <returns>当前 <see cref="T:System.Text.UTF32Encoding" /> 对象的哈希代码。</returns>
  545. <filterpriority>1</filterpriority>
  546. </member>
  547. <member name="M:System.Text.UTF32Encoding.GetMaxByteCount(System.Int32)">
  548. <summary>计算对指定数目的字符进行编码时产生的最大字节数。</summary>
  549. <returns>对指定数目的字符进行编码所产生的最大字节数。</returns>
  550. <param name="charCount">要编码的字符的数目。</param>
  551. <exception cref="T:System.ArgumentOutOfRangeException">
  552. <paramref name="charCount" /> is less than zero.-or- The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  553. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
  554. <filterpriority>1</filterpriority>
  555. </member>
  556. <member name="M:System.Text.UTF32Encoding.GetMaxCharCount(System.Int32)">
  557. <summary>计算对指定数目的字节进行解码时产生的最大字符数。</summary>
  558. <returns>对指定数目的字节进行解码时所产生的最大字符数。</returns>
  559. <param name="byteCount">要解码的字节数。</param>
  560. <exception cref="T:System.ArgumentOutOfRangeException">
  561. <paramref name="byteCount" /> is less than zero.-or- The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  562. <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
  563. <filterpriority>1</filterpriority>
  564. </member>
  565. <member name="M:System.Text.UTF32Encoding.GetPreamble">
  566. <summary>如果此实例的构造函数请求一个字节顺序标记,则将返回用 UTF-32 格式编码的 Unicode 字节顺序标记。</summary>
  567. <returns>如果此实例的构造函数请求一个字节顺序标记,则将返回一个包含 Unicode 字节顺序标记的字节数组。否则,此方法将返回一个长度零的字节数组。</returns>
  568. <filterpriority>1</filterpriority>
  569. </member>
  570. <member name="M:System.Text.UTF32Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
  571. <summary>将字节数组中某个范围的字节解码为一个字符串。</summary>
  572. <returns>包含指定字节序列解码结果的 <see cref="T:System.String" />。</returns>
  573. <param name="bytes">包含要解码的字节序列的字节数组。</param>
  574. <param name="index">第一个要解码的字节的索引。</param>
  575. <param name="count">要解码的字节数。</param>
  576. <exception cref="T:System.ArgumentNullException">
  577. <paramref name="bytes" /> is null. </exception>
  578. <exception cref="T:System.ArgumentOutOfRangeException">
  579. <paramref name="index" /> or <paramref name="count" /> is less than zero.-or- <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />. </exception>
  580. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes. </exception>
  581. <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
  582. <filterpriority>1</filterpriority>
  583. </member>
  584. <member name="T:System.Text.UTF7Encoding">
  585. <summary>表示 Unicode 字符的 UTF-7 编码。</summary>
  586. <filterpriority>1</filterpriority>
  587. </member>
  588. <member name="M:System.Text.UTF7Encoding.#ctor">
  589. <summary>初始化 <see cref="T:System.Text.UTF7Encoding" /> 类的新实例。</summary>
  590. </member>
  591. <member name="M:System.Text.UTF7Encoding.#ctor(System.Boolean)">
  592. <summary>初始化 <see cref="T:System.Text.UTF7Encoding" /> 类的新实例。一个参数指定是否允许可选字符。</summary>
  593. <param name="allowOptionals">如果为 true,则允许指定可选字符;否则为 false。</param>
  594. </member>
  595. <member name="M:System.Text.UTF7Encoding.Equals(System.Object)">
  596. <summary>获取一个值,该值指示指定的对象是否等于当前的 <see cref="T:System.Text.UTF7Encoding" /> 对象。</summary>
  597. <returns>如果 <paramref name="value" /> 是一个 <see cref="T:System.Text.UTF7Encoding" /> 对象且等于当前的 <see cref="T:System.Text.UTF7Encoding" /> 对象,则为 true;否则为 false。</returns>
  598. <param name="value">要与当前的 <see cref="T:System.Text.UTF7Encoding" /> 对象进行比较的对象。</param>
  599. <filterpriority>2</filterpriority>
  600. </member>
  601. <member name="M:System.Text.UTF7Encoding.GetByteCount(System.Char*,System.Int32)">
  602. <summary>计算对从指定的字符指针开始的一组字符进行编码时产生的字节数。</summary>
  603. <returns>对指定字符进行编码后生成的字节数。</returns>
  604. <param name="chars">指向第一个要编码的字符的指针。</param>
  605. <param name="count">要编码的字符的数目。</param>
  606. <exception cref="T:System.ArgumentNullException">
  607. <paramref name="chars" /> 是 null (在 Visual Basic .NET 中为 Nothing )。</exception>
  608. <exception cref="T:System.ArgumentOutOfRangeException">
  609. <paramref name="count" /> 小于零。- 或 -产生的字节数超过了作为一个整数返回时允许的最大字节数。</exception>
  610. <exception cref="T:System.Text.EncoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得完整的解释)-和-将 <see cref="P:System.Text.Encoding.EncoderFallback" /> 设置为 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  611. <filterpriority>1</filterpriority>
  612. </member>
  613. <member name="M:System.Text.UTF7Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
  614. <summary>计算对指定字符数组中的一组字符进行编码时产生的字节数。</summary>
  615. <returns>对指定字符进行编码后生成的字节数。</returns>
  616. <param name="chars">包含要编码的字符集的字符数组。</param>
  617. <param name="index">第一个要编码的字符的索引。</param>
  618. <param name="count">要编码的字符的数目。</param>
  619. <exception cref="T:System.ArgumentNullException">
  620. <paramref name="chars" /> 为 null (Nothing)。</exception>
  621. <exception cref="T:System.ArgumentOutOfRangeException">
  622. <paramref name="index" /> 或 <paramref name="count" /> 小于零。- 或 -<paramref name="index" /> 和 <paramref name="count" /> 不表示 <paramref name="chars" /> 中的有效范围。- 或 -产生的字节数超过了作为一个整数返回时允许的最大字节数。</exception>
  623. <exception cref="T:System.Text.EncoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得完整的解释)-和-将 <see cref="P:System.Text.Encoding.EncoderFallback" /> 设置为 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  624. <filterpriority>1</filterpriority>
  625. </member>
  626. <member name="M:System.Text.UTF7Encoding.GetByteCount(System.String)">
  627. <summary>计算对指定 <see cref="T:System.String" /> 对象中的字符进行编码时所产生的字节数。</summary>
  628. <returns>对指定字符进行编码后生成的字节数。</returns>
  629. <param name="s">包含要编码的字符集的 <see cref="T:System.String" /> 对象。</param>
  630. <exception cref="T:System.ArgumentNullException">
  631. <paramref name="s" /> 为 null (Nothing)。</exception>
  632. <exception cref="T:System.ArgumentOutOfRangeException">产生的字节数超过了作为一个整数返回时允许的最大字节数。</exception>
  633. <exception cref="T:System.Text.EncoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得更详细的解释)-和-将 <see cref="P:System.Text.Encoding.EncoderFallback" /> 设置为 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  634. <filterpriority>1</filterpriority>
  635. </member>
  636. <member name="M:System.Text.UTF7Encoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
  637. <summary>将从指定的字符指针开始的一组字符编码为一个字节序列,并从指定的字节指针开始存储该字节序列。</summary>
  638. <returns>在由 <paramref name="bytes" /> 指示的位置处写入的实际字节数。</returns>
  639. <param name="chars">指向第一个要编码的字符的指针。</param>
  640. <param name="charCount">要编码的字符的数目。</param>
  641. <param name="bytes">一个指针,指向开始写入所产生的字节序列的位置。</param>
  642. <param name="byteCount">最多写入的字节数。</param>
  643. <exception cref="T:System.ArgumentNullException">
  644. <paramref name="chars" /> 为 null (Nothing)。- 或 -<paramref name="bytes" /> 为 null (Nothing)。</exception>
  645. <exception cref="T:System.ArgumentOutOfRangeException">
  646. <paramref name="charCount" /> 或 <paramref name="byteCount" /> 小于零。</exception>
  647. <exception cref="T:System.ArgumentException">
  648. <paramref name="byteCount" /> 少于所产生的字节数。</exception>
  649. <exception cref="T:System.Text.EncoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得更详细的解释)-和-将 <see cref="P:System.Text.Encoding.EncoderFallback" /> 设置为 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  650. <filterpriority>1</filterpriority>
  651. </member>
  652. <member name="M:System.Text.UTF7Encoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
  653. <summary>将指定字符数组中的一组字符编码到指定的字节数组中。</summary>
  654. <returns>写入 <paramref name="bytes" /> 的实际字节数。</returns>
  655. <param name="chars">包含要编码的字符集的字符数组。</param>
  656. <param name="charIndex">第一个要编码的字符的索引。</param>
  657. <param name="charCount">要编码的字符的数目。</param>
  658. <param name="bytes">要包含所产生的字节序列的字节数组。</param>
  659. <param name="byteIndex">开始写入所产生的字节序列的索引位置。</param>
  660. <exception cref="T:System.ArgumentNullException">
  661. <paramref name="chars" /> 为 null (Nothing)。- 或 -<paramref name="bytes" /> 为 null (Nothing)。</exception>
  662. <exception cref="T:System.ArgumentOutOfRangeException">
  663. <paramref name="charIndex" />、<paramref name="charCount" /> 或 <paramref name="byteIndex" /> 小于零。- 或 -<paramref name="charIndex" /> 和 <paramref name="charCount" /> 不表示 <paramref name="chars" /> 中的有效范围。- 或 -<paramref name="byteIndex" /> 不是 <paramref name="bytes" /> 中的有效索引。</exception>
  664. <exception cref="T:System.ArgumentException">
  665. <paramref name="bytes" /> 中从 <paramref name="byteIndex" /> 到数组结尾没有足够的容量来容纳所产生的字节。</exception>
  666. <exception cref="T:System.Text.EncoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得更详细的解释)-和-将 <see cref="P:System.Text.Encoding.EncoderFallback" /> 设置为 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  667. <filterpriority>1</filterpriority>
  668. </member>
  669. <member name="M:System.Text.UTF7Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
  670. <summary>将指定 <see cref="T:System.String" /> 中的一组字符编码到指定的字节数组中。</summary>
  671. <returns>写入 <paramref name="bytes" /> 的实际字节数。</returns>
  672. <param name="s">包含要编码的字符集的 <see cref="T:System.String" />。</param>
  673. <param name="charIndex">第一个要编码的字符的索引。</param>
  674. <param name="charCount">要编码的字符的数目。</param>
  675. <param name="bytes">要包含所产生的字节序列的字节数组。</param>
  676. <param name="byteIndex">开始写入所产生的字节序列的索引位置。</param>
  677. <exception cref="T:System.ArgumentNullException">
  678. <paramref name="s" /> 为 null (Nothing)。- 或 -<paramref name="bytes" /> 为 null (Nothing)。</exception>
  679. <exception cref="T:System.ArgumentOutOfRangeException">
  680. <paramref name="charIndex" />、<paramref name="charCount" /> 或 <paramref name="byteIndex" /> 小于零。- 或 -<paramref name="charIndex" /> 和 <paramref name="charCount" /> 不表示 <paramref name="chars" /> 中的有效范围。- 或 -<paramref name="byteIndex" /> 不是 <paramref name="bytes" /> 中的有效索引。</exception>
  681. <exception cref="T:System.ArgumentException">
  682. <paramref name="bytes" /> 中从 <paramref name="byteIndex" /> 到数组结尾没有足够的容量来容纳所产生的字节。</exception>
  683. <exception cref="T:System.Text.EncoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得更详细的解释)-和-将 <see cref="P:System.Text.Encoding.EncoderFallback" /> 设置为 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  684. <filterpriority>1</filterpriority>
  685. </member>
  686. <member name="M:System.Text.UTF7Encoding.GetCharCount(System.Byte*,System.Int32)">
  687. <summary>计算对一个字节序列(从指定的字节指针开始)进行解码所产生的字符数。</summary>
  688. <returns>对指定字节序列进行解码所产生的字符数。</returns>
  689. <param name="bytes">指向第一个要解码的字节的指针。</param>
  690. <param name="count">要解码的字节数。</param>
  691. <exception cref="T:System.ArgumentNullException">
  692. <paramref name="bytes" /> 为 null (Nothing)。</exception>
  693. <exception cref="T:System.ArgumentOutOfRangeException">
  694. <paramref name="count" /> 小于零。- 或 -产生的字符数超过了作为一个整数返回时允许的最大字符数。</exception>
  695. <exception cref="T:System.Text.DecoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得更详细的解释)-和-将 <see cref="P:System.Text.Encoding.DecoderFallback" /> 设置为 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  696. <filterpriority>1</filterpriority>
  697. </member>
  698. <member name="M:System.Text.UTF7Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
  699. <summary>计算对指定字节数组中的一个字节序列进行解码所产生的字符数。</summary>
  700. <returns>对指定字节序列进行解码所产生的字符数。</returns>
  701. <param name="bytes">包含要解码的字节序列的字节数组。</param>
  702. <param name="index">第一个要解码的字节的索引。</param>
  703. <param name="count">要解码的字节数。</param>
  704. <exception cref="T:System.ArgumentNullException">
  705. <paramref name="bytes" /> 为 null (Nothing)。</exception>
  706. <exception cref="T:System.ArgumentOutOfRangeException">
  707. <paramref name="index" /> 或 <paramref name="count" /> 小于零。- 或 -<paramref name="index" /> 和 <paramref name="count" /> 不表示 <paramref name="bytes" /> 中的有效范围。- 或 -产生的字符数超过了作为一个整数返回时允许的最大字符数。</exception>
  708. <exception cref="T:System.Text.DecoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得完整的解释)-和-将 <see cref="P:System.Text.Encoding.DecoderFallback" /> 设置为 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  709. <filterpriority>1</filterpriority>
  710. </member>
  711. <member name="M:System.Text.UTF7Encoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
  712. <summary>将从指定的字节指针开始的一个字节序列解码为一组字符,并从指定的字符指针开始存储这组字符。</summary>
  713. <returns>在由 <paramref name="chars" /> 指示的位置处写入的实际字符数。</returns>
  714. <param name="bytes">指向第一个要解码的字节的指针。</param>
  715. <param name="byteCount">要解码的字节数。</param>
  716. <param name="chars">一个指针,指向开始写入所产生的字符集的位置。</param>
  717. <param name="charCount">要写入的最大字符数。</param>
  718. <exception cref="T:System.ArgumentNullException">
  719. <paramref name="bytes" /> 为 null (Nothing)。- 或 -<paramref name="chars" /> 为 null (Nothing)。</exception>
  720. <exception cref="T:System.ArgumentOutOfRangeException">
  721. <paramref name="byteCount" /> 或 <paramref name="charCount" /> 小于零。</exception>
  722. <exception cref="T:System.ArgumentException">
  723. <paramref name="charCount" /> 少于所产生的字符数。</exception>
  724. <exception cref="T:System.Text.DecoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得完整的解释)-和-将 <see cref="P:System.Text.Encoding.DecoderFallback" /> 设置为 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  725. <filterpriority>1</filterpriority>
  726. </member>
  727. <member name="M:System.Text.UTF7Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
  728. <summary>将指定字节数组中的一个字节序列解码为指定的字符数组。</summary>
  729. <returns>写入 <paramref name="chars" /> 的实际字符数。</returns>
  730. <param name="bytes">包含要解码的字节序列的字节数组。</param>
  731. <param name="byteIndex">第一个要解码的字节的索引。</param>
  732. <param name="byteCount">要解码的字节数。</param>
  733. <param name="chars">要用于包含所产生的字符集的字符数组。</param>
  734. <param name="charIndex">开始写入所产生的字符集的索引位置。</param>
  735. <exception cref="T:System.ArgumentNullException">
  736. <paramref name="bytes" /> 为 null (Nothing)。- 或 -<paramref name="chars" /> 为 null (Nothing)。</exception>
  737. <exception cref="T:System.ArgumentOutOfRangeException">
  738. <paramref name="byteIndex" />、<paramref name="byteCount" /> 或 <paramref name="charIndex" /> 小于零。- 或 -<paramref name="byteindex" /> 和 <paramref name="byteCount" /> 不表示 <paramref name="bytes" /> 中的有效范围。- 或 -<paramref name="charIndex" /> 不是 <paramref name="chars" /> 中的有效索引。</exception>
  739. <exception cref="T:System.ArgumentException">
  740. <paramref name="chars" /> 中从 <paramref name="charIndex" /> 到数组结尾没有足够容量来容纳所产生的字符。</exception>
  741. <exception cref="T:System.Text.DecoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得完整的解释)-和-将 <see cref="P:System.Text.Encoding.DecoderFallback" /> 设置为 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  742. <filterpriority>1</filterpriority>
  743. </member>
  744. <member name="M:System.Text.UTF7Encoding.GetDecoder">
  745. <summary>获取可以将 UTF-7 编码的字节序列转换为 Unicode 字符序列的解码器。</summary>
  746. <returns>
  747. <see cref="T:System.Text.Decoder" /> 用于将 UTF-7 编码的字节序列转换为 Unicode 字符序列。</returns>
  748. <filterpriority>1</filterpriority>
  749. </member>
  750. <member name="M:System.Text.UTF7Encoding.GetEncoder">
  751. <summary>获取可将 Unicode 字符序列转换为 UTF-7 编码的字节序列的编码器。</summary>
  752. <returns>一个 <see cref="T:System.Text.Encoder" />,用于将 Unicode 字符序列转换为 UTF-7 编码的字节序列。</returns>
  753. <filterpriority>1</filterpriority>
  754. </member>
  755. <member name="M:System.Text.UTF7Encoding.GetHashCode">
  756. <summary>返回当前 <see cref="T:System.Text.UTF7Encoding" /> 对象的哈希代码。</summary>
  757. <returns>32 位有符号整数哈希代码。</returns>
  758. <filterpriority>1</filterpriority>
  759. </member>
  760. <member name="M:System.Text.UTF7Encoding.GetMaxByteCount(System.Int32)">
  761. <summary>计算对指定数目的字符进行编码时产生的最大字节数。</summary>
  762. <returns>对指定数目的字符进行编码所产生的最大字节数。</returns>
  763. <param name="charCount">要编码的字符的数目。</param>
  764. <exception cref="T:System.ArgumentOutOfRangeException">
  765. <paramref name="charCount" /> 小于零。- 或 -产生的字节数超过了作为一个整数返回时允许的最大字节数。</exception>
  766. <exception cref="T:System.Text.EncoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得完整的解释)-和-将 <see cref="P:System.Text.Encoding.EncoderFallback" /> 设置为 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  767. <filterpriority>1</filterpriority>
  768. </member>
  769. <member name="M:System.Text.UTF7Encoding.GetMaxCharCount(System.Int32)">
  770. <summary>计算对指定数目的字节进行解码时产生的最大字符数。</summary>
  771. <returns>对指定数目的字节进行解码时所产生的最大字符数。</returns>
  772. <param name="byteCount">要解码的字节数。</param>
  773. <exception cref="T:System.ArgumentOutOfRangeException">
  774. <paramref name="byteCount" /> 小于零。- 或 -产生的字符数超过了作为一个整数返回时允许的最大字符数。</exception>
  775. <exception cref="T:System.Text.DecoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得完整的解释)-和-将 <see cref="P:System.Text.Encoding.DecoderFallback" /> 设置为 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  776. <filterpriority>1</filterpriority>
  777. </member>
  778. <member name="M:System.Text.UTF7Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
  779. <summary>将字节数组中某个范围的字节解码为一个字符串。</summary>
  780. <returns>包含指定字节序列解码结果的 <see cref="T:System.String" />。</returns>
  781. <param name="bytes">包含要解码的字节序列的字节数组。</param>
  782. <param name="index">第一个要解码的字节的索引。</param>
  783. <param name="count">要解码的字节数。</param>
  784. <exception cref="T:System.ArgumentNullException">
  785. <paramref name="bytes" /> 为 null (Nothing)。</exception>
  786. <exception cref="T:System.ArgumentOutOfRangeException">
  787. <paramref name="index" /> 或 <paramref name="count" /> 小于零。- 或 -<paramref name="index" /> 和 <paramref name="count" /> 不表示 <paramref name="bytes" /> 中的有效范围。</exception>
  788. <exception cref="T:System.Text.DecoderFallbackException">发生回退(请参见.NET Framework 中的字符编码以获得更详细的解释)-和-将 <see cref="P:System.Text.Encoding.DecoderFallback" /> 设置为 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  789. <filterpriority>1</filterpriority>
  790. </member>
  791. <member name="T:System.Text.UTF8Encoding">
  792. <summary>表示 Unicode 字符的 UTF-8 编码。</summary>
  793. <filterpriority>1</filterpriority>
  794. </member>
  795. <member name="M:System.Text.UTF8Encoding.#ctor">
  796. <summary>初始化 <see cref="T:System.Text.UTF8Encoding" /> 类的新实例。</summary>
  797. </member>
  798. <member name="M:System.Text.UTF8Encoding.#ctor(System.Boolean)">
  799. <summary>初始化 <see cref="T:System.Text.UTF8Encoding" /> 类的新实例。参数指定是否提供一个 Unicode 字节顺序标记。</summary>
  800. <param name="encoderShouldEmitUTF8Identifier">如果为 true,则指定 <see cref="M:System.Text.UTF8Encoding.GetPreamble" /> 方法返回 Unicode 字节顺序标记;否则为 false。有关详细信息,请参阅备注部分。</param>
  801. </member>
  802. <member name="M:System.Text.UTF8Encoding.#ctor(System.Boolean,System.Boolean)">
  803. <summary>初始化 <see cref="T:System.Text.UTF8Encoding" /> 类的新实例。参数指定是否提供 Unicode 字节顺序标记,以及是否在检测到无效的编码时引发异常。</summary>
  804. <param name="encoderShouldEmitUTF8Identifier">如果为 true,则指定 <see cref="M:System.Text.UTF8Encoding.GetPreamble" /> 方法应返回 Unicode 字节顺序标记;否则为 false。有关详细信息,请参阅备注部分。</param>
  805. <param name="throwOnInvalidBytes">如果为 true,则在检测到无效的编码时引发异常;否则为 false。</param>
  806. </member>
  807. <member name="M:System.Text.UTF8Encoding.Equals(System.Object)">
  808. <summary>确定指定的对象是否等于当前 <see cref="T:System.Text.UTF8Encoding" /> 对象。</summary>
  809. <returns>如果 <paramref name="value" /> 是 <see cref="T:System.Text.UTF8Encoding" /> 的一个实例并且等于当前对象,则为 true;否则,为 false。</returns>
  810. <param name="value">要与当前实例进行比较的对象。</param>
  811. <filterpriority>2</filterpriority>
  812. </member>
  813. <member name="M:System.Text.UTF8Encoding.GetByteCount(System.Char*,System.Int32)">
  814. <summary>计算对从指定的字符指针开始的一组字符进行编码时产生的字节数。</summary>
  815. <returns>对指定字符进行编码后生成的字节数。</returns>
  816. <param name="chars">指向第一个要编码的字符的指针。</param>
  817. <param name="count">要编码的字符的数目。</param>
  818. <exception cref="T:System.ArgumentNullException">
  819. <paramref name="chars" /> is null. </exception>
  820. <exception cref="T:System.ArgumentOutOfRangeException">
  821. <paramref name="count" /> is less than zero.-or- The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  822. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters. </exception>
  823. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for a complete explanation)-and-<see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
  824. <filterpriority>1</filterpriority>
  825. </member>
  826. <member name="M:System.Text.UTF8Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
  827. <summary>计算对指定字符数组中的一组字符进行编码时产生的字节数。</summary>
  828. <returns>对指定字符进行编码后生成的字节数。</returns>
  829. <param name="chars">包含要编码的字符集的字符数组。</param>
  830. <param name="index">第一个要编码的字符的索引。</param>
  831. <param name="count">要编码的字符的数目。</param>
  832. <exception cref="T:System.ArgumentNullException">
  833. <paramref name="chars" /> is null. </exception>
  834. <exception cref="T:System.ArgumentOutOfRangeException">
  835. <paramref name="index" /> or <paramref name="count" /> is less than zero.-or- <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="chars" />.-or- The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  836. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters. </exception>
  837. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-The <see cref="P:System.Text.Encoding.EncoderFallback" /> property is set to <see cref="T:System.Text.EncoderExceptionFallback" />. </exception>
  838. <filterpriority>1</filterpriority>
  839. </member>
  840. <member name="M:System.Text.UTF8Encoding.GetByteCount(System.String)">
  841. <summary>计算对指定 <see cref="T:System.String" /> 中的字符进行编码时所产生的字节数。</summary>
  842. <returns>对指定字符进行编码后生成的字节数。</returns>
  843. <param name="chars">包含要编码的字符集的 <see cref="T:System.String" />。</param>
  844. <exception cref="T:System.ArgumentNullException">
  845. <paramref name="chars" /> is null. </exception>
  846. <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  847. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters. </exception>
  848. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
  849. <filterpriority>1</filterpriority>
  850. </member>
  851. <member name="M:System.Text.UTF8Encoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
  852. <summary>将从指定的字符指针开始的一组字符编码为一个字节序列,并从指定的字节指针开始存储该字节序列。</summary>
  853. <returns>在由 <paramref name="bytes" /> 指示的位置处写入的实际字节数。</returns>
  854. <param name="chars">指向第一个要编码的字符的指针。</param>
  855. <param name="charCount">要编码的字符的数目。</param>
  856. <param name="bytes">一个指针,指向开始写入所产生的字节序列的位置。</param>
  857. <param name="byteCount">最多写入的字节数。</param>
  858. <exception cref="T:System.ArgumentNullException">
  859. <paramref name="chars" /> is null.-or- <paramref name="bytes" /> is null. </exception>
  860. <exception cref="T:System.ArgumentOutOfRangeException">
  861. <paramref name="charCount" /> or <paramref name="byteCount" /> is less than zero. </exception>
  862. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.-or- <paramref name="byteCount" /> is less than the resulting number of bytes. </exception>
  863. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
  864. <filterpriority>1</filterpriority>
  865. </member>
  866. <member name="M:System.Text.UTF8Encoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
  867. <summary>将指定字符数组中的一组字符编码到指定的字节数组中。</summary>
  868. <returns>写入 <paramref name="bytes" /> 的实际字节数。</returns>
  869. <param name="chars">包含要编码的字符集的字符数组。</param>
  870. <param name="charIndex">第一个要编码的字符的索引。</param>
  871. <param name="charCount">要编码的字符的数目。</param>
  872. <param name="bytes">要包含所产生的字节序列的字节数组。</param>
  873. <param name="byteIndex">要开始写入所产生的字节序列的索引位置。</param>
  874. <exception cref="T:System.ArgumentNullException">
  875. <paramref name="chars" /> is null.-or- <paramref name="bytes" /> is null. </exception>
  876. <exception cref="T:System.ArgumentOutOfRangeException">
  877. <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.-or- <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.-or- <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />. </exception>
  878. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.-or- <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes. </exception>
  879. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
  880. <filterpriority>1</filterpriority>
  881. </member>
  882. <member name="M:System.Text.UTF8Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
  883. <summary>将指定 <see cref="T:System.String" /> 中的一组字符编码到指定的字节数组中。</summary>
  884. <returns>写入 <paramref name="bytes" /> 的实际字节数。</returns>
  885. <param name="s">包含要编码的字符集的 <see cref="T:System.String" />。</param>
  886. <param name="charIndex">第一个要编码的字符的索引。</param>
  887. <param name="charCount">要编码的字符的数目。</param>
  888. <param name="bytes">要包含所产生的字节序列的字节数组。</param>
  889. <param name="byteIndex">要开始写入所产生的字节序列的索引位置。</param>
  890. <exception cref="T:System.ArgumentNullException">
  891. <paramref name="s" /> is null.-or- <paramref name="bytes" /> is null. </exception>
  892. <exception cref="T:System.ArgumentOutOfRangeException">
  893. <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.-or- <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.-or- <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />. </exception>
  894. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s" /> contains an invalid sequence of characters.-or- <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes. </exception>
  895. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
  896. <filterpriority>1</filterpriority>
  897. </member>
  898. <member name="M:System.Text.UTF8Encoding.GetCharCount(System.Byte*,System.Int32)">
  899. <summary>计算对一个字节序列(从指定的字节指针开始)进行解码所产生的字符数。</summary>
  900. <returns>对指定字节序列进行解码所产生的字符数。</returns>
  901. <param name="bytes">指向第一个要解码的字节的指针。</param>
  902. <param name="count">要解码的字节数。</param>
  903. <exception cref="T:System.ArgumentNullException">
  904. <paramref name="bytes" /> is null. </exception>
  905. <exception cref="T:System.ArgumentOutOfRangeException">
  906. <paramref name="count" /> is less than zero.-or- The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  907. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes. </exception>
  908. <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
  909. <filterpriority>1</filterpriority>
  910. </member>
  911. <member name="M:System.Text.UTF8Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
  912. <summary>计算对指定字节数组中的一个字节序列进行解码所产生的字符数。</summary>
  913. <returns>对指定字节序列进行解码所产生的字符数。</returns>
  914. <param name="bytes">包含要解码的字节序列的字节数组。</param>
  915. <param name="index">第一个要解码的字节的索引。</param>
  916. <param name="count">要解码的字节数。</param>
  917. <exception cref="T:System.ArgumentNullException">
  918. <paramref name="bytes" /> is null. </exception>
  919. <exception cref="T:System.ArgumentOutOfRangeException">
  920. <paramref name="index" /> or <paramref name="count" /> is less than zero.-or- <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.-or- The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  921. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes. </exception>
  922. <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
  923. <filterpriority>1</filterpriority>
  924. </member>
  925. <member name="M:System.Text.UTF8Encoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
  926. <summary>将从指定的字节指针开始的一个字节序列解码为一组字符,并从指定的字符指针开始存储这组字符。</summary>
  927. <returns>在由 <paramref name="chars" /> 指示的位置处写入的实际字符数。</returns>
  928. <param name="bytes">指向第一个要解码的字节的指针。</param>
  929. <param name="byteCount">要解码的字节数。</param>
  930. <param name="chars">一个指针,指向开始写入所产生的字符集的位置。</param>
  931. <param name="charCount">要写入的最大字符数。</param>
  932. <exception cref="T:System.ArgumentNullException">
  933. <paramref name="bytes" /> is null.-or- <paramref name="chars" /> is null. </exception>
  934. <exception cref="T:System.ArgumentOutOfRangeException">
  935. <paramref name="byteCount" /> or <paramref name="charCount" /> is less than zero. </exception>
  936. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.-or- <paramref name="charCount" /> is less than the resulting number of characters. </exception>
  937. <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
  938. <filterpriority>1</filterpriority>
  939. </member>
  940. <member name="M:System.Text.UTF8Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
  941. <summary>将指定字节数组中的一个字节序列解码为指定的字符数组。</summary>
  942. <returns>写入 <paramref name="chars" /> 的实际字符数。</returns>
  943. <param name="bytes">包含要解码的字节序列的字节数组。</param>
  944. <param name="byteIndex">第一个要解码的字节的索引。</param>
  945. <param name="byteCount">要解码的字节数。</param>
  946. <param name="chars">要用于包含所产生的字符集的字符数组。</param>
  947. <param name="charIndex">开始写入所产生的字符集的索引位置。</param>
  948. <exception cref="T:System.ArgumentNullException">
  949. <paramref name="bytes" /> is null.-or- <paramref name="chars" /> is null. </exception>
  950. <exception cref="T:System.ArgumentOutOfRangeException">
  951. <paramref name="byteIndex" /> or <paramref name="byteCount" /> or <paramref name="charIndex" /> is less than zero.-or- <paramref name="byteindex" /> and <paramref name="byteCount" /> do not denote a valid range in <paramref name="bytes" />.-or- <paramref name="charIndex" /> is not a valid index in <paramref name="chars" />. </exception>
  952. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.-or- <paramref name="chars" /> does not have enough capacity from <paramref name="charIndex" /> to the end of the array to accommodate the resulting characters. </exception>
  953. <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
  954. <filterpriority>1</filterpriority>
  955. </member>
  956. <member name="M:System.Text.UTF8Encoding.GetDecoder">
  957. <summary>获取可以将 UTF-8 编码的字节序列转换为 Unicode 字符序列的解码器。</summary>
  958. <returns>可以将 UTF-8 编码的字节序列转换为 Unicode 字符序列的解码器。</returns>
  959. <filterpriority>1</filterpriority>
  960. </member>
  961. <member name="M:System.Text.UTF8Encoding.GetEncoder">
  962. <summary>获取可将 Unicode 字符序列转换为 UTF-8 编码的字节序列的编码器。</summary>
  963. <returns>一个 <see cref="T:System.Text.Encoder" />,用于将 Unicode 字符序列转换为 UTF-8 编码的字节序列。</returns>
  964. <filterpriority>1</filterpriority>
  965. </member>
  966. <member name="M:System.Text.UTF8Encoding.GetHashCode">
  967. <summary>返回当前实例的哈希代码。</summary>
  968. <returns>当前实例的哈希代码。</returns>
  969. <filterpriority>1</filterpriority>
  970. </member>
  971. <member name="M:System.Text.UTF8Encoding.GetMaxByteCount(System.Int32)">
  972. <summary>计算对指定数目的字符进行编码时产生的最大字节数。</summary>
  973. <returns>对指定数目的字符进行编码所产生的最大字节数。</returns>
  974. <param name="charCount">要编码的字符的数目。</param>
  975. <exception cref="T:System.ArgumentOutOfRangeException">
  976. <paramref name="charCount" /> is less than zero.-or- The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  977. <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
  978. <filterpriority>1</filterpriority>
  979. </member>
  980. <member name="M:System.Text.UTF8Encoding.GetMaxCharCount(System.Int32)">
  981. <summary>计算对指定数目的字节进行解码时产生的最大字符数。</summary>
  982. <returns>对指定数目的字节进行解码时所产生的最大字符数。</returns>
  983. <param name="byteCount">要解码的字节数。</param>
  984. <exception cref="T:System.ArgumentOutOfRangeException">
  985. <paramref name="byteCount" /> is less than zero.-or- The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  986. <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
  987. <filterpriority>1</filterpriority>
  988. </member>
  989. <member name="M:System.Text.UTF8Encoding.GetPreamble">
  990. <summary>返回一个采用 UTF-8 格式编码的 Unicode 字节顺序标记(如果 <see cref="T:System.Text.UTF8Encoding" /> 编码对象配置为提供一个这样的标记)。</summary>
  991. <returns>一个包含 Unicode 字节顺序标记的字节数组(如果 <see cref="T:System.Text.UTF8Encoding" /> 编码对象配置为提供一个这样的字节数组)。否则,此方法返回一个零长度的字节数组。</returns>
  992. <filterpriority>1</filterpriority>
  993. </member>
  994. <member name="M:System.Text.UTF8Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
  995. <summary>将字节数组中某个范围的字节解码为一个字符串。</summary>
  996. <returns>包含指定字节序列解码结果的 <see cref="T:System.String" />。</returns>
  997. <param name="bytes">包含要解码的字节序列的字节数组。</param>
  998. <param name="index">第一个要解码的字节的索引。</param>
  999. <param name="count">要解码的字节数。</param>
  1000. <exception cref="T:System.ArgumentNullException">
  1001. <paramref name="bytes" /> is null. </exception>
  1002. <exception cref="T:System.ArgumentOutOfRangeException">
  1003. <paramref name="index" /> or <paramref name="count" /> is less than zero.-or- <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />. </exception>
  1004. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes. </exception>
  1005. <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see .NET Framework 中的字符编码 for complete explanation)-and-<see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
  1006. <filterpriority>1</filterpriority>
  1007. </member>
  1008. </members>
  1009. </doc>