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.
 
 
 
 
 
 

1026 lines
88 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>
  37. <see cref="T:System.Text.DecoderFallback" /> 物件。</returns>
  38. <exception cref="T:System.ArgumentNullException">設定作業中的值是 null (Nothing)。</exception>
  39. <exception cref="T:System.ArgumentException">設定作業中無法指派新的值,因為目前的 <see cref="T:System.Text.DecoderFallbackBuffer" /> 物件包含尚未解碼的資料。</exception>
  40. <filterpriority>1</filterpriority>
  41. </member>
  42. <member name="P:System.Text.Decoder.FallbackBuffer">
  43. <summary>取得與目前 <see cref="T:System.Text.Decoder" /> 物件關聯的 <see cref="T:System.Text.DecoderFallbackBuffer" /> 物件。</summary>
  44. <returns>
  45. <see cref="T:System.Text.DecoderFallbackBuffer" /> 物件。</returns>
  46. <filterpriority>1</filterpriority>
  47. </member>
  48. <member name="M:System.Text.Decoder.GetCharCount(System.Byte[],System.Int32,System.Int32)">
  49. <summary>在衍生類別中覆寫時,計算從指定的位元組陣列解碼位元組序列所產生的字元數目。</summary>
  50. <returns>解碼指定位元組序列及內部緩衝區內任何位元組所產生的字元數目。</returns>
  51. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  52. <param name="index">要解碼的第一個位元組索引。</param>
  53. <param name="count">要解碼的位元組數。</param>
  54. <exception cref="T:System.ArgumentNullException">
  55. <paramref name="bytes" /> 為 null (Nothing)。</exception>
  56. <exception cref="T:System.ArgumentOutOfRangeException">
  57. <paramref name="index" /> 或 <paramref name="count" /> 小於零。-或-<paramref name="index" /> 和 <paramref name="count" /> 不代表 <paramref name="bytes" /> 中有效的範圍。</exception>
  58. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需更完整的說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Decoder.Fallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  59. <filterpriority>2</filterpriority>
  60. </member>
  61. <member name="M:System.Text.Decoder.GetCharCount(System.Byte[],System.Int32,System.Int32,System.Boolean)">
  62. <summary>在衍生類別中覆寫時,計算從指定的位元組陣列解碼位元組序列所產生的字元數目。參數會指示,在計算之後是否要清除解碼器的內部狀態。</summary>
  63. <returns>解碼指定位元組序列及內部緩衝區內任何位元組所產生的字元數目。</returns>
  64. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  65. <param name="index">要解碼的第一個位元組索引。</param>
  66. <param name="count">要解碼的位元組數。</param>
  67. <param name="flush">true 表示要在計算之後模擬編碼器內部狀態的清除動作,否則為 false。</param>
  68. <exception cref="T:System.ArgumentNullException">
  69. <paramref name="bytes" /> 為 null (Nothing)。</exception>
  70. <exception cref="T:System.ArgumentOutOfRangeException">
  71. <paramref name="index" /> 或 <paramref name="count" /> 小於零。-或-<paramref name="index" /> 和 <paramref name="count" /> 不代表 <paramref name="bytes" /> 中有效的範圍。</exception>
  72. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需更完整的說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Decoder.Fallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  73. <filterpriority>2</filterpriority>
  74. </member>
  75. <member name="M:System.Text.Decoder.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
  76. <summary>在衍生類別中覆寫時,將指定位元組陣列中的位元組序列以及內部緩衝區內的任何位元組,解碼成指定的字元陣列。</summary>
  77. <returns>實際寫入 <paramref name="chars" /> 的字元數。</returns>
  78. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  79. <param name="byteIndex">要解碼的第一個位元組索引。</param>
  80. <param name="byteCount">要解碼的位元組數。</param>
  81. <param name="chars">包含產生的一組字元之字元陣列。</param>
  82. <param name="charIndex">要開始寫入產生的一組字元之索引。</param>
  83. <exception cref="T:System.ArgumentNullException">
  84. <paramref name="bytes" /> 為 null (Nothing)。-或-<paramref name="chars" /> 為 null (Nothing)。</exception>
  85. <exception cref="T:System.ArgumentOutOfRangeException">
  86. <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>
  87. <exception cref="T:System.ArgumentException">從 <paramref name="charIndex" /> 到陣列結尾處,<paramref name="chars" /> 沒有足夠的容量容納結果字元。</exception>
  88. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需更完整的說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Decoder.Fallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  89. <filterpriority>2</filterpriority>
  90. </member>
  91. <member name="M:System.Text.Decoder.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32,System.Boolean)">
  92. <summary>在衍生類別中覆寫時,將指定位元組陣列中的位元組序列以及內部緩衝區內的任何位元組,解碼成指定的字元陣列。參數會指示,在轉換之後是否要清除解碼器的內部狀態。</summary>
  93. <returns>實際寫入 <paramref name="chars" /> 參數的字元數。</returns>
  94. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  95. <param name="byteIndex">要解碼的第一個位元組索引。</param>
  96. <param name="byteCount">要解碼的位元組數。</param>
  97. <param name="chars">包含產生的一組字元之字元陣列。</param>
  98. <param name="charIndex">要開始寫入產生的一組字元之索引。</param>
  99. <param name="flush">true 表示要在轉換之後清除解碼器的內部狀態,否則為 false。</param>
  100. <exception cref="T:System.ArgumentNullException">
  101. <paramref name="bytes" /> 為 null (Nothing)。-或-<paramref name="chars" /> 為 null (Nothing)。</exception>
  102. <exception cref="T:System.ArgumentOutOfRangeException">
  103. <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>
  104. <exception cref="T:System.ArgumentException">從 <paramref name="charIndex" /> 到陣列結尾處,<paramref name="chars" /> 沒有足夠的容量容納結果字元。</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" /> 類別的型別。預設值為 <see cref="T:System.Text.DecoderReplacementFallback" /> 物件,此物件會發出「問號」字元 ("?",U+003F),以取代未知的位元組序列。</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">
  217. <paramref name="bytesUnknown" /> 中無法解碼的位元組的索引位置。</param>
  218. </member>
  219. <member name="M:System.Text.DecoderFallbackException.#ctor(System.String,System.Exception)">
  220. <summary>初始化 <see cref="T:System.Text.DecoderFallbackException" /> 類別的新執行個體。參數會指定錯誤訊息,以及造成此例外狀況的內部例外狀況。</summary>
  221. <param name="message">錯誤訊息。</param>
  222. <param name="innerException">造成此例外狀況的例外狀況。</param>
  223. </member>
  224. <member name="P:System.Text.DecoderFallbackException.BytesUnknown">
  225. <summary>取得造成例外狀況的輸入位元組序列。</summary>
  226. <returns>無法解碼的輸入位元組陣列。</returns>
  227. <filterpriority>2</filterpriority>
  228. </member>
  229. <member name="P:System.Text.DecoderFallbackException.Index">
  230. <summary>取得位元組的輸入位元組序列中造成例外狀況的索引位置。</summary>
  231. <returns>位元組的輸入位元組陣列中無法解碼的索引位置。索引位置以零起始。</returns>
  232. <filterpriority>1</filterpriority>
  233. </member>
  234. <member name="T:System.Text.DecoderReplacementFallback">
  235. <summary>針對無法轉換為輸出字元的編碼輸入位元組序列,提供失敗處理機制 (稱為後援)。此後援會發出使用者指定的取代字串,而非已解碼的輸入位元組序列。此類別無法被繼承。</summary>
  236. <filterpriority>2</filterpriority>
  237. </member>
  238. <member name="M:System.Text.DecoderReplacementFallback.#ctor">
  239. <summary>初始化 <see cref="T:System.Text.DecoderReplacementFallback" /> 類別的新執行個體。</summary>
  240. </member>
  241. <member name="M:System.Text.DecoderReplacementFallback.#ctor(System.String)">
  242. <summary>使用指定的取代字串,初始化 <see cref="T:System.Text.DecoderReplacementFallback" /> 類別的新執行個體。</summary>
  243. <param name="replacement">在解碼作業中所發出的字串,此字串是用來取代無法解碼的輸入位元組序列。</param>
  244. <exception cref="T:System.ArgumentNullException">
  245. <paramref name="replacement" /> 為 null。</exception>
  246. <exception cref="T:System.ArgumentException">
  247. <paramref name="replacement" /> 包含無效的 Surrogate 字組。換句話說,Surrogate 字組不是由一個高 Surrogate 元件 (後面再接著一個低 Surrogate 元件) 所組成。</exception>
  248. </member>
  249. <member name="M:System.Text.DecoderReplacementFallback.CreateFallbackBuffer">
  250. <summary>建立 <see cref="T:System.Text.DecoderFallbackBuffer" /> 物件,其使用此 <see cref="T:System.Text.DecoderReplacementFallback" /> 物件的取代字串初始化。</summary>
  251. <returns>
  252. <see cref="T:System.Text.DecoderFallbackBuffer" /> 物件,可指定要使用的字串,而非原始的解碼作業輸入。</returns>
  253. <filterpriority>2</filterpriority>
  254. </member>
  255. <member name="P:System.Text.DecoderReplacementFallback.DefaultString">
  256. <summary>取得取代字串,此字串為 <see cref="T:System.Text.DecoderReplacementFallback" /> 物件的值。</summary>
  257. <returns>所發出的替代字串,用來取代無法解碼的輸入位元組序列。</returns>
  258. <filterpriority>2</filterpriority>
  259. </member>
  260. <member name="M:System.Text.DecoderReplacementFallback.Equals(System.Object)">
  261. <summary>指示指定物件的值是否等於 <see cref="T:System.Text.DecoderReplacementFallback" /> 物件。</summary>
  262. <returns>如果 <paramref name="value" /> 為 <see cref="T:System.Text.DecoderReplacementFallback" /> 物件,而此物件的 <see cref="P:System.Text.DecoderReplacementFallback.DefaultString" /> 屬性等於目前 <see cref="T:System.Text.DecoderReplacementFallback" /> 物件的 <see cref="P:System.Text.DecoderReplacementFallback.DefaultString" /> 屬性,則為 true,否則為 false。</returns>
  263. <param name="value">
  264. <see cref="T:System.Text.DecoderReplacementFallback" /> 物件。</param>
  265. <filterpriority>2</filterpriority>
  266. </member>
  267. <member name="M:System.Text.DecoderReplacementFallback.GetHashCode">
  268. <summary>擷取 <see cref="T:System.Text.DecoderReplacementFallback" /> 物件值的雜湊程式碼。</summary>
  269. <returns>物件值的雜湊程式碼。</returns>
  270. <filterpriority>2</filterpriority>
  271. </member>
  272. <member name="P:System.Text.DecoderReplacementFallback.MaxCharCount">
  273. <summary>取得 <see cref="T:System.Text.DecoderReplacementFallback" /> 物件之取代字串中的字元數。</summary>
  274. <returns>字串中所發出的字元數,用來取代無法解碼的位元組序列。也就是由 <see cref="P:System.Text.DecoderReplacementFallback.DefaultString" /> 屬性所傳回的字串長度。</returns>
  275. <filterpriority>2</filterpriority>
  276. </member>
  277. <member name="T:System.Text.Encoder">
  278. <summary>將一組字元轉換成位元組序列。</summary>
  279. <filterpriority>1</filterpriority>
  280. </member>
  281. <member name="M:System.Text.Encoder.#ctor">
  282. <summary>初始化 <see cref="T:System.Text.Encoder" /> 類別的新執行個體。</summary>
  283. </member>
  284. <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@)">
  285. <summary>將 Unicode 字元陣列轉換成編碼的位元組序列,然後將結果存放在位元組陣列中。</summary>
  286. <param name="chars">要進行轉換的字元陣列。</param>
  287. <param name="charIndex">要轉換的第一個 <paramref name="chars" /> 項目。</param>
  288. <param name="charCount">要轉換的 <paramref name="chars" /> 元素數目。</param>
  289. <param name="bytes">存放已轉換位元組的陣列。</param>
  290. <param name="byteIndex">存放資料的第一個 <paramref name="bytes" /> 項目。</param>
  291. <param name="byteCount">用於轉換的 <paramref name="bytes" /> 項目的最大數目。</param>
  292. <param name="flush">true 指示沒有進一步的資料要進行轉換,否則為 false。</param>
  293. <param name="charsUsed">當這個方法傳回時,會包含 <paramref name="chars" /> 中用於轉換的字元數目。這個參數會以未初始化的狀態傳遞。</param>
  294. <param name="bytesUsed">當這個方法傳回時,會包含轉換作業所產生的位元組數目。這個參數會以未初始化的狀態傳遞。</param>
  295. <param name="completed">當這個方法傳回時,如果由 <paramref name="charCount" /> 所指定的所有字元都已轉換,則會包含 true,否則會包含 false。這個參數會以未初始化的狀態傳遞。</param>
  296. <exception cref="T:System.ArgumentNullException">
  297. <paramref name="chars" /> 或 <paramref name="bytes" /> 為 null (Nothing)。</exception>
  298. <exception cref="T:System.ArgumentOutOfRangeException">
  299. <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>
  300. <exception cref="T:System.ArgumentException">輸出緩衝區太小,無法容納任何已轉換的輸入。輸出緩衝區應該大於或等於 <see cref="Overload:System.Text.Encoder.GetByteCount" /> 方法所指示的大小。</exception>
  301. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需更完整的說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoder.Fallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  302. <filterpriority>2</filterpriority>
  303. </member>
  304. <member name="P:System.Text.Encoder.Fallback">
  305. <summary>取得或設定目前 <see cref="T:System.Text.Encoder" /> 物件的 <see cref="T:System.Text.EncoderFallback" /> 物件。</summary>
  306. <returns>
  307. <see cref="T:System.Text.EncoderFallback" /> 物件。</returns>
  308. <exception cref="T:System.ArgumentNullException">設定作業中的值是 null (Nothing)。</exception>
  309. <exception cref="T:System.ArgumentException">設定作業中無法指派新的值,因為目前的 <see cref="T:System.Text.EncoderFallbackBuffer" /> 物件包含尚未編碼的資料。</exception>
  310. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需更完整的說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoder.Fallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  311. <filterpriority>1</filterpriority>
  312. </member>
  313. <member name="P:System.Text.Encoder.FallbackBuffer">
  314. <summary>取得與目前 <see cref="T:System.Text.Encoder" /> 物件關聯的 <see cref="T:System.Text.EncoderFallbackBuffer" /> 物件。</summary>
  315. <returns>
  316. <see cref="T:System.Text.EncoderFallbackBuffer" /> 物件。</returns>
  317. <filterpriority>1</filterpriority>
  318. </member>
  319. <member name="M:System.Text.Encoder.GetByteCount(System.Char[],System.Int32,System.Int32,System.Boolean)">
  320. <summary>在衍生類別中覆寫時,計算從指定的字元陣列編碼一組字元所產生的位元組數目。參數會指示,在計算之後是否要清除編碼器的內部狀態。</summary>
  321. <returns>編碼指定的字元及內部緩衝區內任何字元所產生的位元組數目。</returns>
  322. <param name="chars">包含要解碼之一組字元的字元陣列。</param>
  323. <param name="index">要編碼的第一個字元索引。</param>
  324. <param name="count">要編碼的字元數。</param>
  325. <param name="flush">true 表示要在計算之後模擬編碼器內部狀態的清除動作,否則為 false。</param>
  326. <exception cref="T:System.ArgumentNullException">
  327. <paramref name="chars" /> 為 null。</exception>
  328. <exception cref="T:System.ArgumentOutOfRangeException">
  329. <paramref name="index" /> 或 <paramref name="count" /> 小於零。-或-<paramref name="index" /> 和 <paramref name="count" /> 不代表 <paramref name="chars" /> 中有效的範圍。</exception>
  330. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需更完整的說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoder.Fallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  331. <filterpriority>2</filterpriority>
  332. </member>
  333. <member name="M:System.Text.Encoder.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32,System.Boolean)">
  334. <summary>在衍生類別中覆寫時,將指定字元陣列中的一組字元以及內部緩衝區內的任何字元,編碼成指定的位元組陣列。參數會指示,在轉換之後是否要清除編碼器的內部狀態。</summary>
  335. <returns>寫入 <paramref name="bytes" /> 的實際位元組數。</returns>
  336. <param name="chars">包含要解碼之一組字元的字元陣列。</param>
  337. <param name="charIndex">要編碼的第一個字元索引。</param>
  338. <param name="charCount">要編碼的字元數。</param>
  339. <param name="bytes">要包含結果位元組序列的位元組陣列。</param>
  340. <param name="byteIndex">要開始寫入結果位元組序列的索引。</param>
  341. <param name="flush">true 表示要在轉換之後清除編碼器的內部狀態,否則為 false。</param>
  342. <exception cref="T:System.ArgumentNullException">
  343. <paramref name="chars" /> 為 null (Nothing)。-或-<paramref name="bytes" /> 為 null (Nothing)。</exception>
  344. <exception cref="T:System.ArgumentOutOfRangeException">
  345. <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>
  346. <exception cref="T:System.ArgumentException">從 <paramref name="byteIndex" /> 到陣列結尾處,<paramref name="bytes" /> 沒有足夠的容量容納結果位元組。</exception>
  347. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需更完整的說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoder.Fallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  348. <filterpriority>2</filterpriority>
  349. </member>
  350. <member name="M:System.Text.Encoder.Reset">
  351. <summary>在衍生類別中覆寫時,將編碼器設定回其初始狀態。</summary>
  352. <filterpriority>2</filterpriority>
  353. </member>
  354. <member name="T:System.Text.EncoderExceptionFallback">
  355. <summary>針對無法轉換為輸出位元組序列的輸入字元,提供失敗處理機制 (稱為後援)。如果輸入字元無法轉換成輸出位元組序列,後援會擲回例外狀況 。此類別無法被繼承。</summary>
  356. <filterpriority>2</filterpriority>
  357. </member>
  358. <member name="M:System.Text.EncoderExceptionFallback.#ctor">
  359. <summary>初始化 <see cref="T:System.Text.EncoderExceptionFallback" /> 類別的新執行個體。</summary>
  360. </member>
  361. <member name="M:System.Text.EncoderExceptionFallback.CreateFallbackBuffer">
  362. <summary>傳回編碼器後援緩衝區,它會在無法將字元序列轉換成位元組序列時擲回例外狀況。</summary>
  363. <returns>在無法將字元序列編碼時擲回例外狀況的編碼器後援緩衝區。</returns>
  364. <filterpriority>2</filterpriority>
  365. </member>
  366. <member name="M:System.Text.EncoderExceptionFallback.Equals(System.Object)">
  367. <summary>指示目前的 <see cref="T:System.Text.EncoderExceptionFallback" /> 物件和指定的物件是否相等。</summary>
  368. <returns>如果 <paramref name="value" /> 不是 null (Visual Basic .NET 中的 Nothing),且為 <see cref="T:System.Text.EncoderExceptionFallback" /> 物件,則為 true,否則為 false。</returns>
  369. <param name="value">衍生自 <see cref="T:System.Text.EncoderExceptionFallback" /> 類別的物件。</param>
  370. <filterpriority>2</filterpriority>
  371. </member>
  372. <member name="M:System.Text.EncoderExceptionFallback.GetHashCode">
  373. <summary>擷取這個執行個體的雜湊碼。</summary>
  374. <returns>傳回值永遠都是相同的任意值,且沒有特殊的意義。</returns>
  375. <filterpriority>2</filterpriority>
  376. </member>
  377. <member name="P:System.Text.EncoderExceptionFallback.MaxCharCount">
  378. <summary>取得這個執行個體可以傳回的最大字元數。</summary>
  379. <returns>傳回值永遠是零。</returns>
  380. <filterpriority>2</filterpriority>
  381. </member>
  382. <member name="T:System.Text.EncoderFallback">
  383. <summary>針對無法轉換為編碼輸出位元組序列的輸入字元,提供失敗處理機制 (稱為後援)。</summary>
  384. <filterpriority>2</filterpriority>
  385. </member>
  386. <member name="M:System.Text.EncoderFallback.#ctor">
  387. <summary>初始化 <see cref="T:System.Text.EncoderFallback" /> 類別的新執行個體。</summary>
  388. </member>
  389. <member name="M:System.Text.EncoderFallback.CreateFallbackBuffer">
  390. <summary>在衍生類別中覆寫時,初始化 <see cref="T:System.Text.EncoderFallbackBuffer" /> 類別的新執行個體。</summary>
  391. <returns>提供編碼器後援緩衝區的物件。</returns>
  392. <filterpriority>2</filterpriority>
  393. </member>
  394. <member name="P:System.Text.EncoderFallback.ExceptionFallback">
  395. <summary>取得物件,此物件會在無法編碼輸入字元時會擲回例外狀況。</summary>
  396. <returns>衍生自 <see cref="T:System.Text.EncoderFallback" /> 類別的型別。預設值為 <see cref="T:System.Text.EncoderExceptionFallback" /> 物件。</returns>
  397. <filterpriority>1</filterpriority>
  398. </member>
  399. <member name="P:System.Text.EncoderFallback.MaxCharCount">
  400. <summary>在衍生類別中覆寫時,取得目前的 <see cref="T:System.Text.EncoderFallback" /> 物件可以傳回的最大字元數。</summary>
  401. <returns>目前的 <see cref="T:System.Text.EncoderFallback" /> 物件可以傳回的最大字元數。</returns>
  402. <filterpriority>2</filterpriority>
  403. </member>
  404. <member name="P:System.Text.EncoderFallback.ReplacementFallback">
  405. <summary>取得物件,此物件會產出替代字串,以取代無法編碼的輸入字元。</summary>
  406. <returns>衍生自 <see cref="T:System.Text.EncoderFallback" /> 類別的型別。預設值為 <see cref="T:System.Text.EncoderReplacementFallback" /> 物件,此物件會將未知的輸入字元取代為「問號」字元 ("?",U+003F)。</returns>
  407. <filterpriority>1</filterpriority>
  408. </member>
  409. <member name="T:System.Text.EncoderFallbackBuffer">
  410. <summary>提供緩衝區,允許後援處理常式在無法編碼輸入字元時,將替代字串傳回至編碼器。</summary>
  411. <filterpriority>2</filterpriority>
  412. </member>
  413. <member name="M:System.Text.EncoderFallbackBuffer.#ctor">
  414. <summary>初始化 <see cref="T:System.Text.EncoderFallbackBuffer" /> 類別的新執行個體。</summary>
  415. </member>
  416. <member name="M:System.Text.EncoderFallbackBuffer.Fallback(System.Char,System.Char,System.Int32)">
  417. <summary>在衍生類別中覆寫時,預備後援緩衝區來處理指定的 Surrogate 字組。</summary>
  418. <returns>如果後援緩衝區可以處理 <paramref name="charUnknownHigh" /> 和 <paramref name="charUnknownLow" /> 則為 true,如果後援緩衝區會忽略 Surrogate 字組則為 false。</returns>
  419. <param name="charUnknownHigh">輸入字組的高 Surrogate。</param>
  420. <param name="charUnknownLow">輸入字組的低 Surrogate。</param>
  421. <param name="index">輸入緩衝區中 Surrogate 字組的索引位置。</param>
  422. <filterpriority>1</filterpriority>
  423. </member>
  424. <member name="M:System.Text.EncoderFallbackBuffer.Fallback(System.Char,System.Int32)">
  425. <summary>在衍生類別中覆寫時,預備後援緩衝區來處理指定的輸入字元。</summary>
  426. <returns>如果後援緩衝區可以處理 <paramref name="charUnknown" />,則為 true;如果後援緩衝區會忽略 <paramref name="charUnknown" />,則為 false。</returns>
  427. <param name="charUnknown">輸入字元。</param>
  428. <param name="index">輸入緩衝區中字元的索引位置。</param>
  429. <filterpriority>1</filterpriority>
  430. </member>
  431. <member name="M:System.Text.EncoderFallbackBuffer.GetNextChar">
  432. <summary>在衍生類別中覆寫時,擷取後援緩衝區中的下一個字元。</summary>
  433. <returns>後援緩衝區中的下一個字元。</returns>
  434. <filterpriority>2</filterpriority>
  435. </member>
  436. <member name="M:System.Text.EncoderFallbackBuffer.MovePrevious">
  437. <summary>在衍生類別中覆寫時,會使 <see cref="M:System.Text.EncoderFallbackBuffer.GetNextChar" /> 方法的下一個呼叫存取在目前字元位置之前的資料緩衝區字元位置。</summary>
  438. <returns>如果 <see cref="M:System.Text.EncoderFallbackBuffer.MovePrevious" /> 作業成功,則為 true,否則為 false。</returns>
  439. <filterpriority>1</filterpriority>
  440. </member>
  441. <member name="P:System.Text.EncoderFallbackBuffer.Remaining">
  442. <summary>在衍生類別中覆寫時,於目前的 <see cref="T:System.Text.EncoderFallbackBuffer" /> 物件中取得仍要處理的字元數。</summary>
  443. <returns>目前的後援緩衝區中尚未處理的字元數。</returns>
  444. <filterpriority>1</filterpriority>
  445. </member>
  446. <member name="M:System.Text.EncoderFallbackBuffer.Reset">
  447. <summary>初始化與後援緩衝區有關的所有資料和狀態資訊。</summary>
  448. <filterpriority>1</filterpriority>
  449. </member>
  450. <member name="T:System.Text.EncoderFallbackException">
  451. <summary>當編碼器後援作業失敗時,所擲回的例外狀況。此類別無法被繼承。</summary>
  452. <filterpriority>2</filterpriority>
  453. </member>
  454. <member name="M:System.Text.EncoderFallbackException.#ctor">
  455. <summary>初始化 <see cref="T:System.Text.EncoderFallbackException" /> 類別的新執行個體。</summary>
  456. </member>
  457. <member name="M:System.Text.EncoderFallbackException.#ctor(System.String)">
  458. <summary>初始化 <see cref="T:System.Text.EncoderFallbackException" /> 類別的新執行個體。參數會指定錯誤訊息。</summary>
  459. <param name="message">錯誤訊息。</param>
  460. </member>
  461. <member name="M:System.Text.EncoderFallbackException.#ctor(System.String,System.Exception)">
  462. <summary>初始化 <see cref="T:System.Text.EncoderFallbackException" /> 類別的新執行個體。參數會指定錯誤訊息,以及造成此例外狀況的內部例外狀況。</summary>
  463. <param name="message">錯誤訊息。</param>
  464. <param name="innerException">造成此例外狀況的例外狀況。</param>
  465. </member>
  466. <member name="P:System.Text.EncoderFallbackException.CharUnknown">
  467. <summary>取得造成例外狀況的輸入字元。</summary>
  468. <returns>無法編碼的字元。</returns>
  469. <filterpriority>2</filterpriority>
  470. </member>
  471. <member name="P:System.Text.EncoderFallbackException.CharUnknownHigh">
  472. <summary>取得造成例外狀況之 Surrogate 字組的高元件字元。</summary>
  473. <returns>無法編碼之 Surrogate 字組的高元件字元。</returns>
  474. <filterpriority>2</filterpriority>
  475. </member>
  476. <member name="P:System.Text.EncoderFallbackException.CharUnknownLow">
  477. <summary>取得造成例外狀況之 Surrogate 字組的低元件字元。</summary>
  478. <returns>無法編碼之 Surrogate 字組的低元件字元。</returns>
  479. <filterpriority>2</filterpriority>
  480. </member>
  481. <member name="P:System.Text.EncoderFallbackException.Index">
  482. <summary>取得字元的輸入緩衝區中造成例外狀況的索引位置。</summary>
  483. <returns>取得無法編碼之字元輸入緩衝區中的索引位置。</returns>
  484. <filterpriority>1</filterpriority>
  485. </member>
  486. <member name="M:System.Text.EncoderFallbackException.IsUnknownSurrogate">
  487. <summary>指示導致此例外狀況發生的輸入是否為 Surrogate 字組。</summary>
  488. <returns>如果輸入為 Surrogate 字組,則為 true,否則為 false。</returns>
  489. <filterpriority>2</filterpriority>
  490. </member>
  491. <member name="T:System.Text.EncoderReplacementFallback">
  492. <summary>針對無法轉換為輸出位元組序列的輸入字元,提供失敗處理機制 (稱為後援)。此後援會使用使用者指定的取代字串,以取代原始輸入字元。此類別無法被繼承。</summary>
  493. <filterpriority>2</filterpriority>
  494. </member>
  495. <member name="M:System.Text.EncoderReplacementFallback.#ctor">
  496. <summary>初始化 <see cref="T:System.Text.EncoderReplacementFallback" /> 類別的新執行個體。</summary>
  497. </member>
  498. <member name="M:System.Text.EncoderReplacementFallback.#ctor(System.String)">
  499. <summary>使用指定的取代字串,初始化 <see cref="T:System.Text.EncoderReplacementFallback" /> 類別的新執行個體。</summary>
  500. <param name="replacement">在編碼作業中轉換的字串,此字串是用來取代無法編碼的輸入字元。</param>
  501. <exception cref="T:System.ArgumentNullException">
  502. <paramref name="replacement" /> 為 null。</exception>
  503. <exception cref="T:System.ArgumentException">
  504. <paramref name="replacement" /> 包含無效的 Surrogate 字組。換句話說,Surrogate 不是由一個高 Surrogate 元件 (後面再接著一個低 Surrogate 元件) 所組成。</exception>
  505. </member>
  506. <member name="M:System.Text.EncoderReplacementFallback.CreateFallbackBuffer">
  507. <summary>建立 <see cref="T:System.Text.EncoderFallbackBuffer" /> 物件,其使用此 <see cref="T:System.Text.EncoderReplacementFallback" /> 物件的取代字串初始化。</summary>
  508. <returns>
  509. <see cref="T:System.Text.EncoderFallbackBuffer" /> 物件等於此 <see cref="T:System.Text.EncoderReplacementFallback" /> 物件。</returns>
  510. <filterpriority>2</filterpriority>
  511. </member>
  512. <member name="P:System.Text.EncoderReplacementFallback.DefaultString">
  513. <summary>取得取代字串,此字串為 <see cref="T:System.Text.EncoderReplacementFallback" /> 物件的值。</summary>
  514. <returns>替代字串,用來取代無法編碼的輸入字元。</returns>
  515. <filterpriority>2</filterpriority>
  516. </member>
  517. <member name="M:System.Text.EncoderReplacementFallback.Equals(System.Object)">
  518. <summary>指示指定物件的值是否等於 <see cref="T:System.Text.EncoderReplacementFallback" /> 物件。</summary>
  519. <returns>如果 <paramref name="value" /> 參數指定 <see cref="T:System.Text.EncoderReplacementFallback" /> 物件,且該物件的取代字串等於此 <see cref="T:System.Text.EncoderReplacementFallback" /> 物件的取代字串,則為 true,否則為 false。</returns>
  520. <param name="value">
  521. <see cref="T:System.Text.EncoderReplacementFallback" /> 物件。</param>
  522. <filterpriority>2</filterpriority>
  523. </member>
  524. <member name="M:System.Text.EncoderReplacementFallback.GetHashCode">
  525. <summary>擷取 <see cref="T:System.Text.EncoderReplacementFallback" /> 物件值的雜湊程式碼。</summary>
  526. <returns>物件值的雜湊程式碼。</returns>
  527. <filterpriority>2</filterpriority>
  528. </member>
  529. <member name="P:System.Text.EncoderReplacementFallback.MaxCharCount">
  530. <summary>取得 <see cref="T:System.Text.EncoderReplacementFallback" /> 物件之取代字串中的字元數。</summary>
  531. <returns>字串中用來取代無法編碼之輸入字元的字元數。</returns>
  532. <filterpriority>2</filterpriority>
  533. </member>
  534. <member name="T:System.Text.Encoding">
  535. <summary>表示字元編碼方式。若要瀏覽此類型的.NET Framework 原始碼,請參閱參考來源。</summary>
  536. <filterpriority>1</filterpriority>
  537. </member>
  538. <member name="M:System.Text.Encoding.#ctor">
  539. <summary>初始化 <see cref="T:System.Text.Encoding" /> 類別的新執行個體。</summary>
  540. </member>
  541. <member name="M:System.Text.Encoding.#ctor(System.Int32)">
  542. <summary>初始化對應到指定字碼頁之 <see cref="T:System.Text.Encoding" /> 類別的新執行個體。</summary>
  543. <param name="codePage">慣用編碼方式的字碼頁識別項。-或-0,表示使用預設的編碼方式。 </param>
  544. <exception cref="T:System.ArgumentOutOfRangeException">
  545. <paramref name="codePage" /> 小於零。</exception>
  546. </member>
  547. <member name="M:System.Text.Encoding.#ctor(System.Int32,System.Text.EncoderFallback,System.Text.DecoderFallback)">
  548. <summary>初始化的新執行個體<see cref="T:System.Text.Encoding" />類別對應至指定的字碼頁,以指定編碼器和解碼器後援策略。</summary>
  549. <param name="codePage">編碼方式字碼頁識別項。</param>
  550. <param name="encoderFallback">物件,該物件會在無法以目前編碼方式將字元編碼時提供錯誤處理程序。</param>
  551. <param name="decoderFallback">物件,該物件會在無法以目前編碼方式將位元組序列解碼時提供錯誤處理程序。 </param>
  552. <exception cref="T:System.ArgumentOutOfRangeException">
  553. <paramref name="codePage" /> 小於零。</exception>
  554. </member>
  555. <member name="P:System.Text.Encoding.ASCII">
  556. <summary>取得 ASCII (7 位元) 字元集 (Character Set) 的編碼方式。</summary>
  557. <returns>ASCII (7 位元) 字元集的編碼方式。</returns>
  558. <filterpriority>1</filterpriority>
  559. </member>
  560. <member name="P:System.Text.Encoding.BigEndianUnicode">
  561. <summary>取得 UTF-16 格式的編碼方式,其使用由大到小的位元組順序。</summary>
  562. <returns>UTF-16 格式的編碼物件,這個格式使用位元組由大到小的位元組順序。</returns>
  563. <filterpriority>1</filterpriority>
  564. </member>
  565. <member name="M:System.Text.Encoding.Clone">
  566. <summary>在衍生類別中覆寫時,會建立目前 <see cref="T:System.Text.Encoding" /> 物件的淺層複本。</summary>
  567. <returns>目前 <see cref="T:System.Text.Encoding" /> 物件的複本。</returns>
  568. <filterpriority>2</filterpriority>
  569. </member>
  570. <member name="P:System.Text.Encoding.CodePage">
  571. <summary>在衍生類別中覆寫時,取得目前 <see cref="T:System.Text.Encoding" /> 的字碼頁識別項。</summary>
  572. <returns>目前 <see cref="T:System.Text.Encoding" /> 的字碼頁識別項。</returns>
  573. <filterpriority>2</filterpriority>
  574. </member>
  575. <member name="M:System.Text.Encoding.Convert(System.Text.Encoding,System.Text.Encoding,System.Byte[])">
  576. <summary>將整個位元組陣列從一種編碼方式轉換成另一種編碼方式。</summary>
  577. <returns>
  578. <see cref="T:System.Byte" /> 型別的陣列,包含將 <paramref name="bytes" /> 從 <paramref name="srcEncoding" /> 轉換成 <paramref name="dstEncoding" /> 的結果。</returns>
  579. <param name="srcEncoding">
  580. <paramref name="bytes" /> 的編碼格式。</param>
  581. <param name="dstEncoding">目標編碼格式。</param>
  582. <param name="bytes">要轉換的位元組。</param>
  583. <exception cref="T:System.ArgumentNullException">
  584. <paramref name="srcEncoding" /> 為 null。-或- <paramref name="dstEncoding" /> 為 null。-或- <paramref name="bytes" /> 為 null。</exception>
  585. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-srcEncoding。<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  586. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-dstEncoding。<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  587. <filterpriority>1</filterpriority>
  588. </member>
  589. <member name="M:System.Text.Encoding.Convert(System.Text.Encoding,System.Text.Encoding,System.Byte[],System.Int32,System.Int32)">
  590. <summary>將位元組陣列中的某一位元組範圍由一種編碼方式轉換成另一種編碼方式。</summary>
  591. <returns>
  592. <see cref="T:System.Byte" /> 型別的陣列,其中包含將 <paramref name="bytes" /> 中的某個位元組範圍從 <paramref name="srcEncoding" /> 轉換成 <paramref name="dstEncoding" /> 的結果。</returns>
  593. <param name="srcEncoding">來源陣列 <paramref name="bytes" /> 的編碼方式。</param>
  594. <param name="dstEncoding">輸出陣列的編碼方式。</param>
  595. <param name="bytes">要進行轉換的位元組陣列。</param>
  596. <param name="index">
  597. <paramref name="bytes" /> 中要轉換的第一個項目索引。</param>
  598. <param name="count">要進行轉換的位元組數。</param>
  599. <exception cref="T:System.ArgumentNullException">
  600. <paramref name="srcEncoding" /> 為 null。-或- <paramref name="dstEncoding" /> 為 null。-或- <paramref name="bytes" /> 為 null。 </exception>
  601. <exception cref="T:System.ArgumentOutOfRangeException">
  602. <paramref name="index" /> 和 <paramref name="count" /> 不會指定位元組陣列中的有效範圍。</exception>
  603. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-srcEncoding。<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  604. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-dstEncoding。<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  605. <filterpriority>1</filterpriority>
  606. </member>
  607. <member name="P:System.Text.Encoding.DecoderFallback">
  608. <summary>取得或設定目前 <see cref="T:System.Text.Encoding" /> 物件的 <see cref="T:System.Text.DecoderFallback" /> 物件。</summary>
  609. <returns>目前 <see cref="T:System.Text.Encoding" /> 物件的解碼器後援物件。</returns>
  610. <exception cref="T:System.ArgumentNullException">設定作業中的值是 null。</exception>
  611. <exception cref="T:System.InvalidOperationException">無法在設定作業中指派值,因為目前的 <see cref="T:System.Text.Encoding" /> 物件是唯讀的。</exception>
  612. <filterpriority>2</filterpriority>
  613. </member>
  614. <member name="P:System.Text.Encoding.EncoderFallback">
  615. <summary>取得或設定目前 <see cref="T:System.Text.Encoding" /> 物件的 <see cref="T:System.Text.EncoderFallback" /> 物件。</summary>
  616. <returns>目前 <see cref="T:System.Text.Encoding" /> 物件的編碼器後援物件。</returns>
  617. <exception cref="T:System.ArgumentNullException">設定作業中的值是 null。</exception>
  618. <exception cref="T:System.InvalidOperationException">無法在設定作業中指派值,因為目前的 <see cref="T:System.Text.Encoding" /> 物件是唯讀的。</exception>
  619. <filterpriority>2</filterpriority>
  620. </member>
  621. <member name="P:System.Text.Encoding.EncodingName">
  622. <summary>在衍生類別中覆寫時,取得目前編碼方式的人們可讀取 (Human-Readable) 的描述。</summary>
  623. <returns>目前 <see cref="T:System.Text.Encoding" /> 的人們可讀取的描述。</returns>
  624. <filterpriority>2</filterpriority>
  625. </member>
  626. <member name="M:System.Text.Encoding.Equals(System.Object)">
  627. <summary>判斷指定的 <see cref="T:System.Object" /> 和目前的執行個體是否相等。</summary>
  628. <returns>如果 <paramref name="value" /> 是 <see cref="T:System.Text.Encoding" /> 的執行個體,並且等於目前的執行個體,則為 true,否則為 false。</returns>
  629. <param name="value">要與目前執行個體比較的 <see cref="T:System.Object" />。 </param>
  630. <filterpriority>2</filterpriority>
  631. </member>
  632. <member name="M:System.Text.Encoding.GetByteCount(System.Char*,System.Int32)">
  633. <summary>在衍生類別中覆寫時,計算從指定的字元指標開始,編碼一組字元所產生的位元組數目。</summary>
  634. <returns>編碼指定字元所產生的位元組數。</returns>
  635. <param name="chars">要編碼的第一個字元指標。</param>
  636. <param name="count">要編碼的字元數。</param>
  637. <exception cref="T:System.ArgumentNullException">
  638. <paramref name="chars" /> 為 null。 </exception>
  639. <exception cref="T:System.ArgumentOutOfRangeException">
  640. <paramref name="count" /> 小於零。</exception>
  641. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  642. <filterpriority>1</filterpriority>
  643. </member>
  644. <member name="M:System.Text.Encoding.GetByteCount(System.Char[])">
  645. <summary>在衍生類別中覆寫時,計算編碼指定字元陣列中所有字元所產生的位元組數目。</summary>
  646. <returns>編碼指定字元陣列中所有字元所產生的位元組數目。</returns>
  647. <param name="chars">字元陣列,包含要編碼的字元。</param>
  648. <exception cref="T:System.ArgumentNullException">
  649. <paramref name="chars" /> 為 null。</exception>
  650. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  651. <filterpriority>1</filterpriority>
  652. </member>
  653. <member name="M:System.Text.Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
  654. <summary>在衍生類別中覆寫時,計算從指定的字元陣列編碼一組字元所產生的位元組數目。</summary>
  655. <returns>編碼指定字元所產生的位元組數。</returns>
  656. <param name="chars">包含要解碼之一組字元的字元陣列。</param>
  657. <param name="index">要編碼的第一個字元索引。</param>
  658. <param name="count">要編碼的字元數。</param>
  659. <exception cref="T:System.ArgumentNullException">
  660. <paramref name="chars" /> 為 null。 </exception>
  661. <exception cref="T:System.ArgumentOutOfRangeException">
  662. <paramref name="index" /> 或 <paramref name="count" /> 小於零。-或- <paramref name="index" /> 和 <paramref name="count" /> 不代表 <paramref name="chars" /> 中有效的範圍。</exception>
  663. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  664. <filterpriority>1</filterpriority>
  665. </member>
  666. <member name="M:System.Text.Encoding.GetByteCount(System.String)">
  667. <summary>在衍生類別中覆寫時,計算編碼指定的字串字元所產生的位元組數目。</summary>
  668. <returns>編碼指定字元所產生的位元組數。</returns>
  669. <param name="s">字串,包含要編碼的一組字元。</param>
  670. <exception cref="T:System.ArgumentNullException">
  671. <paramref name="s" /> 為 null。</exception>
  672. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  673. <filterpriority>1</filterpriority>
  674. </member>
  675. <member name="M:System.Text.Encoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
  676. <summary>在衍生類別中覆寫時,從指定字元指標開始將一組字元編碼成位元組序列 (會從指定的位元組指標開始存放這些位元組)。</summary>
  677. <returns>
  678. <paramref name="bytes" /> 參數所指示位置上寫入的實際位元組數目。</returns>
  679. <param name="chars">要編碼的第一個字元指標。</param>
  680. <param name="charCount">要編碼的字元數。</param>
  681. <param name="bytes">開始寫入結果位元組序列的位置指標。</param>
  682. <param name="byteCount">寫入的最大位元組數。</param>
  683. <exception cref="T:System.ArgumentNullException">
  684. <paramref name="chars" /> 為 null。-或- <paramref name="bytes" /> 為 null。 </exception>
  685. <exception cref="T:System.ArgumentOutOfRangeException">
  686. <paramref name="charCount" /> 或 <paramref name="byteCount" /> 小於零。 </exception>
  687. <exception cref="T:System.ArgumentException">
  688. <paramref name="byteCount" /> 小於結果位元組數。</exception>
  689. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  690. <filterpriority>1</filterpriority>
  691. </member>
  692. <member name="M:System.Text.Encoding.GetBytes(System.Char[])">
  693. <summary>在衍生類別中覆寫時,將指定字元陣列中的所有字元編碼成位元組序列。</summary>
  694. <returns>位元組陣列,包含將指定之一組字元編碼之後的結果。</returns>
  695. <param name="chars">字元陣列,包含要編碼的字元。</param>
  696. <exception cref="T:System.ArgumentNullException">
  697. <paramref name="chars" /> 為 null。</exception>
  698. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  699. <filterpriority>1</filterpriority>
  700. </member>
  701. <member name="M:System.Text.Encoding.GetBytes(System.Char[],System.Int32,System.Int32)">
  702. <summary>在衍生類別中覆寫時,將指定字元陣列中的一組字元編碼成位元組序列。</summary>
  703. <returns>位元組陣列,包含將指定之一組字元編碼之後的結果。</returns>
  704. <param name="chars">包含要解碼之一組字元的字元陣列。</param>
  705. <param name="index">要編碼的第一個字元索引。</param>
  706. <param name="count">要編碼的字元數。</param>
  707. <exception cref="T:System.ArgumentNullException">
  708. <paramref name="chars" /> 為 null。 </exception>
  709. <exception cref="T:System.ArgumentOutOfRangeException">
  710. <paramref name="index" /> 或 <paramref name="count" /> 小於零。-或- <paramref name="index" /> 和 <paramref name="count" /> 不代表 <paramref name="chars" /> 中有效的範圍。</exception>
  711. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  712. <filterpriority>1</filterpriority>
  713. </member>
  714. <member name="M:System.Text.Encoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
  715. <summary>在衍生類別中覆寫時,將指定字元陣列中的一組字元編碼成指定的位元組陣列。</summary>
  716. <returns>寫入 <paramref name="bytes" /> 的實際位元組數。</returns>
  717. <param name="chars">包含要解碼之一組字元的字元陣列。</param>
  718. <param name="charIndex">要編碼的第一個字元索引。</param>
  719. <param name="charCount">要編碼的字元數。</param>
  720. <param name="bytes">要包含結果位元組序列的位元組陣列。</param>
  721. <param name="byteIndex">要開始寫入結果位元組序列的索引。</param>
  722. <exception cref="T:System.ArgumentNullException">
  723. <paramref name="chars" /> 為 null。-或- <paramref name="bytes" /> 為 null。 </exception>
  724. <exception cref="T:System.ArgumentOutOfRangeException">
  725. <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>
  726. <exception cref="T:System.ArgumentException">從 <paramref name="byteIndex" /> 到陣列結尾處,<paramref name="bytes" /> 沒有足夠的容量容納結果位元組。</exception>
  727. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  728. <filterpriority>1</filterpriority>
  729. </member>
  730. <member name="M:System.Text.Encoding.GetBytes(System.String)">
  731. <summary>在衍生類別中覆寫時,將指定字串中的所有字元編碼成位元組序列。</summary>
  732. <returns>位元組陣列,包含將指定之一組字元編碼之後的結果。</returns>
  733. <param name="s">字串,包含要編碼的字元。</param>
  734. <exception cref="T:System.ArgumentNullException">
  735. <paramref name="s" /> 為 null。</exception>
  736. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  737. <filterpriority>1</filterpriority>
  738. </member>
  739. <member name="M:System.Text.Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
  740. <summary>在衍生類別中覆寫時,將指定字串中的一組字元編碼成指定的位元組陣列。</summary>
  741. <returns>寫入 <paramref name="bytes" /> 的實際位元組數。</returns>
  742. <param name="s">字串,包含要編碼的一組字元。</param>
  743. <param name="charIndex">要編碼的第一個字元索引。</param>
  744. <param name="charCount">要編碼的字元數。</param>
  745. <param name="bytes">要包含結果位元組序列的位元組陣列。</param>
  746. <param name="byteIndex">要開始寫入結果位元組序列的索引。</param>
  747. <exception cref="T:System.ArgumentNullException">
  748. <paramref name="s" /> 為 null。-或- <paramref name="bytes" /> 為 null。 </exception>
  749. <exception cref="T:System.ArgumentOutOfRangeException">
  750. <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>
  751. <exception cref="T:System.ArgumentException">從 <paramref name="byteIndex" /> 到陣列結尾處,<paramref name="bytes" /> 沒有足夠的容量容納結果位元組。</exception>
  752. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  753. <filterpriority>1</filterpriority>
  754. </member>
  755. <member name="M:System.Text.Encoding.GetCharCount(System.Byte*,System.Int32)">
  756. <summary>在衍生類別中覆寫時,計算從指定的位元組指標開始,解碼位元組序列所產生的字元數目。</summary>
  757. <returns>解碼指定位元組序列所產生的字元數。</returns>
  758. <param name="bytes">要解碼的第一個位元組指標。</param>
  759. <param name="count">要解碼的位元組數。</param>
  760. <exception cref="T:System.ArgumentNullException">
  761. <paramref name="bytes" /> 為 null。 </exception>
  762. <exception cref="T:System.ArgumentOutOfRangeException">
  763. <paramref name="count" /> 小於零。</exception>
  764. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  765. <filterpriority>1</filterpriority>
  766. </member>
  767. <member name="M:System.Text.Encoding.GetCharCount(System.Byte[])">
  768. <summary>在衍生類別中覆寫時,計算解碼指定位元組陣列中所有位元組所產生的字元數目。</summary>
  769. <returns>解碼指定位元組序列所產生的字元數。</returns>
  770. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  771. <exception cref="T:System.ArgumentNullException">
  772. <paramref name="bytes" /> 為 null。</exception>
  773. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  774. <filterpriority>1</filterpriority>
  775. </member>
  776. <member name="M:System.Text.Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
  777. <summary>在衍生類別中覆寫時,計算從指定的位元組陣列解碼位元組序列所產生的字元數目。</summary>
  778. <returns>解碼指定位元組序列所產生的字元數。</returns>
  779. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  780. <param name="index">要解碼的第一個位元組索引。</param>
  781. <param name="count">要解碼的位元組數。</param>
  782. <exception cref="T:System.ArgumentNullException">
  783. <paramref name="bytes" /> 為 null。 </exception>
  784. <exception cref="T:System.ArgumentOutOfRangeException">
  785. <paramref name="index" /> 或 <paramref name="count" /> 小於零。-或- <paramref name="index" /> 和 <paramref name="count" /> 不代表 <paramref name="bytes" /> 中有效的範圍。</exception>
  786. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  787. <filterpriority>1</filterpriority>
  788. </member>
  789. <member name="M:System.Text.Encoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
  790. <summary>在衍生類別中覆寫時,從指定位元組指標開始將位元組序列解碼成一組字元 (會從指定的字元指標開始存放這些字元)。</summary>
  791. <returns>
  792. <paramref name="chars" /> 參數所指示位置上寫入的實際字元數目。</returns>
  793. <param name="bytes">要解碼的第一個位元組指標。</param>
  794. <param name="byteCount">要解碼的位元組數。</param>
  795. <param name="chars">開始寫入產生的一組字元之位置指標。</param>
  796. <param name="charCount">要寫入的最大字元數。</param>
  797. <exception cref="T:System.ArgumentNullException">
  798. <paramref name="bytes" /> 為 null。-或- <paramref name="chars" /> 為 null。 </exception>
  799. <exception cref="T:System.ArgumentOutOfRangeException">
  800. <paramref name="byteCount" /> 或 <paramref name="charCount" /> 小於零。 </exception>
  801. <exception cref="T:System.ArgumentException">
  802. <paramref name="charCount" /> 小於結果字元數。</exception>
  803. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  804. <filterpriority>1</filterpriority>
  805. </member>
  806. <member name="M:System.Text.Encoding.GetChars(System.Byte[])">
  807. <summary>在衍生類別中覆寫時,將指定位元組陣列中的所有位元組解碼成一組字元。</summary>
  808. <returns>字元陣列,包含解碼指定位元組序列的結果。</returns>
  809. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  810. <exception cref="T:System.ArgumentNullException">
  811. <paramref name="bytes" /> 為 null。</exception>
  812. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  813. <filterpriority>1</filterpriority>
  814. </member>
  815. <member name="M:System.Text.Encoding.GetChars(System.Byte[],System.Int32,System.Int32)">
  816. <summary>在衍生類別中覆寫時,將指定位元組陣列中的位元組序列解碼成一組字元。</summary>
  817. <returns>字元陣列,包含解碼指定位元組序列的結果。</returns>
  818. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  819. <param name="index">要解碼的第一個位元組索引。</param>
  820. <param name="count">要解碼的位元組數。</param>
  821. <exception cref="T:System.ArgumentNullException">
  822. <paramref name="bytes" /> 為 null。 </exception>
  823. <exception cref="T:System.ArgumentOutOfRangeException">
  824. <paramref name="index" /> 或 <paramref name="count" /> 小於零。-或- <paramref name="index" /> 和 <paramref name="count" /> 不代表 <paramref name="bytes" /> 中有效的範圍。</exception>
  825. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  826. <filterpriority>1</filterpriority>
  827. </member>
  828. <member name="M:System.Text.Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
  829. <summary>在衍生類別中覆寫時,將指定位元組陣列中的位元組序列解碼成指定的字元陣列。</summary>
  830. <returns>實際寫入 <paramref name="chars" /> 的字元數。</returns>
  831. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  832. <param name="byteIndex">要解碼的第一個位元組索引。</param>
  833. <param name="byteCount">要解碼的位元組數。</param>
  834. <param name="chars">包含產生的一組字元之字元陣列。</param>
  835. <param name="charIndex">要開始寫入產生的一組字元之索引。</param>
  836. <exception cref="T:System.ArgumentNullException">
  837. <paramref name="bytes" /> 為 null。-或- <paramref name="chars" /> 為 null。 </exception>
  838. <exception cref="T:System.ArgumentOutOfRangeException">
  839. <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>
  840. <exception cref="T:System.ArgumentException">從 <paramref name="charIndex" /> 到陣列結尾處,<paramref name="chars" /> 沒有足夠的容量容納結果字元。</exception>
  841. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  842. <filterpriority>1</filterpriority>
  843. </member>
  844. <member name="M:System.Text.Encoding.GetDecoder">
  845. <summary>在衍生類別中覆寫時,取得會將編碼的位元組序列轉換成字元序列的解碼器。</summary>
  846. <returns>
  847. <see cref="T:System.Text.Decoder" />,會將編碼的位元組序列轉換成字元序列。</returns>
  848. <filterpriority>1</filterpriority>
  849. </member>
  850. <member name="M:System.Text.Encoding.GetEncoder">
  851. <summary>在衍生類別中覆寫時,取得會將 Unicode 字元序列轉換成編碼的位元組序列的編碼器。</summary>
  852. <returns>
  853. <see cref="T:System.Text.Encoder" />,會將 Unicode 字元序列轉換成編碼的位元組序列。</returns>
  854. <filterpriority>1</filterpriority>
  855. </member>
  856. <member name="M:System.Text.Encoding.GetEncoding(System.Int32)">
  857. <summary>傳回與指定字碼頁識別項相關聯的編碼方式。</summary>
  858. <returns>與指定字碼頁相關聯的編碼方式。</returns>
  859. <param name="codepage">慣用編碼方式的字碼頁識別項。<see cref="T:System.Text.Encoding" /> 類別主題中表格的字碼頁欄列出可能值。-或-0 (零),表示使用預設的編碼方式。</param>
  860. <exception cref="T:System.ArgumentOutOfRangeException">
  861. <paramref name="codepage" /> 小於零或大於 65535。 </exception>
  862. <exception cref="T:System.ArgumentException">基礎的平台並不支援 <paramref name="codepage" />。 </exception>
  863. <exception cref="T:System.NotSupportedException">基礎的平台並不支援 <paramref name="codepage" />。</exception>
  864. <filterpriority>1</filterpriority>
  865. </member>
  866. <member name="M:System.Text.Encoding.GetEncoding(System.Int32,System.Text.EncoderFallback,System.Text.DecoderFallback)">
  867. <summary>傳回與指定字碼頁識別項相關聯的編碼方式。參數會針對無法編碼的字元以及無法解碼的位元組序列指定錯誤處理常式。</summary>
  868. <returns>與指定字碼頁相關聯的編碼方式。</returns>
  869. <param name="codepage">慣用編碼方式的字碼頁識別項。<see cref="T:System.Text.Encoding" /> 類別主題中表格的字碼頁欄列出可能值。-或-0 (零),表示使用預設的編碼方式。</param>
  870. <param name="encoderFallback">物件,該物件會在無法以目前編碼方式將字元編碼時提供錯誤處理程序。</param>
  871. <param name="decoderFallback">物件,該物件會在無法以目前編碼方式將位元組序列解碼時提供錯誤處理程序。</param>
  872. <exception cref="T:System.ArgumentOutOfRangeException">
  873. <paramref name="codepage" /> 小於零或大於 65535。 </exception>
  874. <exception cref="T:System.ArgumentException">基礎的平台並不支援 <paramref name="codepage" />。 </exception>
  875. <exception cref="T:System.NotSupportedException">基礎的平台並不支援 <paramref name="codepage" />。</exception>
  876. <filterpriority>1</filterpriority>
  877. </member>
  878. <member name="M:System.Text.Encoding.GetEncoding(System.String)">
  879. <summary>傳回與指定字碼頁名稱相關聯的編碼方式。</summary>
  880. <returns>與指定字碼頁相關聯的編碼方式。</returns>
  881. <param name="name">慣用編碼方式的字碼頁名稱。<see cref="P:System.Text.Encoding.WebName" /> 屬性傳回的任何值都是有效值。<see cref="T:System.Text.Encoding" /> 類別主題中表格的名稱欄列出可能值。</param>
  882. <exception cref="T:System.ArgumentException">
  883. <paramref name="name" /> 不是有效的字碼頁名稱。-或-主要平台尚不支援以 <paramref name="name" /> 所指示的字碼頁。</exception>
  884. <filterpriority>1</filterpriority>
  885. </member>
  886. <member name="M:System.Text.Encoding.GetEncoding(System.String,System.Text.EncoderFallback,System.Text.DecoderFallback)">
  887. <summary>傳回與指定字碼頁名稱相關聯的編碼方式。參數會針對無法編碼的字元以及無法解碼的位元組序列指定錯誤處理常式。</summary>
  888. <returns>與指定字碼頁相關聯的編碼方式。</returns>
  889. <param name="name">慣用編碼方式的字碼頁名稱。<see cref="P:System.Text.Encoding.WebName" /> 屬性傳回的任何值都是有效值。<see cref="T:System.Text.Encoding" /> 類別主題中表格的名稱欄列出可能值。</param>
  890. <param name="encoderFallback">物件,該物件會在無法以目前編碼方式將字元編碼時提供錯誤處理程序。</param>
  891. <param name="decoderFallback">物件,該物件會在無法以目前編碼方式將位元組序列解碼時提供錯誤處理程序。</param>
  892. <exception cref="T:System.ArgumentException">
  893. <paramref name="name" /> 不是有效的字碼頁名稱。-或-主要平台尚不支援以 <paramref name="name" /> 所指示的字碼頁。</exception>
  894. <filterpriority>1</filterpriority>
  895. </member>
  896. <member name="M:System.Text.Encoding.GetHashCode">
  897. <summary>傳回目前執行個體的雜湊碼。</summary>
  898. <returns>目前執行個體的雜湊碼。</returns>
  899. <filterpriority>1</filterpriority>
  900. </member>
  901. <member name="M:System.Text.Encoding.GetMaxByteCount(System.Int32)">
  902. <summary>在衍生類別中覆寫時,計算編碼指定的字元數所產生的最大位元組數目。</summary>
  903. <returns>編碼指定字元數所產生的最大位元組數。</returns>
  904. <param name="charCount">要編碼的字元數。</param>
  905. <exception cref="T:System.ArgumentOutOfRangeException">
  906. <paramref name="charCount" /> 小於零。</exception>
  907. <exception cref="T:System.Text.EncoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.EncoderFallback" /> 設定為 <see cref="T:System.Text.EncoderExceptionFallback" />。</exception>
  908. <filterpriority>1</filterpriority>
  909. </member>
  910. <member name="M:System.Text.Encoding.GetMaxCharCount(System.Int32)">
  911. <summary>在衍生類別中覆寫時,計算解碼指定的位元組數目所產生的最大字元數目。</summary>
  912. <returns>解碼指定位元組數所產生的最大字元數。</returns>
  913. <param name="byteCount">要解碼的位元組數。</param>
  914. <exception cref="T:System.ArgumentOutOfRangeException">
  915. <paramref name="byteCount" /> 小於零。</exception>
  916. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  917. <filterpriority>1</filterpriority>
  918. </member>
  919. <member name="M:System.Text.Encoding.GetPreamble">
  920. <summary>在衍生類別中覆寫時,傳回可指定所用編碼方式的位元組序列。</summary>
  921. <returns>位元組陣列,包含可指定所用編碼方式的位元組序列。-或-如果不需要前序編碼,則位元組陣列的長度為零。</returns>
  922. <filterpriority>1</filterpriority>
  923. </member>
  924. <member name="M:System.Text.Encoding.GetString(System.Byte*,System.Int32)">
  925. <summary>在衍生類別中覆寫,解碼指定的開頭指定的位址轉換為字串的位元組數目。</summary>
  926. <returns>字串,包含將指定之位元組序列解碼的結果。 </returns>
  927. <param name="bytes">位元組陣列的指標。</param>
  928. <param name="byteCount">要解碼的位元組數。</param>
  929. <exception cref="T:System.ArgumentNullException">
  930. <paramref name="bytes" />為 null 指標。 </exception>
  931. <exception cref="T:System.ArgumentOutOfRangeException">
  932. <paramref name="byteCount" /> 小於零。</exception>
  933. <exception cref="T:System.Text.DecoderFallbackException">後援發生 (請參閱.NET Framework 中的字元編碼方式如完整的說明)-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  934. </member>
  935. <member name="M:System.Text.Encoding.GetString(System.Byte[])">
  936. <summary>在衍生類別中覆寫時,將指定位元組陣列中的所有位元組解碼成字串。</summary>
  937. <returns>字串,包含將指定之位元組序列解碼的結果。</returns>
  938. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  939. <exception cref="T:System.ArgumentException">位元組陣列包含無效的 Unicode 字碼指標。</exception>
  940. <exception cref="T:System.ArgumentNullException">
  941. <paramref name="bytes" /> 為 null。</exception>
  942. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  943. <filterpriority>1</filterpriority>
  944. </member>
  945. <member name="M:System.Text.Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
  946. <summary>在衍生類別中覆寫時,將指定位元組陣列中的位元組序列解碼成字串。</summary>
  947. <returns>字串,包含將指定之位元組序列解碼的結果。</returns>
  948. <param name="bytes">包含要解碼之位元組序列的位元組陣列。</param>
  949. <param name="index">要解碼的第一個位元組索引。</param>
  950. <param name="count">要解碼的位元組數。</param>
  951. <exception cref="T:System.ArgumentException">位元組陣列包含無效的 Unicode 字碼指標。</exception>
  952. <exception cref="T:System.ArgumentNullException">
  953. <paramref name="bytes" /> 為 null。 </exception>
  954. <exception cref="T:System.ArgumentOutOfRangeException">
  955. <paramref name="index" /> 或 <paramref name="count" /> 小於零。-或- <paramref name="index" /> 和 <paramref name="count" /> 不代表 <paramref name="bytes" /> 中有效的範圍。</exception>
  956. <exception cref="T:System.Text.DecoderFallbackException">發生的後援 (如需完整說明,請參閱.NET Framework 中的字元編碼方式)。-和-<see cref="P:System.Text.Encoding.DecoderFallback" /> 設定為 <see cref="T:System.Text.DecoderExceptionFallback" />。</exception>
  957. <filterpriority>1</filterpriority>
  958. </member>
  959. <member name="P:System.Text.Encoding.IsSingleByte">
  960. <summary>在衍生類別中覆寫時,取得值,指出目前的編碼方式是否使用單一位元組字碼指標。</summary>
  961. <returns>如果目前的 <see cref="T:System.Text.Encoding" /> 使用單一位元組字碼指標,則為 true,否則為 false。</returns>
  962. <filterpriority>2</filterpriority>
  963. </member>
  964. <member name="M:System.Text.Encoding.RegisterProvider(System.Text.EncodingProvider)">
  965. <summary>註冊編碼的提供者。</summary>
  966. <param name="provider">子類別<see cref="T:System.Text.EncodingProvider" />可提供額外的字元編碼的存取。 </param>
  967. <exception cref="T:System.ArgumentNullException">
  968. <paramref name="provider" /> 為 null。</exception>
  969. </member>
  970. <member name="P:System.Text.Encoding.Unicode">
  971. <summary>以位元組由小到大位元組順序取得 UTF-16 格式的編碼方式。</summary>
  972. <returns>UTF-16 格式的編碼方式,使用位元組由小到大的位元組順序。</returns>
  973. <filterpriority>1</filterpriority>
  974. </member>
  975. <member name="P:System.Text.Encoding.UTF32">
  976. <summary>以位元組由小到大位元組順序取得 UTF-32 格式的編碼方式。</summary>
  977. <returns>UTF-32 格式的編碼物件,使用位元組由小到大的位元組順序。</returns>
  978. <filterpriority>1</filterpriority>
  979. </member>
  980. <member name="P:System.Text.Encoding.UTF7">
  981. <summary>取得 UTF-7 格式的編碼方式。</summary>
  982. <returns>UTF-7 格式的編碼方式。</returns>
  983. <filterpriority>1</filterpriority>
  984. </member>
  985. <member name="P:System.Text.Encoding.UTF8">
  986. <summary>取得 UTF-8 格式的編碼方式。</summary>
  987. <returns>UTF-8 格式的編碼方式。</returns>
  988. <filterpriority>1</filterpriority>
  989. </member>
  990. <member name="P:System.Text.Encoding.WebName">
  991. <summary>在衍生類別中覆寫時,若要取得目前的編碼方式,請取得向 Internet Assigned Numbers Authority (IANA) 註冊的名稱。</summary>
  992. <returns>目前 <see cref="T:System.Text.Encoding" /> 的 IANA 名稱。</returns>
  993. <filterpriority>2</filterpriority>
  994. </member>
  995. <member name="T:System.Text.EncodingProvider">
  996. <summary>提供編碼提供者的基底類別,這個提供者提供特定平台無法使用的編碼方式。</summary>
  997. </member>
  998. <member name="M:System.Text.EncodingProvider.#ctor">
  999. <summary>初始化 <see cref="T:System.Text.EncodingProvider" /> 類別的新執行個體。</summary>
  1000. </member>
  1001. <member name="M:System.Text.EncodingProvider.GetEncoding(System.Int32)">
  1002. <summary>傳回與指定字碼頁識別項相關聯的編碼方式。</summary>
  1003. <returns>與指定的字碼頁,也就使用編碼方式相關聯或null如果此<see cref="T:System.Text.EncodingProvider" />無法傳回有效的編碼對應至<paramref name="codepage" />。</returns>
  1004. <param name="codepage">要求的編碼方式的字碼頁識別項。</param>
  1005. </member>
  1006. <member name="M:System.Text.EncodingProvider.GetEncoding(System.Int32,System.Text.EncoderFallback,System.Text.DecoderFallback)">
  1007. <summary>傳回與指定字碼頁識別項相關聯的編碼方式。參數會針對無法編碼的字元以及無法解碼的位元組序列指定錯誤處理常式。</summary>
  1008. <returns>與指定的字碼頁,也就使用編碼方式相關聯或null如果此<see cref="T:System.Text.EncodingProvider" />無法傳回有效的編碼對應至<paramref name="codepage" />。</returns>
  1009. <param name="codepage">要求的編碼方式的字碼頁識別項。</param>
  1010. <param name="encoderFallback">提供錯誤處理程序時無法使用這種編碼方式編碼字元的物件。</param>
  1011. <param name="decoderFallback">無法解碼的位元組序列時提供錯誤處理程序與此編碼的物件。</param>
  1012. </member>
  1013. <member name="M:System.Text.EncodingProvider.GetEncoding(System.String)">
  1014. <summary>傳回具有指定名稱的編碼方式。</summary>
  1015. <returns>與指定的名稱,也就使用編碼方式關聯或null如果此<see cref="T:System.Text.EncodingProvider" />無法傳回有效的編碼對應至<paramref name="name" />。</returns>
  1016. <param name="name">要求的編碼方式的名稱。</param>
  1017. </member>
  1018. <member name="M:System.Text.EncodingProvider.GetEncoding(System.String,System.Text.EncoderFallback,System.Text.DecoderFallback)">
  1019. <summary>傳回與指定名稱關聯的編碼方式。參數會針對無法編碼的字元以及無法解碼的位元組序列指定錯誤處理常式。</summary>
  1020. <returns>與指定的名稱,也就使用編碼方式關聯或null如果此<see cref="T:System.Text.EncodingProvider" />無法傳回有效的編碼對應至<paramref name="name" />。</returns>
  1021. <param name="name">慣用的編碼方式的名稱。</param>
  1022. <param name="encoderFallback">提供錯誤處理程序時無法使用這種編碼方式編碼字元的物件。</param>
  1023. <param name="decoderFallback">物件,該物件會在無法以目前編碼方式將位元組序列解碼時提供錯誤處理程序。</param>
  1024. </member>
  1025. </members>
  1026. </doc>