1 <?xml version="1.0" encoding="utf-8"?>
4 <name>System.Text.Encoding.Extensions</name>
7 <member name="T:System.Text.ASCIIEncoding">
8 <summary>Represents an ASCII character encoding of Unicode characters.</summary>
10 <member name="M:System.Text.ASCIIEncoding.#ctor">
11 <summary>Initializes a new instance of the <see cref="T:System.Text.ASCIIEncoding" /> class.</summary>
13 <member name="M:System.Text.ASCIIEncoding.GetByteCount(System.Char*,System.Int32)">
14 <summary>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</summary>
15 <param name="chars">A pointer to the first character to encode.</param>
16 <param name="count">The number of characters to encode.</param>
17 <exception cref="T:System.ArgumentNullException">
18 <paramref name="chars" /> is <see langword="null" />.</exception>
19 <exception cref="T:System.ArgumentOutOfRangeException">
20 <paramref name="count" /> is less than zero.
24 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
25 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
29 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
30 <returns>The number of bytes produced by encoding the specified characters.</returns>
32 <member name="M:System.Text.ASCIIEncoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
33 <summary>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</summary>
34 <param name="chars">The character array containing the set of characters to encode.</param>
35 <param name="index">The index of the first character to encode.</param>
36 <param name="count">The number of characters to encode.</param>
37 <exception cref="T:System.ArgumentNullException">
38 <paramref name="chars" /> is <see langword="null" />.</exception>
39 <exception cref="T:System.ArgumentOutOfRangeException">
40 <paramref name="index" /> or <paramref name="count" /> is less than zero.
44 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="chars" />.
48 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
49 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
53 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
54 <returns>The number of bytes produced by encoding the specified characters.</returns>
56 <member name="M:System.Text.ASCIIEncoding.GetByteCount(System.ReadOnlySpan{System.Char})">
57 <summary>Calculates the number of bytes produced by encoding the specified character span.</summary>
58 <param name="chars">The span that contains the set of characters to encode.</param>
59 <returns>The number of bytes produced by encoding the specified character span.</returns>
61 <member name="M:System.Text.ASCIIEncoding.GetByteCount(System.String)">
62 <summary>Calculates the number of bytes produced by encoding the characters in the specified <see cref="T:System.String" />.</summary>
63 <param name="chars">The <see cref="T:System.String" /> containing the set of characters to encode.</param>
64 <exception cref="T:System.ArgumentNullException">
65 <paramref name="chars" /> is <see langword="null" />.</exception>
66 <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
67 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
71 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
72 <returns>The number of bytes produced by encoding the specified characters.</returns>
74 <member name="M:System.Text.ASCIIEncoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
75 <summary>Encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.</summary>
76 <param name="chars">A pointer to the first character to encode.</param>
77 <param name="charCount">The number of characters to encode.</param>
78 <param name="bytes">A pointer to the location at which to start writing the resulting sequence of bytes.</param>
79 <param name="byteCount">The maximum number of bytes to write.</param>
80 <exception cref="T:System.ArgumentNullException">
81 <paramref name="chars" /> is <see langword="null" />.
85 <paramref name="bytes" /> is <see langword="null" />.</exception>
86 <exception cref="T:System.ArgumentOutOfRangeException">
87 <paramref name="charCount" /> or <paramref name="byteCount" /> is less than zero.</exception>
88 <exception cref="T:System.ArgumentException">
89 <paramref name="byteCount" /> is less than the resulting number of bytes.</exception>
90 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
94 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
95 <returns>The actual number of bytes written at the location indicated by <paramref name="bytes" />.</returns>
97 <member name="M:System.Text.ASCIIEncoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
98 <summary>Encodes a set of characters from the specified character array into the specified byte array.</summary>
99 <param name="chars">The character array containing the set of characters to encode.</param>
100 <param name="charIndex">The index of the first character to encode.</param>
101 <param name="charCount">The number of characters to encode.</param>
102 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
103 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
104 <exception cref="T:System.ArgumentNullException">
105 <paramref name="chars" /> is <see langword="null" />.
109 <paramref name="bytes" /> is <see langword="null" />.</exception>
110 <exception cref="T:System.ArgumentOutOfRangeException">
111 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
115 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
119 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
120 <exception cref="T:System.ArgumentException">
121 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
122 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
126 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
127 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
129 <member name="M:System.Text.ASCIIEncoding.GetBytes(System.ReadOnlySpan{System.Char},System.Span{System.Byte})">
130 <summary>Encodes the specified character span into the specified byte span.</summary>
131 <param name="chars">The character span to encode.</param>
132 <param name="bytes">The span to contain the resulting set of bytes.</param>
133 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
135 <member name="M:System.Text.ASCIIEncoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
136 <summary>Encodes a set of characters from the specified <see cref="T:System.String" /> into the specified byte array.</summary>
137 <param name="chars">The <see cref="T:System.String" /> containing the set of characters to encode.</param>
138 <param name="charIndex">The index of the first character to encode.</param>
139 <param name="charCount">The number of characters to encode.</param>
140 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
141 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
142 <exception cref="T:System.ArgumentNullException">
143 <paramref name="s" /> is <see langword="null" />.
147 <paramref name="bytes" /> is <see langword="null" />.</exception>
148 <exception cref="T:System.ArgumentOutOfRangeException">
149 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
153 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
157 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
158 <exception cref="T:System.ArgumentException">
159 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
160 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
164 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
165 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
167 <member name="M:System.Text.ASCIIEncoding.GetCharCount(System.Byte*,System.Int32)">
168 <summary>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</summary>
169 <param name="bytes">A pointer to the first byte to decode.</param>
170 <param name="count">The number of bytes to decode.</param>
171 <exception cref="T:System.ArgumentNullException">
172 <paramref name="bytes" /> is <see langword="null" />.</exception>
173 <exception cref="T:System.ArgumentOutOfRangeException">
174 <paramref name="count" /> is less than zero.
178 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
179 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
183 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
184 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
186 <member name="M:System.Text.ASCIIEncoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
187 <summary>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</summary>
188 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
189 <param name="index">The index of the first byte to decode.</param>
190 <param name="count">The number of bytes to decode.</param>
191 <exception cref="T:System.ArgumentNullException">
192 <paramref name="bytes" /> is <see langword="null" />.</exception>
193 <exception cref="T:System.ArgumentOutOfRangeException">
194 <paramref name="index" /> or <paramref name="count" /> is less than zero.
198 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.
202 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
203 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
207 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
208 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
210 <member name="M:System.Text.ASCIIEncoding.GetCharCount(System.ReadOnlySpan{System.Byte})">
211 <summary>Calculates the number of characters produced by decoding the specified byte span.</summary>
212 <param name="bytes">The span containing the set of bytes to decode.</param>
213 <returns>The number of characters produced by decoding the specified byte span.</returns>
215 <member name="M:System.Text.ASCIIEncoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
216 <summary>Decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.</summary>
217 <param name="bytes">A pointer to the first byte to decode.</param>
218 <param name="byteCount">The number of bytes to decode.</param>
219 <param name="chars">A pointer to the location at which to start writing the resulting set of characters.</param>
220 <param name="charCount">The maximum number of characters to write.</param>
221 <exception cref="T:System.ArgumentNullException">
222 <paramref name="bytes" /> is <see langword="null" />.
226 <paramref name="chars" /> is <see langword="null" />.</exception>
227 <exception cref="T:System.ArgumentOutOfRangeException">
228 <paramref name="byteCount" /> or <paramref name="charCount" /> is less than zero.</exception>
229 <exception cref="T:System.ArgumentException">
230 <paramref name="charCount" /> is less than the resulting number of characters.</exception>
231 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
235 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
236 <returns>The actual number of characters written at the location indicated by <paramref name="chars" />.</returns>
238 <member name="M:System.Text.ASCIIEncoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
239 <summary>Decodes a sequence of bytes from the specified byte array into the specified character array.</summary>
240 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
241 <param name="byteIndex">The index of the first byte to decode.</param>
242 <param name="byteCount">The number of bytes to decode.</param>
243 <param name="chars">The character array to contain the resulting set of characters.</param>
244 <param name="charIndex">The index at which to start writing the resulting set of characters.</param>
245 <exception cref="T:System.ArgumentNullException">
246 <paramref name="bytes" /> is <see langword="null" />.
250 <paramref name="chars" /> is <see langword="null" />.</exception>
251 <exception cref="T:System.ArgumentOutOfRangeException">
252 <paramref name="byteIndex" /> or <paramref name="byteCount" /> or <paramref name="charIndex" /> is less than zero.
256 <paramref name="byteindex" /> and <paramref name="byteCount" /> do not denote a valid range in <paramref name="bytes" />.
260 <paramref name="charIndex" /> is not a valid index in <paramref name="chars" />.</exception>
261 <exception cref="T:System.ArgumentException">
262 <paramref name="chars" /> does not have enough capacity from <paramref name="charIndex" /> to the end of the array to accommodate the resulting characters.</exception>
263 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
267 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
268 <returns>The actual number of characters written into <paramref name="chars" />.</returns>
270 <member name="M:System.Text.ASCIIEncoding.GetChars(System.ReadOnlySpan{System.Byte},System.Span{System.Char})">
271 <summary>Decodes the specified byte span into the specified character span.</summary>
272 <param name="bytes">The span containing the bytes to decode.</param>
273 <param name="chars">The span to contain the resulting set of characters.</param>
274 <returns>The actual number of characters written into <paramref name="chars" />.</returns>
276 <member name="M:System.Text.ASCIIEncoding.GetDecoder">
277 <summary>Obtains a decoder that converts an ASCII encoded sequence of bytes into a sequence of Unicode characters.</summary>
278 <returns>A <see cref="T:System.Text.Decoder" /> that converts an ASCII encoded sequence of bytes into a sequence of Unicode characters.</returns>
280 <member name="M:System.Text.ASCIIEncoding.GetEncoder">
281 <summary>Obtains an encoder that converts a sequence of Unicode characters into an ASCII encoded sequence of bytes.</summary>
282 <returns>An <see cref="T:System.Text.Encoder" /> that converts a sequence of Unicode characters into an ASCII encoded sequence of bytes.</returns>
284 <member name="M:System.Text.ASCIIEncoding.GetMaxByteCount(System.Int32)">
285 <summary>Calculates the maximum number of bytes produced by encoding the specified number of characters.</summary>
286 <param name="charCount">The number of characters to encode.</param>
287 <exception cref="T:System.ArgumentOutOfRangeException">
288 <paramref name="charCount" /> is less than zero.
292 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
293 <returns>The maximum number of bytes produced by encoding the specified number of characters.</returns>
295 <member name="M:System.Text.ASCIIEncoding.GetMaxCharCount(System.Int32)">
296 <summary>Calculates the maximum number of characters produced by decoding the specified number of bytes.</summary>
297 <param name="byteCount">The number of bytes to decode.</param>
298 <exception cref="T:System.ArgumentOutOfRangeException">
299 <paramref name="byteCount" /> is less than zero.
303 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
304 <returns>The maximum number of characters produced by decoding the specified number of bytes.</returns>
306 <member name="M:System.Text.ASCIIEncoding.GetString(System.Byte[],System.Int32,System.Int32)">
307 <summary>Decodes a range of bytes from a byte array into a string.</summary>
308 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
309 <param name="byteIndex">The index of the first byte to decode.</param>
310 <param name="byteCount">The number of bytes to decode.</param>
311 <exception cref="T:System.ArgumentNullException">
312 <paramref name="bytes" /> is <see langword="null" />.</exception>
313 <exception cref="T:System.ArgumentOutOfRangeException">
314 <paramref name="index" /> or <paramref name="count" /> is less than zero.
318 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.</exception>
319 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
323 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
324 <returns>A <see cref="T:System.String" /> containing the results of decoding the specified sequence of bytes.</returns>
326 <member name="P:System.Text.ASCIIEncoding.IsSingleByte">
327 <summary>Gets a value indicating whether the current encoding uses single-byte code points.</summary>
328 <returns>This property is always <see langword="true" />.</returns>
330 <member name="T:System.Text.UnicodeEncoding">
331 <summary>Represents a UTF-16 encoding of Unicode characters.</summary>
333 <member name="F:System.Text.UnicodeEncoding.CharSize">
334 <summary>Represents the Unicode character size in bytes. This field is a constant.</summary>
336 <member name="M:System.Text.UnicodeEncoding.#ctor">
337 <summary>Initializes a new instance of the <see cref="T:System.Text.UnicodeEncoding" /> class.</summary>
339 <member name="M:System.Text.UnicodeEncoding.#ctor(System.Boolean,System.Boolean)">
340 <summary>Initializes a new instance of the <see cref="T:System.Text.UnicodeEncoding" /> class. Parameters specify whether to use the big endian byte order and whether the <see cref="M:System.Text.UnicodeEncoding.GetPreamble" /> method returns a Unicode byte order mark.</summary>
341 <param name="bigEndian">
342 <see langword="true" /> to use the big endian byte order (most significant byte first), or <see langword="false" /> to use the little endian byte order (least significant byte first).</param>
343 <param name="byteOrderMark">
344 <see langword="true" /> to specify that the <see cref="M:System.Text.UnicodeEncoding.GetPreamble" /> method returns a Unicode byte order mark; otherwise, <see langword="false" />.</param>
346 <member name="M:System.Text.UnicodeEncoding.#ctor(System.Boolean,System.Boolean,System.Boolean)">
347 <summary>Initializes a new instance of the <see cref="T:System.Text.UnicodeEncoding" /> class. Parameters specify whether to use the big endian byte order, whether to provide a Unicode byte order mark, and whether to throw an exception when an invalid encoding is detected.</summary>
348 <param name="bigEndian">
349 <see langword="true" /> to use the big endian byte order (most significant byte first); <see langword="false" /> to use the little endian byte order (least significant byte first).</param>
350 <param name="byteOrderMark">
351 <see langword="true" /> to specify that the <see cref="M:System.Text.UnicodeEncoding.GetPreamble" /> method returns a Unicode byte order mark; otherwise, <see langword="false" />.</param>
352 <param name="throwOnInvalidBytes">
353 <see langword="true" /> to specify that an exception should be thrown when an invalid encoding is detected; otherwise, <see langword="false" />.</param>
355 <member name="M:System.Text.UnicodeEncoding.Equals(System.Object)">
356 <summary>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Text.UnicodeEncoding" /> object.</summary>
357 <param name="value">The object to compare with the current object.</param>
359 <see langword="true" /> if <paramref name="value" /> is an instance of <see cref="T:System.Text.UnicodeEncoding" /> and is equal to the current object; otherwise, <see langword="false" />.</returns>
361 <member name="M:System.Text.UnicodeEncoding.GetByteCount(System.Char*,System.Int32)">
362 <summary>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</summary>
363 <param name="chars">A pointer to the first character to encode.</param>
364 <param name="count">The number of characters to encode.</param>
365 <exception cref="T:System.ArgumentNullException">
366 <paramref name="chars" /> is <see langword="null" />.</exception>
367 <exception cref="T:System.ArgumentOutOfRangeException">
368 <paramref name="count" /> is less than zero.
372 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
373 <exception cref="T:System.ArgumentException">Error detection is enabled and <paramref name="chars" /> contains an invalid sequence of characters.</exception>
374 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
378 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
379 <returns>The number of bytes produced by encoding the specified characters.</returns>
381 <member name="M:System.Text.UnicodeEncoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
382 <summary>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</summary>
383 <param name="chars">The character array containing the set of characters to encode.</param>
384 <param name="index">The index of the first character to encode.</param>
385 <param name="count">The number of characters to encode.</param>
386 <exception cref="T:System.ArgumentNullException">
387 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
388 <exception cref="T:System.ArgumentOutOfRangeException">
389 <paramref name="index" /> or <paramref name="count" /> is less than zero.
393 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="chars" />.
397 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
398 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.</exception>
399 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
403 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
404 <returns>The number of bytes produced by encoding the specified characters.</returns>
406 <member name="M:System.Text.UnicodeEncoding.GetByteCount(System.String)">
407 <summary>Calculates the number of bytes produced by encoding the characters in the specified string.</summary>
408 <param name="s">The string that contains the set of characters to encode.</param>
409 <exception cref="T:System.ArgumentNullException">
410 <paramref name="s" /> is <see langword="null" />.</exception>
411 <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
412 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s" /> contains an invalid sequence of characters.</exception>
413 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
417 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
418 <returns>The number of bytes produced by encoding the specified characters.</returns>
420 <member name="M:System.Text.UnicodeEncoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
421 <summary>Encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.</summary>
422 <param name="chars">A pointer to the first character to encode.</param>
423 <param name="charCount">The number of characters to encode.</param>
424 <param name="bytes">A pointer to the location at which to start writing the resulting sequence of bytes.</param>
425 <param name="byteCount">The maximum number of bytes to write.</param>
426 <exception cref="T:System.ArgumentNullException">
427 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).
431 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
432 <exception cref="T:System.ArgumentOutOfRangeException">
433 <paramref name="charCount" /> or <paramref name="byteCount" /> is less than zero.</exception>
434 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.
438 <paramref name="byteCount" /> is less than the resulting number of bytes.</exception>
439 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
443 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
444 <returns>The actual number of bytes written at the location indicated by the <paramref name="bytes" /> parameter.</returns>
446 <member name="M:System.Text.UnicodeEncoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
447 <summary>Encodes a set of characters from the specified character array into the specified byte array.</summary>
448 <param name="chars">The character array containing the set of characters to encode.</param>
449 <param name="charIndex">The index of the first character to encode.</param>
450 <param name="charCount">The number of characters to encode.</param>
451 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
452 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
453 <exception cref="T:System.ArgumentNullException">
454 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).
458 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
459 <exception cref="T:System.ArgumentOutOfRangeException">
460 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
464 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
468 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
469 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.
473 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
474 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
478 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
479 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
481 <member name="M:System.Text.UnicodeEncoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
482 <summary>Encodes a set of characters from the specified <see cref="T:System.String" /> into the specified byte array.</summary>
483 <param name="s">The string containing the set of characters to encode.</param>
484 <param name="charIndex">The index of the first character to encode.</param>
485 <param name="charCount">The number of characters to encode.</param>
486 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
487 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
488 <exception cref="T:System.ArgumentNullException">
489 <paramref name="s" /> is <see langword="null" />.
493 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
494 <exception cref="T:System.ArgumentOutOfRangeException">
495 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
499 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
503 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
504 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s" /> contains an invalid sequence of characters.
508 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
509 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
513 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
514 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
516 <member name="M:System.Text.UnicodeEncoding.GetCharCount(System.Byte*,System.Int32)">
517 <summary>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</summary>
518 <param name="bytes">A pointer to the first byte to decode.</param>
519 <param name="count">The number of bytes to decode.</param>
520 <exception cref="T:System.ArgumentNullException">
521 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
522 <exception cref="T:System.ArgumentOutOfRangeException">
523 <paramref name="count" /> is less than zero.
527 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
528 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
529 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
533 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
534 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
536 <member name="M:System.Text.UnicodeEncoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
537 <summary>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</summary>
538 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
539 <param name="index">The index of the first byte to decode.</param>
540 <param name="count">The number of bytes to decode.</param>
541 <exception cref="T:System.ArgumentNullException">
542 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
543 <exception cref="T:System.ArgumentOutOfRangeException">
544 <paramref name="index" /> or <paramref name="count" /> is less than zero.
548 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.
552 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
553 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
554 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
558 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
559 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
561 <member name="M:System.Text.UnicodeEncoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
562 <summary>Decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.</summary>
563 <param name="bytes">A pointer to the first byte to decode.</param>
564 <param name="byteCount">The number of bytes to decode.</param>
565 <param name="chars">A pointer to the location at which to start writing the resulting set of characters.</param>
566 <param name="charCount">The maximum number of characters to write.</param>
567 <exception cref="T:System.ArgumentNullException">
568 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).
572 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
573 <exception cref="T:System.ArgumentOutOfRangeException">
574 <paramref name="byteCount" /> or <paramref name="charCount" /> is less than zero.</exception>
575 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.
579 <paramref name="charCount" /> is less than the resulting number of characters.</exception>
580 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
584 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
585 <returns>The actual number of characters written at the location indicated by the <paramref name="chars" /> parameter.</returns>
587 <member name="M:System.Text.UnicodeEncoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
588 <summary>Decodes a sequence of bytes from the specified byte array into the specified character array.</summary>
589 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
590 <param name="byteIndex">The index of the first byte to decode.</param>
591 <param name="byteCount">The number of bytes to decode.</param>
592 <param name="chars">The character array to contain the resulting set of characters.</param>
593 <param name="charIndex">The index at which to start writing the resulting set of characters.</param>
594 <exception cref="T:System.ArgumentNullException">
595 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).
599 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
600 <exception cref="T:System.ArgumentOutOfRangeException">
601 <paramref name="byteIndex" /> or <paramref name="byteCount" /> or <paramref name="charIndex" /> is less than zero.
605 <paramref name="byteindex" /> and <paramref name="byteCount" /> do not denote a valid range in <paramref name="bytes" />.
609 <paramref name="charIndex" /> is not a valid index in <paramref name="chars" />.</exception>
610 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.
614 <paramref name="chars" /> does not have enough capacity from <paramref name="charIndex" /> to the end of the array to accommodate the resulting characters.</exception>
615 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
619 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
620 <returns>The actual number of characters written into <paramref name="chars" />.</returns>
622 <member name="M:System.Text.UnicodeEncoding.GetDecoder">
623 <summary>Obtains a decoder that converts a UTF-16 encoded sequence of bytes into a sequence of Unicode characters.</summary>
624 <returns>A <see cref="T:System.Text.Decoder" /> that converts a UTF-16 encoded sequence of bytes into a sequence of Unicode characters.</returns>
626 <member name="M:System.Text.UnicodeEncoding.GetEncoder">
627 <summary>Obtains an encoder that converts a sequence of Unicode characters into a UTF-16 encoded sequence of bytes.</summary>
628 <returns>A <see cref="T:System.Text.Encoder" /> object that converts a sequence of Unicode characters into a UTF-16 encoded sequence of bytes.</returns>
630 <member name="M:System.Text.UnicodeEncoding.GetHashCode">
631 <summary>Returns the hash code for the current instance.</summary>
632 <returns>The hash code for the current <see cref="T:System.Text.UnicodeEncoding" /> object.</returns>
634 <member name="M:System.Text.UnicodeEncoding.GetMaxByteCount(System.Int32)">
635 <summary>Calculates the maximum number of bytes produced by encoding the specified number of characters.</summary>
636 <param name="charCount">The number of characters to encode.</param>
637 <exception cref="T:System.ArgumentOutOfRangeException">
638 <paramref name="charCount" /> is less than zero.
642 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
643 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
647 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
648 <returns>The maximum number of bytes produced by encoding the specified number of characters.</returns>
650 <member name="M:System.Text.UnicodeEncoding.GetMaxCharCount(System.Int32)">
651 <summary>Calculates the maximum number of characters produced by decoding the specified number of bytes.</summary>
652 <param name="byteCount">The number of bytes to decode.</param>
653 <exception cref="T:System.ArgumentOutOfRangeException">
654 <paramref name="byteCount" /> is less than zero.
658 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
659 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
663 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
664 <returns>The maximum number of characters produced by decoding the specified number of bytes.</returns>
666 <member name="M:System.Text.UnicodeEncoding.GetPreamble">
667 <summary>Returns a Unicode byte order mark encoded in UTF-16 format, if the constructor for this instance requests a byte order mark.</summary>
668 <returns>A byte array containing the Unicode byte order mark, if the <see cref="T:System.Text.UnicodeEncoding" /> object is configured to supply one. Otherwise, this method returns a zero-length byte array.</returns>
670 <member name="M:System.Text.UnicodeEncoding.GetString(System.Byte[],System.Int32,System.Int32)">
671 <summary>Decodes a range of bytes from a byte array into a string.</summary>
672 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
673 <param name="index">The index of the first byte to decode.</param>
674 <param name="count">The number of bytes to decode.</param>
675 <exception cref="T:System.ArgumentNullException">
676 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
677 <exception cref="T:System.ArgumentOutOfRangeException">
678 <paramref name="index" /> or <paramref name="count" /> is less than zero.
682 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.</exception>
683 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
684 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
688 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
689 <returns>A <see cref="T:System.String" /> object containing the results of decoding the specified sequence of bytes.</returns>
691 <member name="P:System.Text.UnicodeEncoding.Preamble">
692 <summary>Gets a Unicode byte order mark encoded in UTF-16 format, if this object is configured to supply one.</summary>
693 <returns>A byte span containing the Unicode byte order mark, if this object is configured to supply one; otherwise, the default span.</returns>
695 <member name="T:System.Text.UTF32Encoding">
696 <summary>Represents a UTF-32 encoding of Unicode characters.</summary>
698 <member name="M:System.Text.UTF32Encoding.#ctor">
699 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF32Encoding" /> class.</summary>
701 <member name="M:System.Text.UTF32Encoding.#ctor(System.Boolean,System.Boolean)">
702 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF32Encoding" /> class. Parameters specify whether to use the big endian byte order and whether the <see cref="M:System.Text.UTF32Encoding.GetPreamble" /> method returns a Unicode byte order mark.</summary>
703 <param name="bigEndian">
704 <see langword="true" /> to use the big endian byte order (most significant byte first), or <see langword="false" /> to use the little endian byte order (least significant byte first).</param>
705 <param name="byteOrderMark">
706 <see langword="true" /> to specify that a Unicode byte order mark is provided; otherwise, <see langword="false" />.</param>
708 <member name="M:System.Text.UTF32Encoding.#ctor(System.Boolean,System.Boolean,System.Boolean)">
709 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF32Encoding" /> class. Parameters specify whether to use the big endian byte order, whether to provide a Unicode byte order mark, and whether to throw an exception when an invalid encoding is detected.</summary>
710 <param name="bigEndian">
711 <see langword="true" /> to use the big endian byte order (most significant byte first), or <see langword="false" /> to use the little endian byte order (least significant byte first).</param>
712 <param name="byteOrderMark">
713 <see langword="true" /> to specify that a Unicode byte order mark is provided; otherwise, <see langword="false" />.</param>
714 <param name="throwOnInvalidCharacters">
715 <see langword="true" /> to specify that an exception should be thrown when an invalid encoding is detected; otherwise, <see langword="false" />.</param>
717 <member name="M:System.Text.UTF32Encoding.Equals(System.Object)">
718 <summary>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Text.UTF32Encoding" /> object.</summary>
719 <param name="value">The <see cref="T:System.Object" /> to compare with the current object.</param>
721 <see langword="true" /> if <paramref name="value" /> is an instance of <see cref="T:System.Text.UTF32Encoding" /> and is equal to the current object; otherwise, <see langword="false" />.</returns>
723 <member name="M:System.Text.UTF32Encoding.GetByteCount(System.Char*,System.Int32)">
724 <summary>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</summary>
725 <param name="chars">A pointer to the first character to encode.</param>
726 <param name="count">The number of characters to encode.</param>
727 <exception cref="T:System.ArgumentNullException">
728 <paramref name="chars" /> is <see langword="null" />.</exception>
729 <exception cref="T:System.ArgumentOutOfRangeException">
730 <paramref name="count" /> is less than zero.
734 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
735 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.</exception>
736 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
740 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
741 <returns>The number of bytes produced by encoding the specified characters.</returns>
743 <member name="M:System.Text.UTF32Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
744 <summary>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</summary>
745 <param name="chars">The character array containing the set of characters to encode.</param>
746 <param name="index">The index of the first character to encode.</param>
747 <param name="count">The number of characters to encode.</param>
748 <exception cref="T:System.ArgumentNullException">
749 <paramref name="chars" /> is <see langword="null" />.</exception>
750 <exception cref="T:System.ArgumentOutOfRangeException">
751 <paramref name="index" /> or <paramref name="count" /> is less than zero.
755 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="chars" />.
759 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
760 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.</exception>
761 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
765 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
766 <returns>The number of bytes produced by encoding the specified characters.</returns>
768 <member name="M:System.Text.UTF32Encoding.GetByteCount(System.String)">
769 <summary>Calculates the number of bytes produced by encoding the characters in the specified <see cref="T:System.String" />.</summary>
770 <param name="s">The <see cref="T:System.String" /> containing the set of characters to encode.</param>
771 <exception cref="T:System.ArgumentNullException">
772 <paramref name="s" /> is <see langword="null" />.</exception>
773 <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
774 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s" /> contains an invalid sequence of characters.</exception>
775 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
779 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
780 <returns>The number of bytes produced by encoding the specified characters.</returns>
782 <member name="M:System.Text.UTF32Encoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
783 <summary>Encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.</summary>
784 <param name="chars">A pointer to the first character to encode.</param>
785 <param name="charCount">The number of characters to encode.</param>
786 <param name="bytes">A pointer to the location at which to start writing the resulting sequence of bytes.</param>
787 <param name="byteCount">The maximum number of bytes to write.</param>
788 <exception cref="T:System.ArgumentNullException">
789 <paramref name="chars" /> is <see langword="null" />.
793 <paramref name="bytes" /> is <see langword="null" />.</exception>
794 <exception cref="T:System.ArgumentOutOfRangeException">
795 <paramref name="charCount" /> or <paramref name="byteCount" /> is less than zero.</exception>
796 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.
800 <paramref name="byteCount" /> is less than the resulting number of bytes.</exception>
801 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
805 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
806 <returns>The actual number of bytes written at the location indicated by the <paramref name="bytes" /> parameter.</returns>
808 <member name="M:System.Text.UTF32Encoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
809 <summary>Encodes a set of characters from the specified character array into the specified byte array.</summary>
810 <param name="chars">The character array containing the set of characters to encode.</param>
811 <param name="charIndex">The index of the first character to encode.</param>
812 <param name="charCount">The number of characters to encode.</param>
813 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
814 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
815 <exception cref="T:System.ArgumentNullException">
816 <paramref name="chars" /> is <see langword="null" />.
820 <paramref name="bytes" /> is <see langword="null" />.</exception>
821 <exception cref="T:System.ArgumentOutOfRangeException">
822 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
826 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
830 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
831 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.
835 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
836 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
840 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
841 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
843 <member name="M:System.Text.UTF32Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
844 <summary>Encodes a set of characters from the specified <see cref="T:System.String" /> into the specified byte array.</summary>
845 <param name="s">The <see cref="T:System.String" /> containing the set of characters to encode.</param>
846 <param name="charIndex">The index of the first character to encode.</param>
847 <param name="charCount">The number of characters to encode.</param>
848 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
849 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
850 <exception cref="T:System.ArgumentNullException">
851 <paramref name="s" /> is <see langword="null" />.
855 <paramref name="bytes" /> is <see langword="null" />.</exception>
856 <exception cref="T:System.ArgumentOutOfRangeException">
857 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
861 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
865 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
866 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s" /> contains an invalid sequence of characters.
870 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
871 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
875 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
876 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
878 <member name="M:System.Text.UTF32Encoding.GetCharCount(System.Byte*,System.Int32)">
879 <summary>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</summary>
880 <param name="bytes">A pointer to the first byte to decode.</param>
881 <param name="count">The number of bytes to decode.</param>
882 <exception cref="T:System.ArgumentNullException">
883 <paramref name="bytes" /> is <see langword="null" />.</exception>
884 <exception cref="T:System.ArgumentOutOfRangeException">
885 <paramref name="count" /> is less than zero.
889 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
890 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
891 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
895 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
896 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
898 <member name="M:System.Text.UTF32Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
899 <summary>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</summary>
900 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
901 <param name="index">The index of the first byte to decode.</param>
902 <param name="count">The number of bytes to decode.</param>
903 <exception cref="T:System.ArgumentNullException">
904 <paramref name="bytes" /> is <see langword="null" />.</exception>
905 <exception cref="T:System.ArgumentOutOfRangeException">
906 <paramref name="index" /> or <paramref name="count" /> is less than zero.
910 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.
914 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
915 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
916 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
920 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
921 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
923 <member name="M:System.Text.UTF32Encoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
924 <summary>Decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.</summary>
925 <param name="bytes">A pointer to the first byte to decode.</param>
926 <param name="byteCount">The number of bytes to decode.</param>
927 <param name="chars">A pointer to the location at which to start writing the resulting set of characters.</param>
928 <param name="charCount">The maximum number of characters to write.</param>
929 <exception cref="T:System.ArgumentNullException">
930 <paramref name="bytes" /> is <see langword="null" />.
934 <paramref name="chars" /> is <see langword="null" />.</exception>
935 <exception cref="T:System.ArgumentOutOfRangeException">
936 <paramref name="byteCount" /> or <paramref name="charCount" /> is less than zero.</exception>
937 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.
941 <paramref name="charCount" /> is less than the resulting number of characters.</exception>
942 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
946 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
947 <returns>The actual number of characters written at the location indicated by <paramref name="chars" />.</returns>
949 <member name="M:System.Text.UTF32Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
950 <summary>Decodes a sequence of bytes from the specified byte array into the specified character array.</summary>
951 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
952 <param name="byteIndex">The index of the first byte to decode.</param>
953 <param name="byteCount">The number of bytes to decode.</param>
954 <param name="chars">The character array to contain the resulting set of characters.</param>
955 <param name="charIndex">The index at which to start writing the resulting set of characters.</param>
956 <exception cref="T:System.ArgumentNullException">
957 <paramref name="bytes" /> is <see langword="null" />.
961 <paramref name="chars" /> is <see langword="null" />.</exception>
962 <exception cref="T:System.ArgumentOutOfRangeException">
963 <paramref name="byteIndex" /> or <paramref name="byteCount" /> or <paramref name="charIndex" /> is less than zero.
967 <paramref name="byteindex" /> and <paramref name="byteCount" /> do not denote a valid range in <paramref name="bytes" />.
971 <paramref name="charIndex" /> is not a valid index in <paramref name="chars" />.</exception>
972 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.
976 <paramref name="chars" /> does not have enough capacity from <paramref name="charIndex" /> to the end of the array to accommodate the resulting characters.</exception>
977 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
981 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
982 <returns>The actual number of characters written into <paramref name="chars" />.</returns>
984 <member name="M:System.Text.UTF32Encoding.GetDecoder">
985 <summary>Obtains a decoder that converts a UTF-32 encoded sequence of bytes into a sequence of Unicode characters.</summary>
986 <returns>A <see cref="T:System.Text.Decoder" /> that converts a UTF-32 encoded sequence of bytes into a sequence of Unicode characters.</returns>
988 <member name="M:System.Text.UTF32Encoding.GetEncoder">
989 <summary>Obtains an encoder that converts a sequence of Unicode characters into a UTF-32 encoded sequence of bytes.</summary>
990 <returns>A <see cref="T:System.Text.Encoder" /> that converts a sequence of Unicode characters into a UTF-32 encoded sequence of bytes.</returns>
992 <member name="M:System.Text.UTF32Encoding.GetHashCode">
993 <summary>Returns the hash code for the current instance.</summary>
994 <returns>The hash code for the current <see cref="T:System.Text.UTF32Encoding" /> object.</returns>
996 <member name="M:System.Text.UTF32Encoding.GetMaxByteCount(System.Int32)">
997 <summary>Calculates the maximum number of bytes produced by encoding the specified number of characters.</summary>
998 <param name="charCount">The number of characters to encode.</param>
999 <exception cref="T:System.ArgumentOutOfRangeException">
1000 <paramref name="charCount" /> is less than zero.
1004 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1005 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1009 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1010 <returns>The maximum number of bytes produced by encoding the specified number of characters.</returns>
1012 <member name="M:System.Text.UTF32Encoding.GetMaxCharCount(System.Int32)">
1013 <summary>Calculates the maximum number of characters produced by decoding the specified number of bytes.</summary>
1014 <param name="byteCount">The number of bytes to decode.</param>
1015 <exception cref="T:System.ArgumentOutOfRangeException">
1016 <paramref name="byteCount" /> is less than zero.
1020 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1021 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1025 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1026 <returns>The maximum number of characters produced by decoding the specified number of bytes.</returns>
1028 <member name="M:System.Text.UTF32Encoding.GetPreamble">
1029 <summary>Returns a Unicode byte order mark encoded in UTF-32 format, if the <see cref="T:System.Text.UTF32Encoding" /> object is configured to supply one.</summary>
1030 <returns>A byte array containing the Unicode byte order mark, if the <see cref="T:System.Text.UTF32Encoding" /> object is configured to supply one. Otherwise, this method returns a zero-length byte array.</returns>
1032 <member name="M:System.Text.UTF32Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
1033 <summary>Decodes a range of bytes from a byte array into a string.</summary>
1034 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
1035 <param name="index">The index of the first byte to decode.</param>
1036 <param name="count">The number of bytes to decode.</param>
1037 <exception cref="T:System.ArgumentNullException">
1038 <paramref name="bytes" /> is <see langword="null" />.</exception>
1039 <exception cref="T:System.ArgumentOutOfRangeException">
1040 <paramref name="index" /> or <paramref name="count" /> is less than zero.
1044 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.</exception>
1045 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
1046 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in .NET for a complete explanation).
1050 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1051 <returns>A string that contains the results of decoding the specified sequence of bytes.</returns>
1053 <member name="P:System.Text.UTF32Encoding.Preamble">
1054 <summary>Gets a Unicode byte order mark encoded in UTF-32 format, if this object is configured to supply one.</summary>
1055 <returns>A byte span containing the Unicode byte order mark, if this object is configured to supply one; otherwise, a default span.</returns>
1057 <member name="T:System.Text.UTF7Encoding">
1058 <summary>Represents a UTF-7 encoding of Unicode characters.</summary>
1060 <member name="M:System.Text.UTF7Encoding.#ctor">
1061 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF7Encoding" /> class.</summary>
1063 <member name="M:System.Text.UTF7Encoding.#ctor(System.Boolean)">
1064 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF7Encoding" /> class. A parameter specifies whether to allow optional characters.</summary>
1065 <param name="allowOptionals">
1066 <see langword="true" /> to specify that optional characters are allowed; otherwise, <see langword="false" />.</param>
1068 <member name="M:System.Text.UTF7Encoding.Equals(System.Object)">
1069 <summary>Gets a value indicating whether the specified object is equal to the current <see cref="T:System.Text.UTF7Encoding" /> object.</summary>
1070 <param name="value">An object to compare to the current <see cref="T:System.Text.UTF7Encoding" /> object.</param>
1072 <see langword="true" /> if <paramref name="value" /> is a <see cref="T:System.Text.UTF7Encoding" /> object and is equal to the current <see cref="T:System.Text.UTF7Encoding" /> object; otherwise, <see langword="false" />.</returns>
1074 <member name="M:System.Text.UTF7Encoding.GetByteCount(System.Char*,System.Int32)">
1075 <summary>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</summary>
1076 <param name="chars">A pointer to the first character to encode.</param>
1077 <param name="count">The number of characters to encode.</param>
1078 <exception cref="T:System.ArgumentNullException">
1079 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" /> in Visual Basic .NET).</exception>
1080 <exception cref="T:System.ArgumentOutOfRangeException">
1081 <paramref name="count" /> is less than zero.
1085 The resulting number of bytes is greater than the maximum number that can be returned as an int.</exception>
1086 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1090 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1091 <returns>The number of bytes produced by encoding the specified characters.</returns>
1093 <member name="M:System.Text.UTF7Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
1094 <summary>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</summary>
1095 <param name="chars">The character array containing the set of characters to encode.</param>
1096 <param name="index">The index of the first character to encode.</param>
1097 <param name="count">The number of characters to encode.</param>
1098 <exception cref="T:System.ArgumentNullException">
1099 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
1100 <exception cref="T:System.ArgumentOutOfRangeException">
1101 <paramref name="index" /> or <paramref name="count" /> is less than zero.
1105 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="chars" />.
1109 The resulting number of bytes is greater than the maximum number that can be returned as an int.</exception>
1110 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1114 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1115 <returns>The number of bytes produced by encoding the specified characters.</returns>
1117 <member name="M:System.Text.UTF7Encoding.GetByteCount(System.String)">
1118 <summary>Calculates the number of bytes produced by encoding the characters in the specified <see cref="T:System.String" /> object.</summary>
1119 <param name="s">The <see cref="T:System.String" /> object containing the set of characters to encode.</param>
1120 <exception cref="T:System.ArgumentNullException">
1121 <paramref name="s" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
1122 <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an int.</exception>
1123 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in .NET for fuller explanation).
1127 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1128 <returns>The number of bytes produced by encoding the specified characters.</returns>
1130 <member name="M:System.Text.UTF7Encoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
1131 <summary>Encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.</summary>
1132 <param name="chars">A pointer to the first character to encode.</param>
1133 <param name="charCount">The number of characters to encode.</param>
1134 <param name="bytes">A pointer to the location at which to start writing the resulting sequence of bytes.</param>
1135 <param name="byteCount">The maximum number of bytes to write.</param>
1136 <exception cref="T:System.ArgumentNullException">
1137 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).
1141 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
1142 <exception cref="T:System.ArgumentOutOfRangeException">
1143 <paramref name="charCount" /> or <paramref name="byteCount" /> is less than zero.</exception>
1144 <exception cref="T:System.ArgumentException">
1145 <paramref name="byteCount" /> is less than the resulting number of bytes.</exception>
1146 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in .NET for fuller explanation).
1150 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1151 <returns>The actual number of bytes written at the location indicated by <paramref name="bytes" />.</returns>
1153 <member name="M:System.Text.UTF7Encoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
1154 <summary>Encodes a set of characters from the specified character array into the specified byte array.</summary>
1155 <param name="chars">The character array containing the set of characters to encode.</param>
1156 <param name="charIndex">The index of the first character to encode.</param>
1157 <param name="charCount">The number of characters to encode.</param>
1158 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
1159 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
1160 <exception cref="T:System.ArgumentNullException">
1161 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).
1165 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
1166 <exception cref="T:System.ArgumentOutOfRangeException">
1167 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
1171 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
1175 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
1176 <exception cref="T:System.ArgumentException">
1177 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
1178 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in .NET for fuller explanation).
1182 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1183 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
1185 <member name="M:System.Text.UTF7Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
1186 <summary>Encodes a set of characters from the specified <see cref="T:System.String" /> into the specified byte array.</summary>
1187 <param name="s">The <see cref="T:System.String" /> containing the set of characters to encode.</param>
1188 <param name="charIndex">The index of the first character to encode.</param>
1189 <param name="charCount">The number of characters to encode.</param>
1190 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
1191 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
1192 <exception cref="T:System.ArgumentNullException">
1193 <paramref name="s" /> is <see langword="null" /> (<see langword="Nothing" />).
1197 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
1198 <exception cref="T:System.ArgumentOutOfRangeException">
1199 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
1203 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
1207 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
1208 <exception cref="T:System.ArgumentException">
1209 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
1210 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in .NET for fuller explanation).
1214 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1215 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
1217 <member name="M:System.Text.UTF7Encoding.GetCharCount(System.Byte*,System.Int32)">
1218 <summary>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</summary>
1219 <param name="bytes">A pointer to the first byte to decode.</param>
1220 <param name="count">The number of bytes to decode.</param>
1221 <exception cref="T:System.ArgumentNullException">
1222 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
1223 <exception cref="T:System.ArgumentOutOfRangeException">
1224 <paramref name="count" /> is less than zero.
1228 The resulting number of characters is greater than the maximum number that can be returned as an int.</exception>
1229 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in .NET for fuller explanation).
1233 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1234 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
1236 <member name="M:System.Text.UTF7Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
1237 <summary>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</summary>
1238 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
1239 <param name="index">The index of the first byte to decode.</param>
1240 <param name="count">The number of bytes to decode.</param>
1241 <exception cref="T:System.ArgumentNullException">
1242 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
1243 <exception cref="T:System.ArgumentOutOfRangeException">
1244 <paramref name="index" /> or <paramref name="count" /> is less than zero.
1248 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.
1252 The resulting number of characters is greater than the maximum number that can be returned as an int.</exception>
1253 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1257 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1258 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
1260 <member name="M:System.Text.UTF7Encoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
1261 <summary>Decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.</summary>
1262 <param name="bytes">A pointer to the first byte to decode.</param>
1263 <param name="byteCount">The number of bytes to decode.</param>
1264 <param name="chars">A pointer to the location at which to start writing the resulting set of characters.</param>
1265 <param name="charCount">The maximum number of characters to write.</param>
1266 <exception cref="T:System.ArgumentNullException">
1267 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).
1271 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
1272 <exception cref="T:System.ArgumentOutOfRangeException">
1273 <paramref name="byteCount" /> or <paramref name="charCount" /> is less than zero.</exception>
1274 <exception cref="T:System.ArgumentException">
1275 <paramref name="charCount" /> is less than the resulting number of characters.</exception>
1276 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1280 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1281 <returns>The actual number of characters written at the location indicated by <paramref name="chars" />.</returns>
1283 <member name="M:System.Text.UTF7Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
1284 <summary>Decodes a sequence of bytes from the specified byte array into the specified character array.</summary>
1285 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
1286 <param name="byteIndex">The index of the first byte to decode.</param>
1287 <param name="byteCount">The number of bytes to decode.</param>
1288 <param name="chars">The character array to contain the resulting set of characters.</param>
1289 <param name="charIndex">The index at which to start writing the resulting set of characters.</param>
1290 <exception cref="T:System.ArgumentNullException">
1291 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).
1295 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
1296 <exception cref="T:System.ArgumentOutOfRangeException">
1297 <paramref name="byteIndex" /> or <paramref name="byteCount" /> or <paramref name="charIndex" /> is less than zero.
1301 <paramref name="byteindex" /> and <paramref name="byteCount" /> do not denote a valid range in <paramref name="bytes" />.
1305 <paramref name="charIndex" /> is not a valid index in <paramref name="chars" />.</exception>
1306 <exception cref="T:System.ArgumentException">
1307 <paramref name="chars" /> does not have enough capacity from <paramref name="charIndex" /> to the end of the array to accommodate the resulting characters.</exception>
1308 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1312 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1313 <returns>The actual number of characters written into <paramref name="chars" />.</returns>
1315 <member name="M:System.Text.UTF7Encoding.GetDecoder">
1316 <summary>Obtains a decoder that converts a UTF-7 encoded sequence of bytes into a sequence of Unicode characters.</summary>
1317 <returns>A <see cref="T:System.Text.Decoder" /> that converts a UTF-7 encoded sequence of bytes into a sequence of Unicode characters.</returns>
1319 <member name="M:System.Text.UTF7Encoding.GetEncoder">
1320 <summary>Obtains an encoder that converts a sequence of Unicode characters into a UTF-7 encoded sequence of bytes.</summary>
1321 <returns>A <see cref="T:System.Text.Encoder" /> that converts a sequence of Unicode characters into a UTF-7 encoded sequence of bytes.</returns>
1323 <member name="M:System.Text.UTF7Encoding.GetHashCode">
1324 <summary>Returns the hash code for the current <see cref="T:System.Text.UTF7Encoding" /> object.</summary>
1325 <returns>A 32-bit signed integer hash code.</returns>
1327 <member name="M:System.Text.UTF7Encoding.GetMaxByteCount(System.Int32)">
1328 <summary>Calculates the maximum number of bytes produced by encoding the specified number of characters.</summary>
1329 <param name="charCount">The number of characters to encode.</param>
1330 <exception cref="T:System.ArgumentOutOfRangeException">
1331 <paramref name="charCount" /> is less than zero.
1335 The resulting number of bytes is greater than the maximum number that can be returned as an int.</exception>
1336 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1340 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1341 <returns>The maximum number of bytes produced by encoding the specified number of characters.</returns>
1343 <member name="M:System.Text.UTF7Encoding.GetMaxCharCount(System.Int32)">
1344 <summary>Calculates the maximum number of characters produced by decoding the specified number of bytes.</summary>
1345 <param name="byteCount">The number of bytes to decode.</param>
1346 <exception cref="T:System.ArgumentOutOfRangeException">
1347 <paramref name="byteCount" /> is less than zero.
1351 The resulting number of characters is greater than the maximum number that can be returned as an int.</exception>
1352 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1356 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1357 <returns>The maximum number of characters produced by decoding the specified number of bytes.</returns>
1359 <member name="M:System.Text.UTF7Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
1360 <summary>Decodes a range of bytes from a byte array into a string.</summary>
1361 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
1362 <param name="index">The index of the first byte to decode.</param>
1363 <param name="count">The number of bytes to decode.</param>
1364 <exception cref="T:System.ArgumentNullException">
1365 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
1366 <exception cref="T:System.ArgumentOutOfRangeException">
1367 <paramref name="index" /> or <paramref name="count" /> is less than zero.
1371 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.</exception>
1372 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in .NET for fuller explanation).
1376 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1377 <returns>A <see cref="T:System.String" /> containing the results of decoding the specified sequence of bytes.</returns>
1379 <member name="T:System.Text.UTF8Encoding">
1380 <summary>Represents a UTF-8 encoding of Unicode characters.</summary>
1382 <member name="M:System.Text.UTF8Encoding.#ctor">
1383 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF8Encoding" /> class.</summary>
1385 <member name="M:System.Text.UTF8Encoding.#ctor(System.Boolean)">
1386 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF8Encoding" /> class. A parameter specifies whether to provide a Unicode byte order mark.</summary>
1387 <param name="encoderShouldEmitUTF8Identifier">
1388 <see langword="true" /> to specify that the <see cref="M:System.Text.UTF8Encoding.GetPreamble" /> method returns a Unicode byte order mark; otherwise, <see langword="false" />.</param>
1390 <member name="M:System.Text.UTF8Encoding.#ctor(System.Boolean,System.Boolean)">
1391 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF8Encoding" /> class. Parameters specify whether to provide a Unicode byte order mark and whether to throw an exception when an invalid encoding is detected.</summary>
1392 <param name="encoderShouldEmitUTF8Identifier">
1393 <see langword="true" /> to specify that the <see cref="M:System.Text.UTF8Encoding.GetPreamble" /> method should return a Unicode byte order mark; otherwise, <see langword="false" />.</param>
1394 <param name="throwOnInvalidBytes">
1395 <see langword="true" /> to throw an exception when an invalid encoding is detected; otherwise, <see langword="false" />.</param>
1397 <member name="M:System.Text.UTF8Encoding.Equals(System.Object)">
1398 <summary>Determines whether the specified object is equal to the current <see cref="T:System.Text.UTF8Encoding" /> object.</summary>
1399 <param name="value">The object to compare with the current instance.</param>
1401 <see langword="true" /> if <paramref name="value" /> is an instance of <see cref="T:System.Text.UTF8Encoding" /> and is equal to the current object; otherwise, <see langword="false" />.</returns>
1403 <member name="M:System.Text.UTF8Encoding.GetByteCount(System.Char*,System.Int32)">
1404 <summary>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</summary>
1405 <param name="chars">A pointer to the first character to encode.</param>
1406 <param name="count">The number of characters to encode.</param>
1407 <exception cref="T:System.ArgumentNullException">
1408 <paramref name="chars" /> is <see langword="null" />.</exception>
1409 <exception cref="T:System.ArgumentOutOfRangeException">
1410 <paramref name="count" /> is less than zero.
1414 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1415 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.</exception>
1416 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in .NET for a complete explanation).
1420 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1421 <returns>The number of bytes produced by encoding the specified characters.</returns>
1423 <member name="M:System.Text.UTF8Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
1424 <summary>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</summary>
1425 <param name="chars">The character array containing the set of characters to encode.</param>
1426 <param name="index">The index of the first character to encode.</param>
1427 <param name="count">The number of characters to encode.</param>
1428 <exception cref="T:System.ArgumentNullException">
1429 <paramref name="chars" /> is <see langword="null" />.</exception>
1430 <exception cref="T:System.ArgumentOutOfRangeException">
1431 <paramref name="index" /> or <paramref name="count" /> is less than zero.
1435 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="chars" />.
1439 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1440 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.</exception>
1441 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1445 The <see cref="P:System.Text.Encoding.EncoderFallback" /> property is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1446 <returns>The number of bytes produced by encoding the specified characters.</returns>
1448 <member name="M:System.Text.UTF8Encoding.GetByteCount(System.ReadOnlySpan{System.Char})">
1449 <summary>Calculates the number of bytes produced by encoding the specified character span.</summary>
1450 <param name="chars">The span that contains the set of characters to encode.</param>
1451 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.</exception>
1452 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in .NET for complete explanation).
1456 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1457 <returns>The number of bytes produced by encoding the specified character span.</returns>
1459 <member name="M:System.Text.UTF8Encoding.GetByteCount(System.String)">
1460 <summary>Calculates the number of bytes produced by encoding the characters in the specified <see cref="T:System.String" />.</summary>
1461 <param name="chars">The <see cref="T:System.String" /> containing the set of characters to encode.</param>
1462 <exception cref="T:System.ArgumentNullException">
1463 <paramref name="chars" /> is <see langword="null" />.</exception>
1464 <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1465 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.</exception>
1466 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1470 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1471 <returns>The number of bytes produced by encoding the specified characters.</returns>
1473 <member name="M:System.Text.UTF8Encoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
1474 <summary>Encodes a set of characters starting at the specified character pointer into a sequence of bytes that are stored starting at the specified byte pointer.</summary>
1475 <param name="chars">A pointer to the first character to encode.</param>
1476 <param name="charCount">The number of characters to encode.</param>
1477 <param name="bytes">A pointer to the location at which to start writing the resulting sequence of bytes.</param>
1478 <param name="byteCount">The maximum number of bytes to write.</param>
1479 <exception cref="T:System.ArgumentNullException">
1480 <paramref name="chars" /> is <see langword="null" />.
1484 <paramref name="bytes" /> is <see langword="null" />.</exception>
1485 <exception cref="T:System.ArgumentOutOfRangeException">
1486 <paramref name="charCount" /> or <paramref name="byteCount" /> is less than zero.</exception>
1487 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.
1491 <paramref name="byteCount" /> is less than the resulting number of bytes.</exception>
1492 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1496 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1497 <returns>The actual number of bytes written at the location indicated by <paramref name="bytes" />.</returns>
1499 <member name="M:System.Text.UTF8Encoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
1500 <summary>Encodes a set of characters from the specified character array into the specified byte array.</summary>
1501 <param name="chars">The character array containing the set of characters to encode.</param>
1502 <param name="charIndex">The index of the first character to encode.</param>
1503 <param name="charCount">The number of characters to encode.</param>
1504 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
1505 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
1506 <exception cref="T:System.ArgumentNullException">
1507 <paramref name="chars" /> is <see langword="null" />.
1511 <paramref name="bytes" /> is <see langword="null" />.</exception>
1512 <exception cref="T:System.ArgumentOutOfRangeException">
1513 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
1517 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
1521 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
1522 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.
1526 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
1527 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1531 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1532 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
1534 <member name="M:System.Text.UTF8Encoding.GetBytes(System.ReadOnlySpan{System.Char},System.Span{System.Byte})">
1535 <summary>Encodes the specified character span into the specified byte span.</summary>
1536 <param name="chars">The character span to encode.</param>
1537 <param name="bytes">The span to contain the resulting set of bytes.</param>
1538 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
1540 <member name="M:System.Text.UTF8Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
1541 <summary>Encodes a set of characters from the specified <see cref="T:System.String" /> into the specified byte array.</summary>
1542 <param name="s">The <see cref="T:System.String" /> containing the set of characters to encode.</param>
1543 <param name="charIndex">The index of the first character to encode.</param>
1544 <param name="charCount">The number of characters to encode.</param>
1545 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
1546 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
1547 <exception cref="T:System.ArgumentNullException">
1548 <paramref name="s" /> is <see langword="null" />.
1552 <paramref name="bytes" /> is <see langword="null" />.</exception>
1553 <exception cref="T:System.ArgumentOutOfRangeException">
1554 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
1558 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
1562 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
1563 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s" /> contains an invalid sequence of characters.
1567 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
1568 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1572 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1573 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
1575 <member name="M:System.Text.UTF8Encoding.GetCharCount(System.Byte*,System.Int32)">
1576 <summary>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</summary>
1577 <param name="bytes">A pointer to the first byte to decode.</param>
1578 <param name="count">The number of bytes to decode.</param>
1579 <exception cref="T:System.ArgumentNullException">
1580 <paramref name="bytes" /> is <see langword="null" />.</exception>
1581 <exception cref="T:System.ArgumentOutOfRangeException">
1582 <paramref name="count" /> is less than zero.
1586 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1587 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
1588 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1592 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1593 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
1595 <member name="M:System.Text.UTF8Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
1596 <summary>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</summary>
1597 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
1598 <param name="index">The index of the first byte to decode.</param>
1599 <param name="count">The number of bytes to decode.</param>
1600 <exception cref="T:System.ArgumentNullException">
1601 <paramref name="bytes" /> is <see langword="null" />.</exception>
1602 <exception cref="T:System.ArgumentOutOfRangeException">
1603 <paramref name="index" /> or <paramref name="count" /> is less than zero.
1607 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.
1611 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1612 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
1613 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1617 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1618 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
1620 <member name="M:System.Text.UTF8Encoding.GetCharCount(System.ReadOnlySpan{System.Byte})">
1621 <summary>Calculates the number of characters produced by decoding the specified byte span.</summary>
1622 <param name="bytes">The span containing the set of bytes to decode.</param>
1623 <returns>The number of characters produced by decoding the specified byte span.</returns>
1625 <member name="M:System.Text.UTF8Encoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
1626 <summary>Decodes a sequence of bytes starting at the specified byte pointer into a set of characters that are stored starting at the specified character pointer.</summary>
1627 <param name="bytes">A pointer to the first byte to decode.</param>
1628 <param name="byteCount">The number of bytes to decode.</param>
1629 <param name="chars">A pointer to the location at which to start writing the resulting set of characters.</param>
1630 <param name="charCount">The maximum number of characters to write.</param>
1631 <exception cref="T:System.ArgumentNullException">
1632 <paramref name="bytes" /> is <see langword="null" />.
1636 <paramref name="chars" /> is <see langword="null" />.</exception>
1637 <exception cref="T:System.ArgumentOutOfRangeException">
1638 <paramref name="byteCount" /> or <paramref name="charCount" /> is less than zero.</exception>
1639 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.
1643 <paramref name="charCount" /> is less than the resulting number of characters.</exception>
1644 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1648 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1649 <returns>The actual number of characters written at the location indicated by <paramref name="chars" />.</returns>
1651 <member name="M:System.Text.UTF8Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
1652 <summary>Decodes a sequence of bytes from the specified byte array into the specified character array.</summary>
1653 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
1654 <param name="byteIndex">The index of the first byte to decode.</param>
1655 <param name="byteCount">The number of bytes to decode.</param>
1656 <param name="chars">The character array to contain the resulting set of characters.</param>
1657 <param name="charIndex">The index at which to start writing the resulting set of characters.</param>
1658 <exception cref="T:System.ArgumentNullException">
1659 <paramref name="bytes" /> is <see langword="null" />.
1663 <paramref name="chars" /> is <see langword="null" />.</exception>
1664 <exception cref="T:System.ArgumentOutOfRangeException">
1665 <paramref name="byteIndex" /> or <paramref name="byteCount" /> or <paramref name="charIndex" /> is less than zero.
1669 <paramref name="byteindex" /> and <paramref name="byteCount" /> do not denote a valid range in <paramref name="bytes" />.
1673 <paramref name="charIndex" /> is not a valid index in <paramref name="chars" />.</exception>
1674 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.
1678 <paramref name="chars" /> does not have enough capacity from <paramref name="charIndex" /> to the end of the array to accommodate the resulting characters.</exception>
1679 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1683 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1684 <returns>The actual number of characters written into <paramref name="chars" />.</returns>
1686 <member name="M:System.Text.UTF8Encoding.GetChars(System.ReadOnlySpan{System.Byte},System.Span{System.Char})">
1687 <summary>Decodes the specified byte span into the specified character span.</summary>
1688 <param name="bytes">The span containing the bytes to decode.</param>
1689 <param name="chars">The span to contain the resulting set of characters.</param>
1690 <returns>The actual number of characters written into <paramref name="chars" />.</returns>
1692 <member name="M:System.Text.UTF8Encoding.GetDecoder">
1693 <summary>Obtains a decoder that converts a UTF-8 encoded sequence of bytes into a sequence of Unicode characters.</summary>
1694 <returns>A decoder that converts a UTF-8 encoded sequence of bytes into a sequence of Unicode characters.</returns>
1696 <member name="M:System.Text.UTF8Encoding.GetEncoder">
1697 <summary>Obtains an encoder that converts a sequence of Unicode characters into a UTF-8 encoded sequence of bytes.</summary>
1698 <returns>A <see cref="T:System.Text.Encoder" /> that converts a sequence of Unicode characters into a UTF-8 encoded sequence of bytes.</returns>
1700 <member name="M:System.Text.UTF8Encoding.GetHashCode">
1701 <summary>Returns the hash code for the current instance.</summary>
1702 <returns>The hash code for the current instance.</returns>
1704 <member name="M:System.Text.UTF8Encoding.GetMaxByteCount(System.Int32)">
1705 <summary>Calculates the maximum number of bytes produced by encoding the specified number of characters.</summary>
1706 <param name="charCount">The number of characters to encode.</param>
1707 <exception cref="T:System.ArgumentOutOfRangeException">
1708 <paramref name="charCount" /> is less than zero.
1712 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1713 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1717 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1718 <returns>The maximum number of bytes produced by encoding the specified number of characters.</returns>
1720 <member name="M:System.Text.UTF8Encoding.GetMaxCharCount(System.Int32)">
1721 <summary>Calculates the maximum number of characters produced by decoding the specified number of bytes.</summary>
1722 <param name="byteCount">The number of bytes to decode.</param>
1723 <exception cref="T:System.ArgumentOutOfRangeException">
1724 <paramref name="byteCount" /> is less than zero.
1728 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1729 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1733 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1734 <returns>The maximum number of characters produced by decoding the specified number of bytes.</returns>
1736 <member name="M:System.Text.UTF8Encoding.GetPreamble">
1737 <summary>Returns a Unicode byte order mark encoded in UTF-8 format, if the <see cref="T:System.Text.UTF8Encoding" /> encoding object is configured to supply one.</summary>
1738 <returns>A byte array containing the Unicode byte order mark, if the <see cref="T:System.Text.UTF8Encoding" /> encoding object is configured to supply one. Otherwise, this method returns a zero-length byte array.</returns>
1740 <member name="M:System.Text.UTF8Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
1741 <summary>Decodes a range of bytes from a byte array into a string.</summary>
1742 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
1743 <param name="index">The index of the first byte to decode.</param>
1744 <param name="count">The number of bytes to decode.</param>
1745 <exception cref="T:System.ArgumentNullException">
1746 <paramref name="bytes" /> is <see langword="null" />.</exception>
1747 <exception cref="T:System.ArgumentOutOfRangeException">
1748 <paramref name="index" /> or <paramref name="count" /> is less than zero.
1752 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.</exception>
1753 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
1754 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (for more information, see Character Encoding in .NET)
1758 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1759 <returns>A <see cref="T:System.String" /> containing the results of decoding the specified sequence of bytes.</returns>
1761 <member name="P:System.Text.UTF8Encoding.Preamble">
1762 <summary>Gets a Unicode byte order mark encoded in UTF-8 format, if this object is configured to supply one.</summary>
1763 <returns>A byte span containing the Unicode byte order mark, if this object is configured to supply one; otherwise, the default span.</returns>