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.
 
 
 
 
 
 

1024 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">
  43. <see cref="T:System.String" /> 包含要編碼的一組字元。</param>
  44. <exception cref="T:System.ArgumentNullException">
  45. <paramref name="chars" /> 為 null。</exception>
  46. <exception cref="T:System.ArgumentOutOfRangeException">產生的位元組數目大於可做為整數傳回的最大值。</exception>
  47. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  48. <filterpriority>1</filterpriority>
  49. </member>
  50. <member name="M:System.Text.ASCIIEncoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
  51. <summary>將起始於指定字元指標的字元編碼成位元組序列;儲存該位元組序列時,係以指定的位元組指標為起始點。</summary>
  52. <returns>在 <paramref name="bytes" /> 所指示位置上寫入的實際位元組數。</returns>
  53. <param name="chars">要編碼的第一個字元指標。</param>
  54. <param name="charCount">要編碼的字元數。</param>
  55. <param name="bytes">開始寫入結果位元組序列的位置指標。</param>
  56. <param name="byteCount">寫入的最大位元組數。</param>
  57. <exception cref="T:System.ArgumentNullException">
  58. <paramref name="chars" /> 為 null。-或-<paramref name="bytes" /> 為 null。</exception>
  59. <exception cref="T:System.ArgumentOutOfRangeException">
  60. <paramref name="charCount" /> 或 <paramref name="byteCount" /> 小於零。</exception>
  61. <exception cref="T:System.ArgumentException">
  62. <paramref name="byteCount" /> 小於結果位元組數。</exception>
  63. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  64. <filterpriority>1</filterpriority>
  65. </member>
  66. <member name="M:System.Text.ASCIIEncoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
  67. <summary>將一組字元從指定的字元陣列編碼成指定的位元組陣列。</summary>
  68. <returns>寫入 <paramref name="bytes" /> 的實際位元組數。</returns>
  69. <param name="chars">包含要解碼之一組字元的字元陣列。</param>
  70. <param name="charIndex">要編碼的第一個字元索引。</param>
  71. <param name="charCount">要編碼的字元數。</param>
  72. <param name="bytes">要包含結果位元組序列的位元組陣列。</param>
  73. <param name="byteIndex">要開始寫入結果位元組序列的索引。</param>
  74. <exception cref="T:System.ArgumentNullException">
  75. <paramref name="chars" /> 為 null。-或-<paramref name="bytes" /> 為 null。</exception>
  76. <exception cref="T:System.ArgumentOutOfRangeException">
  77. <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>
  78. <exception cref="T:System.ArgumentException">從 <paramref name="byteIndex" /> 到陣列結尾處,<paramref name="bytes" /> 沒有足夠的容量容納結果位元組。</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">
  86. <see cref="T:System.String" /> 包含要編碼的一組字元。</param>
  87. <param name="charIndex">要編碼的第一個字元索引。</param>
  88. <param name="charCount">要編碼的字元數。</param>
  89. <param name="bytes">要包含結果位元組序列的位元組陣列。</param>
  90. <param name="byteIndex">要開始寫入結果位元組序列的索引。</param>
  91. <exception cref="T:System.ArgumentNullException">
  92. <paramref name="s" /> 為 null。-或-<paramref name="bytes" /> 為 null。</exception>
  93. <exception cref="T:System.ArgumentOutOfRangeException">
  94. <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>
  95. <exception cref="T:System.ArgumentException">從 <paramref name="byteIndex" /> 到陣列結尾處,<paramref name="bytes" /> 沒有足夠的容量容納結果位元組。</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">從 <paramref name="charIndex" /> 到陣列結尾處,<paramref name="chars" /> 沒有足夠的容量容納結果字元。</exception>
  153. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  154. <filterpriority>1</filterpriority>
  155. </member>
  156. <member name="M:System.Text.ASCIIEncoding.GetDecoder">
  157. <summary>取得可以將以 ASCII 編碼的位元組序列轉換成 Unicode 字元序列的解碼器。</summary>
  158. <returns>
  159. <see cref="T:System.Text.Decoder" />,可以將以 ASCII 編碼的位元組序列轉換成 Unicode 字元序列。</returns>
  160. <filterpriority>1</filterpriority>
  161. </member>
  162. <member name="M:System.Text.ASCIIEncoding.GetEncoder">
  163. <summary>取得可以將 Unicode 字元序列轉換成以 ASCII 編碼的位元組序列的編碼器。</summary>
  164. <returns>
  165. <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>
  187. <see cref="T:System.String" />,包含將指定之位元組序列解碼的結果。</returns>
  188. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  189. <param name="byteIndex">要解碼的第一個位元組索引。</param>
  190. <param name="byteCount">要解碼的位元組數。</param>
  191. <exception cref="T:System.ArgumentNullException">
  192. <paramref name="bytes" /> 為 null。</exception>
  193. <exception cref="T:System.ArgumentOutOfRangeException">
  194. <paramref name="index" /> 或 <paramref name="count" /> 小於零。-或-<paramref name="index" /> 和 <paramref name="count" /> 不代表 <paramref name="bytes" /> 中有效的範圍。</exception>
  195. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  196. <filterpriority>1</filterpriority>
  197. </member>
  198. <member name="P:System.Text.ASCIIEncoding.IsSingleByte">
  199. <summary>取得值,指出目前的編碼方式是否使用單一位元組字碼指標。</summary>
  200. <returns>這個屬性經常是 true。</returns>
  201. <filterpriority>2</filterpriority>
  202. </member>
  203. <member name="T:System.Text.UnicodeEncoding">
  204. <summary>代表 Unicode 字元的 UTF-16 編碼方式。</summary>
  205. <filterpriority>1</filterpriority>
  206. </member>
  207. <member name="M:System.Text.UnicodeEncoding.#ctor">
  208. <summary>初始化 <see cref="T:System.Text.UnicodeEncoding" /> 類別的新執行個體。</summary>
  209. </member>
  210. <member name="M:System.Text.UnicodeEncoding.#ctor(System.Boolean,System.Boolean)">
  211. <summary>初始化 <see cref="T:System.Text.UnicodeEncoding" /> 類別的新執行個體。參數會指定是否使用位元組由大到小的位元組順序,以及 <see cref="M:System.Text.UnicodeEncoding.GetPreamble" /> 方法是否傳回 Unicode 位元組順序標記。</summary>
  212. <param name="bigEndian">true 表示要使用位元組由大到小的位元組順序 (最大顯著性位元組在前),false 表示要使用位元組由小到大的位元組順序 (最小顯著性位元組在前)。</param>
  213. <param name="byteOrderMark">true 指定 <see cref="M:System.Text.UnicodeEncoding.GetPreamble" /> 方法會傳回 Unicode 位元組順序標記,否則為 false。如需詳細資訊,請參閱<備註>一節。</param>
  214. </member>
  215. <member name="M:System.Text.UnicodeEncoding.#ctor(System.Boolean,System.Boolean,System.Boolean)">
  216. <summary>初始化 <see cref="T:System.Text.UnicodeEncoding" /> 類別的新執行個體。參數會指定是否使用位元組由大到小的位元組順序、是否提供 Unicode 位元組順序標記,以及是否在偵測到無效的編碼方式時擲回例外狀況。</summary>
  217. <param name="bigEndian">true 表示要使用位元組由大到小的位元組順序 (最大顯著性位元組在前),false 表示要使用位元組由小到大的位元組順序 (最小顯著性位元組在前)。</param>
  218. <param name="byteOrderMark">true 指定 <see cref="M:System.Text.UnicodeEncoding.GetPreamble" /> 方法會傳回 Unicode 位元組順序標記,否則為 false。如需詳細資訊,請參閱<備註>一節。</param>
  219. <param name="throwOnInvalidBytes">true 指定在偵測到無效的編碼方式時應擲回例外狀況,否則為 false。</param>
  220. </member>
  221. <member name="M:System.Text.UnicodeEncoding.Equals(System.Object)">
  222. <summary>判斷指定的 <see cref="T:System.Object" /> 物件是否等於目前的 <see cref="T:System.Text.UnicodeEncoding" /> 物件。</summary>
  223. <returns>如果 <paramref name="value" /> 是 <see cref="T:System.Text.UnicodeEncoding" /> 的執行個體,並且等於目前的物件,則為 true;否則為 false。</returns>
  224. <param name="value">要與目前物件比較的物件。</param>
  225. <filterpriority>2</filterpriority>
  226. </member>
  227. <member name="M:System.Text.UnicodeEncoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
  228. <summary>計算將指定字元陣列中的一組字元編碼所產生的位元組數目。</summary>
  229. <returns>編碼指定字元所產生的位元組數。</returns>
  230. <param name="chars">包含要解碼之一組字元的字元陣列。</param>
  231. <param name="index">要編碼的第一個字元索引。</param>
  232. <param name="count">要編碼的字元數。</param>
  233. <exception cref="T:System.ArgumentNullException">
  234. <paramref name="chars" /> is null (Nothing). </exception>
  235. <exception cref="T:System.ArgumentOutOfRangeException">
  236. <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>
  237. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters. </exception>
  238. <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>
  239. <filterpriority>1</filterpriority>
  240. </member>
  241. <member name="M:System.Text.UnicodeEncoding.GetByteCount(System.String)">
  242. <summary>計算將指定字串中的字元編碼所產生的位元組數目。</summary>
  243. <returns>編碼指定字元所產生的位元組數。</returns>
  244. <param name="s">字串,包含要編碼的一組字元。</param>
  245. <exception cref="T:System.ArgumentNullException">
  246. <paramref name="s" /> is null . </exception>
  247. <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  248. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s" /> contains an invalid sequence of characters. </exception>
  249. <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>
  250. <filterpriority>1</filterpriority>
  251. </member>
  252. <member name="M:System.Text.UnicodeEncoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
  253. <summary>將指定字元陣列中的一組字元編碼成指定的位元組陣列。</summary>
  254. <returns>寫入 <paramref name="bytes" /> 的實際位元組數。</returns>
  255. <param name="chars">包含要解碼之一組字元的字元陣列。</param>
  256. <param name="charIndex">要編碼的第一個字元索引。</param>
  257. <param name="charCount">要編碼的字元數。</param>
  258. <param name="bytes">要包含結果位元組序列的位元組陣列。</param>
  259. <param name="byteIndex">要開始寫入結果位元組序列的索引。</param>
  260. <exception cref="T:System.ArgumentNullException">
  261. <paramref name="chars" /> is null (Nothing).-or- <paramref name="bytes" /> is null (Nothing). </exception>
  262. <exception cref="T:System.ArgumentOutOfRangeException">
  263. <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>
  264. <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>
  265. <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>
  266. <filterpriority>1</filterpriority>
  267. </member>
  268. <member name="M:System.Text.UnicodeEncoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
  269. <summary>將指定 <see cref="T:System.String" /> 中的一組字元編碼成指定的位元組陣列。</summary>
  270. <returns>寫入 <paramref name="bytes" /> 的實際位元組數。</returns>
  271. <param name="s">字串,包含要編碼的一組字元。</param>
  272. <param name="charIndex">要編碼的第一個字元索引。</param>
  273. <param name="charCount">要編碼的字元數。</param>
  274. <param name="bytes">要包含結果位元組序列的位元組陣列。</param>
  275. <param name="byteIndex">要開始寫入結果位元組序列的索引。</param>
  276. <exception cref="T:System.ArgumentNullException">
  277. <paramref name="s" /> is null .-or- <paramref name="bytes" /> is null (Nothing). </exception>
  278. <exception cref="T:System.ArgumentOutOfRangeException">
  279. <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>
  280. <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>
  281. <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>
  282. <filterpriority>1</filterpriority>
  283. </member>
  284. <member name="M:System.Text.UnicodeEncoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
  285. <summary>計算將指定位元組陣列中的位元組序列解碼所產生的字元數。</summary>
  286. <returns>解碼指定位元組序列所產生的字元數。</returns>
  287. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  288. <param name="index">要解碼的第一個位元組索引。</param>
  289. <param name="count">要解碼的位元組數。</param>
  290. <exception cref="T:System.ArgumentNullException">
  291. <paramref name="bytes" /> is null (Nothing). </exception>
  292. <exception cref="T:System.ArgumentOutOfRangeException">
  293. <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>
  294. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes. </exception>
  295. <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>
  296. <filterpriority>1</filterpriority>
  297. </member>
  298. <member name="M:System.Text.UnicodeEncoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
  299. <summary>將指定位元組陣列中的位元組序列解碼成指定的字元陣列。</summary>
  300. <returns>寫入 <paramref name="chars" /> 的實際字元數。</returns>
  301. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  302. <param name="byteIndex">要解碼的第一個位元組索引。</param>
  303. <param name="byteCount">要解碼的位元組數。</param>
  304. <param name="chars">包含產生的一組字元之字元陣列。</param>
  305. <param name="charIndex">要開始寫入產生的一組字元之索引。</param>
  306. <exception cref="T:System.ArgumentNullException">
  307. <paramref name="bytes" /> is null (Nothing).-or- <paramref name="chars" /> is null (Nothing). </exception>
  308. <exception cref="T:System.ArgumentOutOfRangeException">
  309. <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>
  310. <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>
  311. <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>
  312. <filterpriority>1</filterpriority>
  313. </member>
  314. <member name="M:System.Text.UnicodeEncoding.GetDecoder">
  315. <summary>取得可以將以 UTF-16 編碼的位元組序列轉換成 Unicode 字元序列的解碼器。</summary>
  316. <returns>
  317. <see cref="T:System.Text.Decoder" />,可以將以 UTF-16 編碼的位元組序列轉換成 Unicode 字元序列。</returns>
  318. <filterpriority>1</filterpriority>
  319. </member>
  320. <member name="M:System.Text.UnicodeEncoding.GetEncoder">
  321. <summary>取得可以將 Unicode 字元序列轉換成以 UTF-16 編碼的位元組序列的編碼器。</summary>
  322. <returns>
  323. <see cref="T:System.Text.Encoder" /> 物件,可以將 Unicode 字元序列轉換成以 UTF-16 編碼的位元組序列。</returns>
  324. <filterpriority>1</filterpriority>
  325. </member>
  326. <member name="M:System.Text.UnicodeEncoding.GetHashCode">
  327. <summary>傳回目前執行個體的雜湊碼。</summary>
  328. <returns>目前 <see cref="T:System.Text.UnicodeEncoding" /> 物件的雜湊碼。</returns>
  329. <filterpriority>1</filterpriority>
  330. </member>
  331. <member name="M:System.Text.UnicodeEncoding.GetMaxByteCount(System.Int32)">
  332. <summary>計算將指定數目的字元編碼所產生的最大位元組數目。</summary>
  333. <returns>編碼指定字元數所產生的最大位元組數。</returns>
  334. <param name="charCount">要編碼的字元數。</param>
  335. <exception cref="T:System.ArgumentOutOfRangeException">
  336. <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>
  337. <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>
  338. <filterpriority>1</filterpriority>
  339. </member>
  340. <member name="M:System.Text.UnicodeEncoding.GetMaxCharCount(System.Int32)">
  341. <summary>計算將指定數目的位元組解碼所產生的最大字元數。</summary>
  342. <returns>解碼指定位元組數所產生的最大字元數。</returns>
  343. <param name="byteCount">要解碼的位元組數。</param>
  344. <exception cref="T:System.ArgumentOutOfRangeException">
  345. <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>
  346. <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>
  347. <filterpriority>1</filterpriority>
  348. </member>
  349. <member name="M:System.Text.UnicodeEncoding.GetPreamble">
  350. <summary>如果這個執行個體的建構函式要求位元組順序標記,則會傳回以 UTF-16 格式編碼的 Unicode 位元組順序標記。</summary>
  351. <returns>如果設定 <see cref="T:System.Text.UnicodeEncoding" /> 物件提供編碼方式,則為包含 Unicode 位元組順序標記的位元組陣列。否則,這個方法會傳回長度為零的位元組陣列。</returns>
  352. <filterpriority>1</filterpriority>
  353. </member>
  354. <member name="M:System.Text.UnicodeEncoding.GetString(System.Byte[],System.Int32,System.Int32)">
  355. <summary>將位元組陣列中的某一段位元組範圍解碼成字串。</summary>
  356. <returns>
  357. <see cref="T:System.String" /> 物件,包含將指定之位元組序列解碼的結果。</returns>
  358. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  359. <param name="index">要解碼的第一個位元組索引。</param>
  360. <param name="count">要解碼的位元組數。</param>
  361. <exception cref="T:System.ArgumentNullException">
  362. <paramref name="bytes" /> is null (Nothing). </exception>
  363. <exception cref="T:System.ArgumentOutOfRangeException">
  364. <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>
  365. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes. </exception>
  366. <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>
  367. <filterpriority>1</filterpriority>
  368. </member>
  369. <member name="T:System.Text.UTF32Encoding">
  370. <summary>代表 Unicode 字元的 UTF-32 編碼方式。</summary>
  371. <filterpriority>1</filterpriority>
  372. </member>
  373. <member name="M:System.Text.UTF32Encoding.#ctor">
  374. <summary>初始化 <see cref="T:System.Text.UTF32Encoding" /> 類別的新執行個體。</summary>
  375. </member>
  376. <member name="M:System.Text.UTF32Encoding.#ctor(System.Boolean,System.Boolean)">
  377. <summary>初始化 <see cref="T:System.Text.UTF32Encoding" /> 類別的新執行個體。參數會指定是否使用位元組由大到小的位元組順序,以及 <see cref="M:System.Text.UTF32Encoding.GetPreamble" /> 方法是否傳回 Unicode 位元組順序標記。</summary>
  378. <param name="bigEndian">true 表示要使用位元組由大到小的位元組順序 (最大顯著性位元組在前),false 表示要使用位元組由小到大的位元組順序 (最小顯著性位元組在前)。</param>
  379. <param name="byteOrderMark">true 指定提供 Unicode 位元組順序標記;否則為 false。</param>
  380. </member>
  381. <member name="M:System.Text.UTF32Encoding.#ctor(System.Boolean,System.Boolean,System.Boolean)">
  382. <summary>初始化 <see cref="T:System.Text.UTF32Encoding" /> 類別的新執行個體。參數會指定是否使用位元組由大到小的位元組順序、是否提供 Unicode 位元組順序標記,以及是否在偵測到無效的編碼方式時擲回例外狀況。</summary>
  383. <param name="bigEndian">true 表示要使用位元組由大到小的位元組順序 (最大顯著性位元組在前),false 表示要使用位元組由小到大的位元組順序 (最小顯著性位元組在前)。</param>
  384. <param name="byteOrderMark">true 指定提供 Unicode 位元組順序標記;否則為 false。</param>
  385. <param name="throwOnInvalidCharacters">true 指定在偵測到無效的編碼方式時應擲回例外狀況;否則為 false。</param>
  386. </member>
  387. <member name="M:System.Text.UTF32Encoding.Equals(System.Object)">
  388. <summary>判斷指定的 <see cref="T:System.Object" /> 是否等於目前的 <see cref="T:System.Text.UTF32Encoding" /> 物件。</summary>
  389. <returns>如果 <paramref name="value" /> 是 <see cref="T:System.Text.UTF32Encoding" /> 的執行個體,並且等於目前的物件,則為 true;否則為 false。</returns>
  390. <param name="value">要與目前物件比較的 <see cref="T:System.Object" />。</param>
  391. <filterpriority>2</filterpriority>
  392. </member>
  393. <member name="M:System.Text.UTF32Encoding.GetByteCount(System.Char*,System.Int32)">
  394. <summary>計算將起始於指定字元指標的一組字元編碼所產生的位元組數目。</summary>
  395. <returns>編碼指定字元所產生的位元組數。</returns>
  396. <param name="chars">要編碼的第一個字元指標。</param>
  397. <param name="count">要編碼的字元數。</param>
  398. <exception cref="T:System.ArgumentNullException">
  399. <paramref name="chars" /> is null. </exception>
  400. <exception cref="T:System.ArgumentOutOfRangeException">
  401. <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>
  402. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters. </exception>
  403. <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>
  404. <filterpriority>1</filterpriority>
  405. </member>
  406. <member name="M:System.Text.UTF32Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
  407. <summary>計算將指定字元陣列中的一組字元編碼所產生的位元組數目。</summary>
  408. <returns>編碼指定字元所產生的位元組數。</returns>
  409. <param name="chars">包含要解碼之一組字元的字元陣列。</param>
  410. <param name="index">要編碼的第一個字元索引。</param>
  411. <param name="count">要編碼的字元數。</param>
  412. <exception cref="T:System.ArgumentNullException">
  413. <paramref name="chars" /> is null. </exception>
  414. <exception cref="T:System.ArgumentOutOfRangeException">
  415. <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>
  416. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters. </exception>
  417. <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>
  418. <filterpriority>1</filterpriority>
  419. </member>
  420. <member name="M:System.Text.UTF32Encoding.GetByteCount(System.String)">
  421. <summary>計算將指定 <see cref="T:System.String" /> 中的字元編碼所產生的位元組數目。</summary>
  422. <returns>編碼指定字元所產生的位元組數。</returns>
  423. <param name="s">
  424. <see cref="T:System.String" />,包含要編碼的一組字元。</param>
  425. <exception cref="T:System.ArgumentNullException">
  426. <paramref name="s" /> is null. </exception>
  427. <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  428. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s" /> contains an invalid sequence of characters. </exception>
  429. <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>
  430. <filterpriority>1</filterpriority>
  431. </member>
  432. <member name="M:System.Text.UTF32Encoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
  433. <summary>將起始於指定字元指標的一組字元編碼成位元組序列;儲存該位元組序列時,係以指定的位元組指標為起始點。</summary>
  434. <returns>
  435. <paramref name="bytes" /> 參數所指示位置上寫入的實際位元組數目。</returns>
  436. <param name="chars">要編碼的第一個字元指標。</param>
  437. <param name="charCount">要編碼的字元數。</param>
  438. <param name="bytes">開始寫入結果位元組序列的位置指標。</param>
  439. <param name="byteCount">寫入的最大位元組數。</param>
  440. <exception cref="T:System.ArgumentNullException">
  441. <paramref name="chars" /> is null.-or- <paramref name="bytes" /> is null. </exception>
  442. <exception cref="T:System.ArgumentOutOfRangeException">
  443. <paramref name="charCount" /> or <paramref name="byteCount" /> is less than zero. </exception>
  444. <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>
  445. <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>
  446. <filterpriority>1</filterpriority>
  447. </member>
  448. <member name="M:System.Text.UTF32Encoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
  449. <summary>將指定字元陣列中的一組字元編碼成指定的位元組陣列。</summary>
  450. <returns>寫入 <paramref name="bytes" /> 的實際位元組數。</returns>
  451. <param name="chars">包含要解碼之一組字元的字元陣列。</param>
  452. <param name="charIndex">要編碼的第一個字元索引。</param>
  453. <param name="charCount">要編碼的字元數。</param>
  454. <param name="bytes">要包含結果位元組序列的位元組陣列。</param>
  455. <param name="byteIndex">要開始寫入結果位元組序列的索引。</param>
  456. <exception cref="T:System.ArgumentNullException">
  457. <paramref name="chars" /> is null.-or- <paramref name="bytes" /> is null. </exception>
  458. <exception cref="T:System.ArgumentOutOfRangeException">
  459. <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>
  460. <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>
  461. <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>
  462. <filterpriority>1</filterpriority>
  463. </member>
  464. <member name="M:System.Text.UTF32Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
  465. <summary>將指定 <see cref="T:System.String" /> 中的一組字元編碼成指定的位元組陣列。</summary>
  466. <returns>寫入 <paramref name="bytes" /> 的實際位元組數。</returns>
  467. <param name="s">
  468. <see cref="T:System.String" />,包含要編碼的一組字元。</param>
  469. <param name="charIndex">要編碼的第一個字元索引。</param>
  470. <param name="charCount">要編碼的字元數。</param>
  471. <param name="bytes">要包含結果位元組序列的位元組陣列。</param>
  472. <param name="byteIndex">要開始寫入結果位元組序列的索引。</param>
  473. <exception cref="T:System.ArgumentNullException">
  474. <paramref name="s" /> is null.-or- <paramref name="bytes" /> is null. </exception>
  475. <exception cref="T:System.ArgumentOutOfRangeException">
  476. <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>
  477. <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>
  478. <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>
  479. <filterpriority>1</filterpriority>
  480. </member>
  481. <member name="M:System.Text.UTF32Encoding.GetCharCount(System.Byte*,System.Int32)">
  482. <summary>計算將起始於指定位元組指標的位元組序列解碼所產生的字元數。</summary>
  483. <returns>解碼指定位元組序列所產生的字元數。</returns>
  484. <param name="bytes">要解碼的第一個位元組指標。</param>
  485. <param name="count">要解碼的位元組數。</param>
  486. <exception cref="T:System.ArgumentNullException">
  487. <paramref name="bytes" /> is null. </exception>
  488. <exception cref="T:System.ArgumentOutOfRangeException">
  489. <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>
  490. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes. </exception>
  491. <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>
  492. <filterpriority>1</filterpriority>
  493. </member>
  494. <member name="M:System.Text.UTF32Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
  495. <summary>計算將指定位元組陣列中的位元組序列解碼所產生的字元數。</summary>
  496. <returns>解碼指定位元組序列所產生的字元數。</returns>
  497. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  498. <param name="index">要解碼的第一個位元組索引。</param>
  499. <param name="count">要解碼的位元組數。</param>
  500. <exception cref="T:System.ArgumentNullException">
  501. <paramref name="bytes" /> is null. </exception>
  502. <exception cref="T:System.ArgumentOutOfRangeException">
  503. <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>
  504. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes. </exception>
  505. <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>
  506. <filterpriority>1</filterpriority>
  507. </member>
  508. <member name="M:System.Text.UTF32Encoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
  509. <summary>將起始於指定位元組指標的位元組序列解碼成一組字元;儲存該組字元時,係以指定的字元指標為起始點。</summary>
  510. <returns>在 <paramref name="chars" /> 所表示的位置上寫入的實際字元數。</returns>
  511. <param name="bytes">要解碼的第一個位元組指標。</param>
  512. <param name="byteCount">要解碼的位元組數。</param>
  513. <param name="chars">開始寫入產生的一組字元之位置指標。</param>
  514. <param name="charCount">要寫入的最大字元數。</param>
  515. <exception cref="T:System.ArgumentNullException">
  516. <paramref name="bytes" /> is null.-or- <paramref name="chars" /> is null. </exception>
  517. <exception cref="T:System.ArgumentOutOfRangeException">
  518. <paramref name="byteCount" /> or <paramref name="charCount" /> is less than zero. </exception>
  519. <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>
  520. <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>
  521. <filterpriority>1</filterpriority>
  522. </member>
  523. <member name="M:System.Text.UTF32Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
  524. <summary>將指定位元組陣列中的位元組序列解碼成指定的字元陣列。</summary>
  525. <returns>寫入 <paramref name="chars" /> 的實際字元數。</returns>
  526. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  527. <param name="byteIndex">要解碼的第一個位元組索引。</param>
  528. <param name="byteCount">要解碼的位元組數。</param>
  529. <param name="chars">包含產生的一組字元之字元陣列。</param>
  530. <param name="charIndex">要開始寫入產生的一組字元之索引。</param>
  531. <exception cref="T:System.ArgumentNullException">
  532. <paramref name="bytes" /> is null.-or- <paramref name="chars" /> is null. </exception>
  533. <exception cref="T:System.ArgumentOutOfRangeException">
  534. <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>
  535. <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>
  536. <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>
  537. <filterpriority>1</filterpriority>
  538. </member>
  539. <member name="M:System.Text.UTF32Encoding.GetDecoder">
  540. <summary>取得可以將以 UTF-32 編碼的位元組序列轉換成 Unicode 字元序列的解碼器。</summary>
  541. <returns>
  542. <see cref="T:System.Text.Decoder" />,可以將以 UTF-32 編碼的位元組序列轉換成 Unicode 字元序列。</returns>
  543. <filterpriority>1</filterpriority>
  544. </member>
  545. <member name="M:System.Text.UTF32Encoding.GetEncoder">
  546. <summary>取得可以將 Unicode 字元序列轉換成以 UTF-32 編碼的位元組序列的編碼器。</summary>
  547. <returns>
  548. <see cref="T:System.Text.Encoder" />,可以將 Unicode 字元序列轉換成以 UTF-32 編碼的位元組序列。</returns>
  549. <filterpriority>1</filterpriority>
  550. </member>
  551. <member name="M:System.Text.UTF32Encoding.GetHashCode">
  552. <summary>傳回目前執行個體的雜湊碼。</summary>
  553. <returns>目前 <see cref="T:System.Text.UTF32Encoding" /> 物件的雜湊碼。</returns>
  554. <filterpriority>1</filterpriority>
  555. </member>
  556. <member name="M:System.Text.UTF32Encoding.GetMaxByteCount(System.Int32)">
  557. <summary>計算將指定數目的字元編碼所產生的最大位元組數目。</summary>
  558. <returns>編碼指定字元數所產生的最大位元組數。</returns>
  559. <param name="charCount">要編碼的字元數。</param>
  560. <exception cref="T:System.ArgumentOutOfRangeException">
  561. <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>
  562. <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>
  563. <filterpriority>1</filterpriority>
  564. </member>
  565. <member name="M:System.Text.UTF32Encoding.GetMaxCharCount(System.Int32)">
  566. <summary>計算將指定數目的位元組解碼所產生的最大字元數。</summary>
  567. <returns>解碼指定位元組數所產生的最大字元數。</returns>
  568. <param name="byteCount">要解碼的位元組數。</param>
  569. <exception cref="T:System.ArgumentOutOfRangeException">
  570. <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>
  571. <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>
  572. <filterpriority>1</filterpriority>
  573. </member>
  574. <member name="M:System.Text.UTF32Encoding.GetPreamble">
  575. <summary>如果這個執行個體的建構函式要求位元組順序標記,則會傳回以 UTF-32 格式編碼的 Unicode 位元組順序標記。</summary>
  576. <returns>如果這個執行個體的建構函式要求位元組順序標記,則為包含 Unicode 位元組順序標記的位元組陣列。否則,這個方法會傳回長度為零的位元組陣列。</returns>
  577. <filterpriority>1</filterpriority>
  578. </member>
  579. <member name="M:System.Text.UTF32Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
  580. <summary>將位元組陣列中的某一段位元組範圍解碼成字串。</summary>
  581. <returns>
  582. <see cref="T:System.String" />,包含將指定之位元組序列解碼的結果。</returns>
  583. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  584. <param name="index">要解碼的第一個位元組索引。</param>
  585. <param name="count">要解碼的位元組數。</param>
  586. <exception cref="T:System.ArgumentNullException">
  587. <paramref name="bytes" /> is null. </exception>
  588. <exception cref="T:System.ArgumentOutOfRangeException">
  589. <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>
  590. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes. </exception>
  591. <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>
  592. <filterpriority>1</filterpriority>
  593. </member>
  594. <member name="T:System.Text.UTF7Encoding">
  595. <summary>表示 Unicode 字元的 UTF-7 編碼方式。</summary>
  596. <filterpriority>1</filterpriority>
  597. </member>
  598. <member name="M:System.Text.UTF7Encoding.#ctor">
  599. <summary>初始化 <see cref="T:System.Text.UTF7Encoding" /> 類別的新執行個體。</summary>
  600. </member>
  601. <member name="M:System.Text.UTF7Encoding.#ctor(System.Boolean)">
  602. <summary>初始化 <see cref="T:System.Text.UTF7Encoding" /> 類別的新執行個體。參數可指定是否允許使用選擇性字元。</summary>
  603. <param name="allowOptionals">true 表示允許指定選擇性字元,否則為 false。</param>
  604. </member>
  605. <member name="M:System.Text.UTF7Encoding.Equals(System.Object)">
  606. <summary>取得值,這個值表示指定的物件是否等於目前的 <see cref="T:System.Text.UTF7Encoding" /> 物件。</summary>
  607. <returns>如果 <paramref name="value" /> 是 <see cref="T:System.Text.UTF7Encoding" /> 物件,並且等於目前的 <see cref="T:System.Text.UTF7Encoding" /> 物件,則為 true,否則為 false。</returns>
  608. <param name="value">要與目前 <see cref="T:System.Text.UTF7Encoding" /> 物件進行比較的物件。</param>
  609. <filterpriority>2</filterpriority>
  610. </member>
  611. <member name="M:System.Text.UTF7Encoding.GetByteCount(System.Char*,System.Int32)">
  612. <summary>計算將起始於指定的字元指標之一組字元編碼會產生多少位元組。</summary>
  613. <returns>編碼指定字元所產生的位元組數。</returns>
  614. <param name="chars">要編碼的第一個字元指標。</param>
  615. <param name="count">要編碼的字元數。</param>
  616. <exception cref="T:System.ArgumentNullException">
  617. <paramref name="chars" /> 為 null (在 Visual Basic .NET 中則為 Nothing )。</exception>
  618. <exception cref="T:System.ArgumentOutOfRangeException">
  619. <paramref name="count" /> 小於零。-或-結果位元組數大於可以當做整數傳回的最大數目。</exception>
  620. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  621. <filterpriority>1</filterpriority>
  622. </member>
  623. <member name="M:System.Text.UTF7Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
  624. <summary>計算將指定的字元陣列中的一組字元編碼會產生多少位元組。</summary>
  625. <returns>編碼指定字元所產生的位元組數。</returns>
  626. <param name="chars">包含要解碼之一組字元的字元陣列。</param>
  627. <param name="index">要編碼的第一個字元索引。</param>
  628. <param name="count">要編碼的字元數。</param>
  629. <exception cref="T:System.ArgumentNullException">
  630. <paramref name="chars" /> 為 null (Nothing)。</exception>
  631. <exception cref="T:System.ArgumentOutOfRangeException">
  632. <paramref name="index" /> 或 <paramref name="count" /> 小於零。-或-<paramref name="index" /> 和 <paramref name="count" /> 不代表 <paramref name="chars" /> 中有效的範圍。-或-結果位元組數大於可以當做整數傳回的最大數目。</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.GetByteCount(System.String)">
  637. <summary>在指定的 <see cref="T:System.String" /> 物件中計算字元進行編碼後所產生的位元組數目。</summary>
  638. <returns>編碼指定字元所產生的位元組數。</returns>
  639. <param name="s">
  640. <see cref="T:System.String" /> 物件,包含要編碼的一組字元。</param>
  641. <exception cref="T:System.ArgumentNullException">
  642. <paramref name="s" /> 為 null (Nothing)。</exception>
  643. <exception cref="T:System.ArgumentOutOfRangeException">結果位元組數大於可以當做整數傳回的最大數目。</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.UTF7Encoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
  648. <summary>將起始於指定字元指標的字元編碼成位元組序列;儲存該位元組序列時,係以指定的位元組指標為起始點。</summary>
  649. <returns>在 <paramref name="bytes" /> 所指示位置上寫入的實際位元組數。</returns>
  650. <param name="chars">要編碼的第一個字元指標。</param>
  651. <param name="charCount">要編碼的字元數。</param>
  652. <param name="bytes">開始寫入結果位元組序列的位置指標。</param>
  653. <param name="byteCount">寫入的最大位元組數。</param>
  654. <exception cref="T:System.ArgumentNullException">
  655. <paramref name="chars" /> 為 null (Nothing)。-或-<paramref name="bytes" /> 為 null (Nothing)。</exception>
  656. <exception cref="T:System.ArgumentOutOfRangeException">
  657. <paramref name="charCount" /> 或 <paramref name="byteCount" /> 小於零。</exception>
  658. <exception cref="T:System.ArgumentException">
  659. <paramref name="byteCount" /> 小於結果位元組數。</exception>
  660. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需更完整的說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  661. <filterpriority>1</filterpriority>
  662. </member>
  663. <member name="M:System.Text.UTF7Encoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
  664. <summary>將一組字元從指定的字元陣列編碼成指定的位元組陣列。</summary>
  665. <returns>寫入 <paramref name="bytes" /> 的實際位元組數。</returns>
  666. <param name="chars">包含要解碼之一組字元的字元陣列。</param>
  667. <param name="charIndex">要編碼的第一個字元索引。</param>
  668. <param name="charCount">要編碼的字元數。</param>
  669. <param name="bytes">要包含結果位元組序列的位元組陣列。</param>
  670. <param name="byteIndex">要開始寫入結果位元組序列的索引。</param>
  671. <exception cref="T:System.ArgumentNullException">
  672. <paramref name="chars" /> 為 null (Nothing)。-或-<paramref name="bytes" /> 為 null (Nothing)。</exception>
  673. <exception cref="T:System.ArgumentOutOfRangeException">
  674. <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>
  675. <exception cref="T:System.ArgumentException">從 <paramref name="byteIndex" /> 到陣列結尾處,<paramref name="bytes" /> 沒有足夠的容量容納結果位元組。</exception>
  676. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需更完整的說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  677. <filterpriority>1</filterpriority>
  678. </member>
  679. <member name="M:System.Text.UTF7Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
  680. <summary>將指定 <see cref="T:System.String" /> 中的一組字元編碼成指定的位元組陣列。</summary>
  681. <returns>寫入 <paramref name="bytes" /> 的實際位元組數。</returns>
  682. <param name="s">
  683. <see cref="T:System.String" /> 包含要編碼的一組字元。</param>
  684. <param name="charIndex">要編碼的第一個字元索引。</param>
  685. <param name="charCount">要編碼的字元數。</param>
  686. <param name="bytes">要包含結果位元組序列的位元組陣列。</param>
  687. <param name="byteIndex">要開始寫入結果位元組序列的索引。</param>
  688. <exception cref="T:System.ArgumentNullException">
  689. <paramref name="s" /> 為 null (Nothing)。-或-<paramref name="bytes" /> 為 null (Nothing)。</exception>
  690. <exception cref="T:System.ArgumentOutOfRangeException">
  691. <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>
  692. <exception cref="T:System.ArgumentException">從 <paramref name="byteIndex" /> 到陣列結尾處,<paramref name="bytes" /> 沒有足夠的容量容納結果位元組。</exception>
  693. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需更完整的說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  694. <filterpriority>1</filterpriority>
  695. </member>
  696. <member name="M:System.Text.UTF7Encoding.GetCharCount(System.Byte*,System.Int32)">
  697. <summary>計算將起始於指定位元組指標的位元組序列解碼會產生多少字元數。</summary>
  698. <returns>解碼指定位元組序列所產生的字元數。</returns>
  699. <param name="bytes">要解碼的第一個位元組指標。</param>
  700. <param name="count">要解碼的位元組數。</param>
  701. <exception cref="T:System.ArgumentNullException">
  702. <paramref name="bytes" /> 為 null (Nothing)。</exception>
  703. <exception cref="T:System.ArgumentOutOfRangeException">
  704. <paramref name="count" /> 小於零。-或-產生的字元數目大於可以當做整數傳回的最大數目。</exception>
  705. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需更完整的說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  706. <filterpriority>1</filterpriority>
  707. </member>
  708. <member name="M:System.Text.UTF7Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
  709. <summary>計算解碼指定位元組陣列中的位元組序列會產生多少字元數。</summary>
  710. <returns>解碼指定位元組序列所產生的字元數。</returns>
  711. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  712. <param name="index">要解碼的第一個位元組索引。</param>
  713. <param name="count">要解碼的位元組數。</param>
  714. <exception cref="T:System.ArgumentNullException">
  715. <paramref name="bytes" /> 為 null (Nothing)。</exception>
  716. <exception cref="T:System.ArgumentOutOfRangeException">
  717. <paramref name="index" /> 或 <paramref name="count" /> 小於零。-或-<paramref name="index" /> 和 <paramref name="count" /> 不代表 <paramref name="bytes" /> 中有效的範圍。-或-產生的字元數目大於可以當做整數傳回的最大數目。</exception>
  718. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  719. <filterpriority>1</filterpriority>
  720. </member>
  721. <member name="M:System.Text.UTF7Encoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
  722. <summary>將起始於指定位元組指標的位元組序列解碼成一組字元;儲存該組字元時,係以指定的字元指標為起始點。</summary>
  723. <returns>在 <paramref name="chars" /> 所指示位置上寫入的實際字元數。</returns>
  724. <param name="bytes">要解碼的第一個位元組指標。</param>
  725. <param name="byteCount">要解碼的位元組數。</param>
  726. <param name="chars">開始寫入產生的一組字元之位置指標。</param>
  727. <param name="charCount">要寫入的最大字元數。</param>
  728. <exception cref="T:System.ArgumentNullException">
  729. <paramref name="bytes" /> 為 null (Nothing)。-或-<paramref name="chars" /> 為 null (Nothing)。</exception>
  730. <exception cref="T:System.ArgumentOutOfRangeException">
  731. <paramref name="byteCount" /> 或 <paramref name="charCount" /> 小於零。</exception>
  732. <exception cref="T:System.ArgumentException">
  733. <paramref name="charCount" /> 小於結果字元數。</exception>
  734. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  735. <filterpriority>1</filterpriority>
  736. </member>
  737. <member name="M:System.Text.UTF7Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
  738. <summary>將指定位元組陣列中的位元組序列解碼成指定的字元陣列。</summary>
  739. <returns>實際寫入 <paramref name="chars" /> 的字元數。</returns>
  740. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  741. <param name="byteIndex">要解碼的第一個位元組索引。</param>
  742. <param name="byteCount">要解碼的位元組數。</param>
  743. <param name="chars">包含產生的一組字元之字元陣列。</param>
  744. <param name="charIndex">要開始寫入產生的一組字元之索引。</param>
  745. <exception cref="T:System.ArgumentNullException">
  746. <paramref name="bytes" /> 為 null (Nothing)。-或-<paramref name="chars" /> 為 null (Nothing)。</exception>
  747. <exception cref="T:System.ArgumentOutOfRangeException">
  748. <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>
  749. <exception cref="T:System.ArgumentException">從 <paramref name="charIndex" /> 到陣列結尾處,<paramref name="chars" /> 沒有足夠的容量容納結果字元。</exception>
  750. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  751. <filterpriority>1</filterpriority>
  752. </member>
  753. <member name="M:System.Text.UTF7Encoding.GetDecoder">
  754. <summary>取得可以將以 UTF-7 編碼的位元組序列轉換成 Unicode 字元序列的解碼器。</summary>
  755. <returns>
  756. <see cref="T:System.Text.Decoder" />,可以將以 UTF-7 編碼的位元組序列轉換成 Unicode 字元序列。</returns>
  757. <filterpriority>1</filterpriority>
  758. </member>
  759. <member name="M:System.Text.UTF7Encoding.GetEncoder">
  760. <summary>取得可以將 Unicode 字元序列轉換成以 UTF-7 編碼的位元組序列的編碼器。</summary>
  761. <returns>
  762. <see cref="T:System.Text.Encoder" />,可以將 Unicode 字元序列轉換成以 UTF-7 編碼的位元組序列。</returns>
  763. <filterpriority>1</filterpriority>
  764. </member>
  765. <member name="M:System.Text.UTF7Encoding.GetHashCode">
  766. <summary>傳回目前 <see cref="T:System.Text.UTF7Encoding" /> 物件的雜湊程式碼。</summary>
  767. <returns>32 位元帶正負號的整數雜湊碼。</returns>
  768. <filterpriority>1</filterpriority>
  769. </member>
  770. <member name="M:System.Text.UTF7Encoding.GetMaxByteCount(System.Int32)">
  771. <summary>計算編碼指定的字元數會產生的最大位元組數。</summary>
  772. <returns>編碼指定字元數所產生的最大位元組數。</returns>
  773. <param name="charCount">要編碼的字元數。</param>
  774. <exception cref="T:System.ArgumentOutOfRangeException">
  775. <paramref name="charCount" /> 小於零。-或-結果位元組數大於可以當做整數傳回的最大數目。</exception>
  776. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  777. <filterpriority>1</filterpriority>
  778. </member>
  779. <member name="M:System.Text.UTF7Encoding.GetMaxCharCount(System.Int32)">
  780. <summary>計算解碼指定的位元組數會產生的最大字元數。</summary>
  781. <returns>解碼指定位元組數所產生的最大字元數。</returns>
  782. <param name="byteCount">要解碼的位元組數。</param>
  783. <exception cref="T:System.ArgumentOutOfRangeException">
  784. <paramref name="byteCount" /> 小於零。-或-產生的字元數目大於可以當做整數傳回的最大數目。</exception>
  785. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  786. <filterpriority>1</filterpriority>
  787. </member>
  788. <member name="M:System.Text.UTF7Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
  789. <summary>將位元組陣列中的某一段位元組範圍解碼成字串。</summary>
  790. <returns>
  791. <see cref="T:System.String" />,包含將指定之位元組序列解碼的結果。</returns>
  792. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  793. <param name="index">要解碼的第一個位元組索引。</param>
  794. <param name="count">要解碼的位元組數。</param>
  795. <exception cref="T:System.ArgumentNullException">
  796. <paramref name="bytes" /> 為 null (Nothing)。</exception>
  797. <exception cref="T:System.ArgumentOutOfRangeException">
  798. <paramref name="index" /> 或 <paramref name="count" /> 小於零。-或-<paramref name="index" /> 和 <paramref name="count" /> 不代表 <paramref name="bytes" /> 中有效的範圍。</exception>
  799. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需更完整的說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  800. <filterpriority>1</filterpriority>
  801. </member>
  802. <member name="T:System.Text.UTF8Encoding">
  803. <summary>代表 Unicode 字元的 UTF-8 編碼方式。</summary>
  804. <filterpriority>1</filterpriority>
  805. </member>
  806. <member name="M:System.Text.UTF8Encoding.#ctor">
  807. <summary>初始化 <see cref="T:System.Text.UTF8Encoding" /> 類別的新執行個體。</summary>
  808. </member>
  809. <member name="M:System.Text.UTF8Encoding.#ctor(System.Boolean)">
  810. <summary>初始化 <see cref="T:System.Text.UTF8Encoding" /> 類別的新執行個體。參數會指定是否提供 Unicode 位元組順序標記。</summary>
  811. <param name="encoderShouldEmitUTF8Identifier">true 指定 <see cref="M:System.Text.UTF8Encoding.GetPreamble" /> 方法會傳回 Unicode 位元組順序標記;否則為 false。如需詳細資訊,請參閱<備註>一節。</param>
  812. </member>
  813. <member name="M:System.Text.UTF8Encoding.#ctor(System.Boolean,System.Boolean)">
  814. <summary>初始化 <see cref="T:System.Text.UTF8Encoding" /> 類別的新執行個體。參數會指定是否提供 Unicode 位元組順序標記,以及是否在偵測到無效的編碼方式時擲回例外狀況。</summary>
  815. <param name="encoderShouldEmitUTF8Identifier">true 指定 <see cref="M:System.Text.UTF8Encoding.GetPreamble" /> 方法應傳回 Unicode 位元組順序標記;否則為 false。如需詳細資訊,請參閱<備註>一節。</param>
  816. <param name="throwOnInvalidBytes">true 表示在偵測到無效的編碼方式時擲回例外狀況;否則為 false。</param>
  817. </member>
  818. <member name="M:System.Text.UTF8Encoding.Equals(System.Object)">
  819. <summary>判斷指定的物件是否等於目前的 <see cref="T:System.Text.UTF8Encoding" /> 物件。</summary>
  820. <returns>如果 <paramref name="value" /> 是 <see cref="T:System.Text.UTF8Encoding" /> 的執行個體,並且等於目前的物件,則為 true;否則為 false。</returns>
  821. <param name="value">要與目前執行個體比較的物件。</param>
  822. <filterpriority>2</filterpriority>
  823. </member>
  824. <member name="M:System.Text.UTF8Encoding.GetByteCount(System.Char*,System.Int32)">
  825. <summary>計算將起始於指定字元指標的一組字元編碼所產生的位元組數目。</summary>
  826. <returns>編碼指定字元所產生的位元組數。</returns>
  827. <param name="chars">要編碼的第一個字元指標。</param>
  828. <param name="count">要編碼的字元數。</param>
  829. <exception cref="T:System.ArgumentNullException">
  830. <paramref name="chars" /> is null. </exception>
  831. <exception cref="T:System.ArgumentOutOfRangeException">
  832. <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>
  833. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters. </exception>
  834. <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>
  835. <filterpriority>1</filterpriority>
  836. </member>
  837. <member name="M:System.Text.UTF8Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
  838. <summary>計算將指定字元陣列中的一組字元編碼所產生的位元組數目。</summary>
  839. <returns>編碼指定字元所產生的位元組數。</returns>
  840. <param name="chars">包含要解碼之一組字元的字元陣列。</param>
  841. <param name="index">要編碼的第一個字元索引。</param>
  842. <param name="count">要編碼的字元數。</param>
  843. <exception cref="T:System.ArgumentNullException">
  844. <paramref name="chars" /> is null. </exception>
  845. <exception cref="T:System.ArgumentOutOfRangeException">
  846. <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>
  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-The <see cref="P:System.Text.Encoding.EncoderFallback" /> property is set to <see cref="T:System.Text.EncoderExceptionFallback" />. </exception>
  849. <filterpriority>1</filterpriority>
  850. </member>
  851. <member name="M:System.Text.UTF8Encoding.GetByteCount(System.String)">
  852. <summary>計算將指定 <see cref="T:System.String" /> 中的字元編碼所產生的位元組數目。</summary>
  853. <returns>編碼指定字元所產生的位元組數。</returns>
  854. <param name="chars">
  855. <see cref="T:System.String" />,包含要編碼的一組字元。</param>
  856. <exception cref="T:System.ArgumentNullException">
  857. <paramref name="chars" /> is null. </exception>
  858. <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an integer. </exception>
  859. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters. </exception>
  860. <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>
  861. <filterpriority>1</filterpriority>
  862. </member>
  863. <member name="M:System.Text.UTF8Encoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
  864. <summary>將起始於指定字元指標的一組字元編碼成位元組序列;儲存該位元組序列時,係以指定的位元組指標為起始點。</summary>
  865. <returns>在 <paramref name="bytes" /> 所表示的位置上寫入的實際位元組數目。</returns>
  866. <param name="chars">要編碼的第一個字元指標。</param>
  867. <param name="charCount">要編碼的字元數。</param>
  868. <param name="bytes">開始寫入結果位元組序列的位置指標。</param>
  869. <param name="byteCount">寫入的最大位元組數。</param>
  870. <exception cref="T:System.ArgumentNullException">
  871. <paramref name="chars" /> is null.-or- <paramref name="bytes" /> is null. </exception>
  872. <exception cref="T:System.ArgumentOutOfRangeException">
  873. <paramref name="charCount" /> or <paramref name="byteCount" /> is less than zero. </exception>
  874. <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>
  875. <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>
  876. <filterpriority>1</filterpriority>
  877. </member>
  878. <member name="M:System.Text.UTF8Encoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
  879. <summary>將指定字元陣列中的一組字元編碼成指定的位元組陣列。</summary>
  880. <returns>寫入 <paramref name="bytes" /> 的實際位元組數。</returns>
  881. <param name="chars">包含要解碼之一組字元的字元陣列。</param>
  882. <param name="charIndex">要編碼的第一個字元索引。</param>
  883. <param name="charCount">要編碼的字元數。</param>
  884. <param name="bytes">要包含結果位元組序列的位元組陣列。</param>
  885. <param name="byteIndex">要開始寫入結果位元組序列的索引。</param>
  886. <exception cref="T:System.ArgumentNullException">
  887. <paramref name="chars" /> is null.-or- <paramref name="bytes" /> is null. </exception>
  888. <exception cref="T:System.ArgumentOutOfRangeException">
  889. <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>
  890. <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>
  891. <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>
  892. <filterpriority>1</filterpriority>
  893. </member>
  894. <member name="M:System.Text.UTF8Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
  895. <summary>將指定 <see cref="T:System.String" /> 中的一組字元編碼成指定的位元組陣列。</summary>
  896. <returns>寫入 <paramref name="bytes" /> 的實際位元組數。</returns>
  897. <param name="s">
  898. <see cref="T:System.String" />,包含要編碼的一組字元。</param>
  899. <param name="charIndex">要編碼的第一個字元索引。</param>
  900. <param name="charCount">要編碼的字元數。</param>
  901. <param name="bytes">要包含結果位元組序列的位元組陣列。</param>
  902. <param name="byteIndex">要開始寫入結果位元組序列的索引。</param>
  903. <exception cref="T:System.ArgumentNullException">
  904. <paramref name="s" /> is null.-or- <paramref name="bytes" /> is null. </exception>
  905. <exception cref="T:System.ArgumentOutOfRangeException">
  906. <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>
  907. <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>
  908. <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>
  909. <filterpriority>1</filterpriority>
  910. </member>
  911. <member name="M:System.Text.UTF8Encoding.GetCharCount(System.Byte*,System.Int32)">
  912. <summary>計算將起始於指定位元組指標的位元組序列解碼所產生的字元數。</summary>
  913. <returns>解碼指定位元組序列所產生的字元數。</returns>
  914. <param name="bytes">要解碼的第一個位元組指標。</param>
  915. <param name="count">要解碼的位元組數。</param>
  916. <exception cref="T:System.ArgumentNullException">
  917. <paramref name="bytes" /> is null. </exception>
  918. <exception cref="T:System.ArgumentOutOfRangeException">
  919. <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>
  920. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes. </exception>
  921. <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>
  922. <filterpriority>1</filterpriority>
  923. </member>
  924. <member name="M:System.Text.UTF8Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
  925. <summary>計算將指定位元組陣列中的位元組序列解碼所產生的字元數。</summary>
  926. <returns>解碼指定位元組序列所產生的字元數。</returns>
  927. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  928. <param name="index">要解碼的第一個位元組索引。</param>
  929. <param name="count">要解碼的位元組數。</param>
  930. <exception cref="T:System.ArgumentNullException">
  931. <paramref name="bytes" /> is null. </exception>
  932. <exception cref="T:System.ArgumentOutOfRangeException">
  933. <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>
  934. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes. </exception>
  935. <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>
  936. <filterpriority>1</filterpriority>
  937. </member>
  938. <member name="M:System.Text.UTF8Encoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
  939. <summary>將起始於指定位元組指標的位元組序列解碼成一組字元;儲存該組字元時,係以指定的字元指標為起始點。</summary>
  940. <returns>在 <paramref name="chars" /> 所表示的位置上寫入的實際字元數。</returns>
  941. <param name="bytes">要解碼的第一個位元組指標。</param>
  942. <param name="byteCount">要解碼的位元組數。</param>
  943. <param name="chars">開始寫入產生的一組字元之位置指標。</param>
  944. <param name="charCount">要寫入的最大字元數。</param>
  945. <exception cref="T:System.ArgumentNullException">
  946. <paramref name="bytes" /> is null.-or- <paramref name="chars" /> is null. </exception>
  947. <exception cref="T:System.ArgumentOutOfRangeException">
  948. <paramref name="byteCount" /> or <paramref name="charCount" /> is less than zero. </exception>
  949. <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>
  950. <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>
  951. <filterpriority>1</filterpriority>
  952. </member>
  953. <member name="M:System.Text.UTF8Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
  954. <summary>將指定位元組陣列中的位元組序列解碼成指定的字元陣列。</summary>
  955. <returns>寫入 <paramref name="chars" /> 的實際字元數。</returns>
  956. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  957. <param name="byteIndex">要解碼的第一個位元組索引。</param>
  958. <param name="byteCount">要解碼的位元組數。</param>
  959. <param name="chars">包含產生的一組字元之字元陣列。</param>
  960. <param name="charIndex">要開始寫入產生的一組字元之索引。</param>
  961. <exception cref="T:System.ArgumentNullException">
  962. <paramref name="bytes" /> is null.-or- <paramref name="chars" /> is null. </exception>
  963. <exception cref="T:System.ArgumentOutOfRangeException">
  964. <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>
  965. <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>
  966. <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>
  967. <filterpriority>1</filterpriority>
  968. </member>
  969. <member name="M:System.Text.UTF8Encoding.GetDecoder">
  970. <summary>取得可以將以 UTF-8 編碼的位元組序列轉換成 Unicode 字元序列的解碼器。</summary>
  971. <returns>可以將以 UTF-8 編碼的位元組序列轉換成 Unicode 字元序列的解碼器。</returns>
  972. <filterpriority>1</filterpriority>
  973. </member>
  974. <member name="M:System.Text.UTF8Encoding.GetEncoder">
  975. <summary>取得可以將 Unicode 字元序列轉換成以 UTF-8 編碼的位元組序列的編碼器。</summary>
  976. <returns>
  977. <see cref="T:System.Text.Encoder" />,可以將 Unicode 字元序列轉換成以 UTF-8 編碼的位元組序列。</returns>
  978. <filterpriority>1</filterpriority>
  979. </member>
  980. <member name="M:System.Text.UTF8Encoding.GetHashCode">
  981. <summary>傳回目前執行個體的雜湊碼。</summary>
  982. <returns>目前執行個體的雜湊碼。</returns>
  983. <filterpriority>1</filterpriority>
  984. </member>
  985. <member name="M:System.Text.UTF8Encoding.GetMaxByteCount(System.Int32)">
  986. <summary>計算將指定數目的字元編碼所產生的最大位元組數目。</summary>
  987. <returns>編碼指定字元數所產生的最大位元組數。</returns>
  988. <param name="charCount">要編碼的字元數。</param>
  989. <exception cref="T:System.ArgumentOutOfRangeException">
  990. <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>
  991. <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>
  992. <filterpriority>1</filterpriority>
  993. </member>
  994. <member name="M:System.Text.UTF8Encoding.GetMaxCharCount(System.Int32)">
  995. <summary>計算將指定數目的位元組解碼所產生的最大字元數。</summary>
  996. <returns>解碼指定位元組數所產生的最大字元數。</returns>
  997. <param name="byteCount">要解碼的位元組數。</param>
  998. <exception cref="T:System.ArgumentOutOfRangeException">
  999. <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>
  1000. <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>
  1001. <filterpriority>1</filterpriority>
  1002. </member>
  1003. <member name="M:System.Text.UTF8Encoding.GetPreamble">
  1004. <summary>如果設定 <see cref="T:System.Text.UTF8Encoding" /> 編碼物件提供編碼方式,則會傳回以 UTF-8 格式編碼的 Unicode 位元組順序標記。</summary>
  1005. <returns>如果設定 <see cref="T:System.Text.UTF8Encoding" /> 編碼物件提供編碼方式,則為包含 Unicode 位元組順序標記的位元組陣列。否則,這個方法會傳回長度為零的位元組陣列。</returns>
  1006. <filterpriority>1</filterpriority>
  1007. </member>
  1008. <member name="M:System.Text.UTF8Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
  1009. <summary>將位元組陣列中的某一段位元組範圍解碼成字串。</summary>
  1010. <returns>
  1011. <see cref="T:System.String" />,包含將指定之位元組序列解碼的結果。</returns>
  1012. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  1013. <param name="index">要解碼的第一個位元組索引。</param>
  1014. <param name="count">要解碼的位元組數。</param>
  1015. <exception cref="T:System.ArgumentNullException">
  1016. <paramref name="bytes" /> is null. </exception>
  1017. <exception cref="T:System.ArgumentOutOfRangeException">
  1018. <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>
  1019. <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes. </exception>
  1020. <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>
  1021. <filterpriority>1</filterpriority>
  1022. </member>
  1023. </members>
  1024. </doc>