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.
 
 
 
 
 
 

1019 lines
87 KiB

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