1 <?xml version="1.0" encoding="utf-8"?>
4 <name>System.Text.Encoding.Extensions</name>
7 <member name="T:System.Text.ASCIIEncoding">
8 <summary>表示 Unicode 字元的 ASCII 字元編碼方式。</summary>
9 <filterpriority>1</filterpriority>
11 <member name="M:System.Text.ASCIIEncoding.#ctor">
12 <summary>初始化 <see cref="T:System.Text.ASCIIEncoding" /> 類別的新執行個體。</summary>
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>
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>
39 <member name="M:System.Text.ASCIIEncoding.GetByteCount(System.String)">
40 <summary>在指定的 <see cref="T:System.String" /> 中計算字元進行編碼後所產生的位元組數目。</summary>
41 <returns>編碼指定字元所產生的位元組數。</returns>
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>
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>
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>
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>
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>
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>
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>
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>
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>
156 <member name="M:System.Text.ASCIIEncoding.GetDecoder">
157 <summary>取得可以將以 ASCII 編碼的位元組序列轉換成 Unicode 字元序列的解碼器。</summary>
159 <see cref="T:System.Text.Decoder" />,可以將以 ASCII 編碼的位元組序列轉換成 Unicode 字元序列。</returns>
160 <filterpriority>1</filterpriority>
162 <member name="M:System.Text.ASCIIEncoding.GetEncoder">
163 <summary>取得可以將 Unicode 字元序列轉換成以 ASCII 編碼的位元組序列的編碼器。</summary>
165 <see cref="T:System.Text.Encoder" />,可將 Unicode 字元序列轉換成以 ASCII 編碼的位元組序列。</returns>
166 <filterpriority>1</filterpriority>
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>
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>
184 <member name="M:System.Text.ASCIIEncoding.GetString(System.Byte[],System.Int32,System.Int32)">
185 <summary>將位元組陣列中的某一段位元組範圍解碼成字串。</summary>
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>
198 <member name="P:System.Text.ASCIIEncoding.IsSingleByte">
199 <summary>取得值,指出目前的編碼方式是否使用單一位元組字碼指標。</summary>
200 <returns>這個屬性經常是 true。</returns>
201 <filterpriority>2</filterpriority>
203 <member name="T:System.Text.UnicodeEncoding">
204 <summary>代表 Unicode 字元的 UTF-16 編碼方式。</summary>
205 <filterpriority>1</filterpriority>
207 <member name="M:System.Text.UnicodeEncoding.#ctor">
208 <summary>初始化 <see cref="T:System.Text.UnicodeEncoding" /> 類別的新執行個體。</summary>
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>
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>
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>
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>
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>
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>
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>
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>
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>
314 <member name="M:System.Text.UnicodeEncoding.GetDecoder">
315 <summary>取得可以將以 UTF-16 編碼的位元組序列轉換成 Unicode 字元序列的解碼器。</summary>
317 <see cref="T:System.Text.Decoder" />,可以將以 UTF-16 編碼的位元組序列轉換成 Unicode 字元序列。</returns>
318 <filterpriority>1</filterpriority>
320 <member name="M:System.Text.UnicodeEncoding.GetEncoder">
321 <summary>取得可以將 Unicode 字元序列轉換成以 UTF-16 編碼的位元組序列的編碼器。</summary>
323 <see cref="T:System.Text.Encoder" /> 物件,可以將 Unicode 字元序列轉換成以 UTF-16 編碼的位元組序列。</returns>
324 <filterpriority>1</filterpriority>
326 <member name="M:System.Text.UnicodeEncoding.GetHashCode">
327 <summary>傳回目前執行個體的雜湊碼。</summary>
328 <returns>目前 <see cref="T:System.Text.UnicodeEncoding" /> 物件的雜湊碼。</returns>
329 <filterpriority>1</filterpriority>
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>
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>
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>
354 <member name="M:System.Text.UnicodeEncoding.GetString(System.Byte[],System.Int32,System.Int32)">
355 <summary>將位元組陣列中的某一段位元組範圍解碼成字串。</summary>
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>
369 <member name="T:System.Text.UTF32Encoding">
370 <summary>代表 Unicode 字元的 UTF-32 編碼方式。</summary>
371 <filterpriority>1</filterpriority>
373 <member name="M:System.Text.UTF32Encoding.#ctor">
374 <summary>初始化 <see cref="T:System.Text.UTF32Encoding" /> 類別的新執行個體。</summary>
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>
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>
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>
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>
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>
420 <member name="M:System.Text.UTF32Encoding.GetByteCount(System.String)">
421 <summary>計算將指定 <see cref="T:System.String" /> 中的字元編碼所產生的位元組數目。</summary>
422 <returns>編碼指定字元所產生的位元組數。</returns>
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>
432 <member name="M:System.Text.UTF32Encoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
433 <summary>將起始於指定字元指標的一組字元編碼成位元組序列;儲存該位元組序列時,係以指定的位元組指標為起始點。</summary>
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>
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>
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>
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>
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>
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>
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>
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>
539 <member name="M:System.Text.UTF32Encoding.GetDecoder">
540 <summary>取得可以將以 UTF-32 編碼的位元組序列轉換成 Unicode 字元序列的解碼器。</summary>
542 <see cref="T:System.Text.Decoder" />,可以將以 UTF-32 編碼的位元組序列轉換成 Unicode 字元序列。</returns>
543 <filterpriority>1</filterpriority>
545 <member name="M:System.Text.UTF32Encoding.GetEncoder">
546 <summary>取得可以將 Unicode 字元序列轉換成以 UTF-32 編碼的位元組序列的編碼器。</summary>
548 <see cref="T:System.Text.Encoder" />,可以將 Unicode 字元序列轉換成以 UTF-32 編碼的位元組序列。</returns>
549 <filterpriority>1</filterpriority>
551 <member name="M:System.Text.UTF32Encoding.GetHashCode">
552 <summary>傳回目前執行個體的雜湊碼。</summary>
553 <returns>目前 <see cref="T:System.Text.UTF32Encoding" /> 物件的雜湊碼。</returns>
554 <filterpriority>1</filterpriority>
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>
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>
574 <member name="M:System.Text.UTF32Encoding.GetPreamble">
575 <summary>如果這個執行個體的建構函式要求位元組順序標記,則會傳回以 UTF-32 格式編碼的 Unicode 位元組順序標記。</summary>
576 <returns>如果這個執行個體的建構函式要求位元組順序標記,則為包含 Unicode 位元組順序標記的位元組陣列。否則,這個方法會傳回長度為零的位元組陣列。</returns>
577 <filterpriority>1</filterpriority>
579 <member name="M:System.Text.UTF32Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
580 <summary>將位元組陣列中的某一段位元組範圍解碼成字串。</summary>
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>
594 <member name="T:System.Text.UTF7Encoding">
595 <summary>表示 Unicode 字元的 UTF-7 編碼方式。</summary>
596 <filterpriority>1</filterpriority>
598 <member name="M:System.Text.UTF7Encoding.#ctor">
599 <summary>初始化 <see cref="T:System.Text.UTF7Encoding" /> 類別的新執行個體。</summary>
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>
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>
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>
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>
636 <member name="M:System.Text.UTF7Encoding.GetByteCount(System.String)">
637 <summary>在指定的 <see cref="T:System.String" /> 物件中計算字元進行編碼後所產生的位元組數目。</summary>
638 <returns>編碼指定字元所產生的位元組數。</returns>
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>
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>
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>
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>
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>
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>
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>
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>
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>
753 <member name="M:System.Text.UTF7Encoding.GetDecoder">
754 <summary>取得可以將以 UTF-7 編碼的位元組序列轉換成 Unicode 字元序列的解碼器。</summary>
756 <see cref="T:System.Text.Decoder" />,可以將以 UTF-7 編碼的位元組序列轉換成 Unicode 字元序列。</returns>
757 <filterpriority>1</filterpriority>
759 <member name="M:System.Text.UTF7Encoding.GetEncoder">
760 <summary>取得可以將 Unicode 字元序列轉換成以 UTF-7 編碼的位元組序列的編碼器。</summary>
762 <see cref="T:System.Text.Encoder" />,可以將 Unicode 字元序列轉換成以 UTF-7 編碼的位元組序列。</returns>
763 <filterpriority>1</filterpriority>
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>
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>
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>
788 <member name="M:System.Text.UTF7Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
789 <summary>將位元組陣列中的某一段位元組範圍解碼成字串。</summary>
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>
802 <member name="T:System.Text.UTF8Encoding">
803 <summary>代表 Unicode 字元的 UTF-8 編碼方式。</summary>
804 <filterpriority>1</filterpriority>
806 <member name="M:System.Text.UTF8Encoding.#ctor">
807 <summary>初始化 <see cref="T:System.Text.UTF8Encoding" /> 類別的新執行個體。</summary>
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>
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>
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>
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>
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>
851 <member name="M:System.Text.UTF8Encoding.GetByteCount(System.String)">
852 <summary>計算將指定 <see cref="T:System.String" /> 中的字元編碼所產生的位元組數目。</summary>
853 <returns>編碼指定字元所產生的位元組數。</returns>
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>
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>
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>
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>
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>
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>
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>
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>
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>
969 <member name="M:System.Text.UTF8Encoding.GetDecoder">
970 <summary>取得可以將以 UTF-8 編碼的位元組序列轉換成 Unicode 字元序列的解碼器。</summary>
971 <returns>可以將以 UTF-8 編碼的位元組序列轉換成 Unicode 字元序列的解碼器。</returns>
972 <filterpriority>1</filterpriority>
974 <member name="M:System.Text.UTF8Encoding.GetEncoder">
975 <summary>取得可以將 Unicode 字元序列轉換成以 UTF-8 編碼的位元組序列的編碼器。</summary>
977 <see cref="T:System.Text.Encoder" />,可以將 Unicode 字元序列轉換成以 UTF-8 編碼的位元組序列。</returns>
978 <filterpriority>1</filterpriority>
980 <member name="M:System.Text.UTF8Encoding.GetHashCode">
981 <summary>傳回目前執行個體的雜湊碼。</summary>
982 <returns>目前執行個體的雜湊碼。</returns>
983 <filterpriority>1</filterpriority>
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>
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>
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>
1008 <member name="M:System.Text.UTF8Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
1009 <summary>將位元組陣列中的某一段位元組範圍解碼成字串。</summary>
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>