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 <returns>The number of bytes produced by encoding the specified characters.</returns>
18 <exception cref="T:System.ArgumentNullException">
19 <paramref name="chars" /> is <see langword="null" />.</exception>
20 <exception cref="T:System.ArgumentOutOfRangeException">
21 <paramref name="count" /> is less than zero.
23 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
24 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
26 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
28 <member name="M:System.Text.ASCIIEncoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
29 <summary>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</summary>
30 <param name="chars">The character array containing the set of characters to encode.</param>
31 <param name="index">The index of the first character to encode.</param>
32 <param name="count">The number of characters to encode.</param>
33 <returns>The number of bytes produced by encoding the specified characters.</returns>
34 <exception cref="T:System.ArgumentNullException">
35 <paramref name="chars" /> is <see langword="null" />.</exception>
36 <exception cref="T:System.ArgumentOutOfRangeException">
37 <paramref name="index" /> or <paramref name="count" /> is less than zero.
39 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="chars" />.
41 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
42 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
44 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
46 <member name="M:System.Text.ASCIIEncoding.GetByteCount(System.ReadOnlySpan{System.Char})">
47 <summary>Calculates the number of bytes produced by encoding the specified character span.</summary>
48 <param name="chars">The span that contains the set of characters to encode.</param>
49 <returns>The number of bytes produced by encoding the specified character span.</returns>
51 <member name="M:System.Text.ASCIIEncoding.GetByteCount(System.String)">
52 <summary>Calculates the number of bytes produced by encoding the characters in the specified <see cref="T:System.String" />.</summary>
53 <param name="chars">The <see cref="T:System.String" /> containing the set of characters to encode.</param>
54 <returns>The number of bytes produced by encoding the specified characters.</returns>
55 <exception cref="T:System.ArgumentNullException">
56 <paramref name="chars" /> is <see langword="null" />.</exception>
57 <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
58 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
60 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
62 <member name="M:System.Text.ASCIIEncoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
63 <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>
64 <param name="chars">A pointer to the first character to encode.</param>
65 <param name="charCount">The number of characters to encode.</param>
66 <param name="bytes">A pointer to the location at which to start writing the resulting sequence of bytes.</param>
67 <param name="byteCount">The maximum number of bytes to write.</param>
68 <returns>The actual number of bytes written at the location indicated by <paramref name="bytes" />.</returns>
69 <exception cref="T:System.ArgumentNullException">
70 <paramref name="chars" /> is <see langword="null" />.
72 <paramref name="bytes" /> is <see langword="null" />.</exception>
73 <exception cref="T:System.ArgumentOutOfRangeException">
74 <paramref name="charCount" /> or <paramref name="byteCount" /> is less than zero.</exception>
75 <exception cref="T:System.ArgumentException">
76 <paramref name="byteCount" /> is less than the resulting number of bytes.</exception>
77 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
79 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
81 <member name="M:System.Text.ASCIIEncoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
82 <summary>Encodes a set of characters from the specified character array into the specified byte array.</summary>
83 <param name="chars">The character array containing the set of characters to encode.</param>
84 <param name="charIndex">The index of the first character to encode.</param>
85 <param name="charCount">The number of characters to encode.</param>
86 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
87 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
88 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
89 <exception cref="T:System.ArgumentNullException">
90 <paramref name="chars" /> is <see langword="null" />.
92 <paramref name="bytes" /> is <see langword="null" />.</exception>
93 <exception cref="T:System.ArgumentOutOfRangeException">
94 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
96 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
98 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
99 <exception cref="T:System.ArgumentException">
100 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
101 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
103 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
105 <member name="M:System.Text.ASCIIEncoding.GetBytes(System.ReadOnlySpan{System.Char},System.Span{System.Byte})">
106 <summary>Encodes the specified character span into the specified byte span.</summary>
107 <param name="chars">The character span to encode.</param>
108 <param name="bytes">The span to contain the resulting set of bytes.</param>
109 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
111 <member name="M:System.Text.ASCIIEncoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
112 <summary>Encodes a set of characters from the specified <see cref="T:System.String" /> into the specified byte array.</summary>
113 <param name="chars">The <see cref="T:System.String" /> containing the set of characters to encode.</param>
114 <param name="charIndex">The index of the first character to encode.</param>
115 <param name="charCount">The number of characters to encode.</param>
116 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
117 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
118 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
119 <exception cref="T:System.ArgumentNullException">
120 <paramref name="s" /> is <see langword="null" />.
122 <paramref name="bytes" /> is <see langword="null" />.</exception>
123 <exception cref="T:System.ArgumentOutOfRangeException">
124 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
126 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
128 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
129 <exception cref="T:System.ArgumentException">
130 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
131 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
133 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
135 <member name="M:System.Text.ASCIIEncoding.GetCharCount(System.Byte*,System.Int32)">
136 <summary>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</summary>
137 <param name="bytes">A pointer to the first byte to decode.</param>
138 <param name="count">The number of bytes to decode.</param>
139 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
140 <exception cref="T:System.ArgumentNullException">
141 <paramref name="bytes" /> is <see langword="null" />.</exception>
142 <exception cref="T:System.ArgumentOutOfRangeException">
143 <paramref name="count" /> is less than zero.
145 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
146 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
148 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
150 <member name="M:System.Text.ASCIIEncoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
151 <summary>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</summary>
152 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
153 <param name="index">The index of the first byte to decode.</param>
154 <param name="count">The number of bytes to decode.</param>
155 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
156 <exception cref="T:System.ArgumentNullException">
157 <paramref name="bytes" /> is <see langword="null" />.</exception>
158 <exception cref="T:System.ArgumentOutOfRangeException">
159 <paramref name="index" /> or <paramref name="count" /> is less than zero.
161 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.
163 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
164 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
166 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
168 <member name="M:System.Text.ASCIIEncoding.GetCharCount(System.ReadOnlySpan{System.Byte})">
169 <summary>Calculates the number of characters produced by decoding the specified byte span.</summary>
170 <param name="bytes">The span containing the set of bytes to decode.</param>
171 <returns>The number of characters produced by decoding the specified byte span.</returns>
173 <member name="M:System.Text.ASCIIEncoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
174 <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>
175 <param name="bytes">A pointer to the first byte to decode.</param>
176 <param name="byteCount">The number of bytes to decode.</param>
177 <param name="chars">A pointer to the location at which to start writing the resulting set of characters.</param>
178 <param name="charCount">The maximum number of characters to write.</param>
179 <returns>The actual number of characters written at the location indicated by <paramref name="chars" />.</returns>
180 <exception cref="T:System.ArgumentNullException">
181 <paramref name="bytes" /> is <see langword="null" />.
183 <paramref name="chars" /> is <see langword="null" />.</exception>
184 <exception cref="T:System.ArgumentOutOfRangeException">
185 <paramref name="byteCount" /> or <paramref name="charCount" /> is less than zero.</exception>
186 <exception cref="T:System.ArgumentException">
187 <paramref name="charCount" /> is less than the resulting number of characters.</exception>
188 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
190 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
192 <member name="M:System.Text.ASCIIEncoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
193 <summary>Decodes a sequence of bytes from the specified byte array into the specified character array.</summary>
194 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
195 <param name="byteIndex">The index of the first byte to decode.</param>
196 <param name="byteCount">The number of bytes to decode.</param>
197 <param name="chars">The character array to contain the resulting set of characters.</param>
198 <param name="charIndex">The index at which to start writing the resulting set of characters.</param>
199 <returns>The actual number of characters written into <paramref name="chars" />.</returns>
200 <exception cref="T:System.ArgumentNullException">
201 <paramref name="bytes" /> is <see langword="null" />.
203 <paramref name="chars" /> is <see langword="null" />.</exception>
204 <exception cref="T:System.ArgumentOutOfRangeException">
205 <paramref name="byteIndex" /> or <paramref name="byteCount" /> or <paramref name="charIndex" /> is less than zero.
207 <paramref name="byteindex" /> and <paramref name="byteCount" /> do not denote a valid range in <paramref name="bytes" />.
209 <paramref name="charIndex" /> is not a valid index in <paramref name="chars" />.</exception>
210 <exception cref="T:System.ArgumentException">
211 <paramref name="chars" /> does not have enough capacity from <paramref name="charIndex" /> to the end of the array to accommodate the resulting characters.</exception>
212 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
214 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
216 <member name="M:System.Text.ASCIIEncoding.GetChars(System.ReadOnlySpan{System.Byte},System.Span{System.Char})">
217 <summary>Decodes the specified byte span into the specified character span.</summary>
218 <param name="bytes">The span containing the bytes to decode.</param>
219 <param name="chars">The span to contain the resulting set of characters.</param>
220 <returns>The actual number of characters written into <paramref name="chars" />.</returns>
222 <member name="M:System.Text.ASCIIEncoding.GetDecoder">
223 <summary>Obtains a decoder that converts an ASCII encoded sequence of bytes into a sequence of Unicode characters.</summary>
224 <returns>A <see cref="T:System.Text.Decoder" /> that converts an ASCII encoded sequence of bytes into a sequence of Unicode characters.</returns>
226 <member name="M:System.Text.ASCIIEncoding.GetEncoder">
227 <summary>Obtains an encoder that converts a sequence of Unicode characters into an ASCII encoded sequence of bytes.</summary>
228 <returns>An <see cref="T:System.Text.Encoder" /> that converts a sequence of Unicode characters into an ASCII encoded sequence of bytes.</returns>
230 <member name="M:System.Text.ASCIIEncoding.GetMaxByteCount(System.Int32)">
231 <summary>Calculates the maximum number of bytes produced by encoding the specified number of characters.</summary>
232 <param name="charCount">The number of characters to encode.</param>
233 <returns>The maximum number of bytes produced by encoding the specified number of characters.</returns>
234 <exception cref="T:System.ArgumentOutOfRangeException">
235 <paramref name="charCount" /> is less than zero.
237 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
239 <member name="M:System.Text.ASCIIEncoding.GetMaxCharCount(System.Int32)">
240 <summary>Calculates the maximum number of characters produced by decoding the specified number of bytes.</summary>
241 <param name="byteCount">The number of bytes to decode.</param>
242 <returns>The maximum number of characters produced by decoding the specified number of bytes.</returns>
243 <exception cref="T:System.ArgumentOutOfRangeException">
244 <paramref name="byteCount" /> is less than zero.
246 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
248 <member name="M:System.Text.ASCIIEncoding.GetString(System.Byte[],System.Int32,System.Int32)">
249 <summary>Decodes a range of bytes from a byte array into a string.</summary>
250 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
251 <param name="byteIndex">The index of the first byte to decode.</param>
252 <param name="byteCount">The number of bytes to decode.</param>
253 <returns>A <see cref="T:System.String" /> containing the results of decoding the specified sequence of bytes.</returns>
254 <exception cref="T:System.ArgumentNullException">
255 <paramref name="bytes" /> is <see langword="null" />.</exception>
256 <exception cref="T:System.ArgumentOutOfRangeException">
257 <paramref name="index" /> or <paramref name="count" /> is less than zero.
259 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.</exception>
260 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
262 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
264 <member name="P:System.Text.ASCIIEncoding.IsSingleByte">
265 <summary>Gets a value indicating whether the current encoding uses single-byte code points.</summary>
266 <returns>This property is always <see langword="true" />.</returns>
268 <member name="T:System.Text.UnicodeEncoding">
269 <summary>Represents a UTF-16 encoding of Unicode characters.</summary>
271 <member name="M:System.Text.UnicodeEncoding.#ctor">
272 <summary>Initializes a new instance of the <see cref="T:System.Text.UnicodeEncoding" /> class.</summary>
274 <member name="M:System.Text.UnicodeEncoding.#ctor(System.Boolean,System.Boolean)">
275 <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>
276 <param name="bigEndian">
277 <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>
278 <param name="byteOrderMark">
279 <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>
281 <member name="M:System.Text.UnicodeEncoding.#ctor(System.Boolean,System.Boolean,System.Boolean)">
282 <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>
283 <param name="bigEndian">
284 <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>
285 <param name="byteOrderMark">
286 <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>
287 <param name="throwOnInvalidBytes">
288 <see langword="true" /> to specify that an exception should be thrown when an invalid encoding is detected; otherwise, <see langword="false" />.</param>
290 <member name="F:System.Text.UnicodeEncoding.CharSize">
291 <summary>Represents the Unicode character size in bytes. This field is a constant.</summary>
293 <member name="M:System.Text.UnicodeEncoding.Equals(System.Object)">
294 <summary>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Text.UnicodeEncoding" /> object.</summary>
295 <param name="value">The object to compare with the current object.</param>
297 <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>
299 <member name="M:System.Text.UnicodeEncoding.GetByteCount(System.Char*,System.Int32)">
300 <summary>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</summary>
301 <param name="chars">A pointer to the first character to encode.</param>
302 <param name="count">The number of characters to encode.</param>
303 <returns>The number of bytes produced by encoding the specified characters.</returns>
304 <exception cref="T:System.ArgumentNullException">
305 <paramref name="chars" /> is <see langword="null" />.</exception>
306 <exception cref="T:System.ArgumentOutOfRangeException">
307 <paramref name="count" /> is less than zero.
309 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
310 <exception cref="T:System.ArgumentException">Error detection is enabled and <paramref name="chars" /> contains an invalid sequence of characters.</exception>
311 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
313 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
315 <member name="M:System.Text.UnicodeEncoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
316 <summary>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</summary>
317 <param name="chars">The character array containing the set of characters to encode.</param>
318 <param name="index">The index of the first character to encode.</param>
319 <param name="count">The number of characters to encode.</param>
320 <returns>The number of bytes produced by encoding the specified characters.</returns>
321 <exception cref="T:System.ArgumentNullException">
322 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
323 <exception cref="T:System.ArgumentOutOfRangeException">
324 <paramref name="index" /> or <paramref name="count" /> is less than zero.
326 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="chars" />.
328 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
329 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.</exception>
330 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
332 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
334 <member name="M:System.Text.UnicodeEncoding.GetByteCount(System.String)">
335 <summary>Calculates the number of bytes produced by encoding the characters in the specified string.</summary>
336 <param name="s">The string that contains the set of characters to encode.</param>
337 <returns>The number of bytes produced by encoding the specified characters.</returns>
338 <exception cref="T:System.ArgumentNullException">
339 <paramref name="s" /> is <see langword="null" />.</exception>
340 <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
341 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s" /> contains an invalid sequence of characters.</exception>
342 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
344 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
346 <member name="M:System.Text.UnicodeEncoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
347 <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>
348 <param name="chars">A pointer to the first character to encode.</param>
349 <param name="charCount">The number of characters to encode.</param>
350 <param name="bytes">A pointer to the location at which to start writing the resulting sequence of bytes.</param>
351 <param name="byteCount">The maximum number of bytes to write.</param>
352 <returns>The actual number of bytes written at the location indicated by the <paramref name="bytes" /> parameter.</returns>
353 <exception cref="T:System.ArgumentNullException">
354 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).
356 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
357 <exception cref="T:System.ArgumentOutOfRangeException">
358 <paramref name="charCount" /> or <paramref name="byteCount" /> is less than zero.</exception>
359 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.
361 <paramref name="byteCount" /> is less than the resulting number of bytes.</exception>
362 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
364 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
366 <member name="M:System.Text.UnicodeEncoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
367 <summary>Encodes a set of characters from the specified character array into the specified byte array.</summary>
368 <param name="chars">The character array containing the set of characters to encode.</param>
369 <param name="charIndex">The index of the first character to encode.</param>
370 <param name="charCount">The number of characters to encode.</param>
371 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
372 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
373 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
374 <exception cref="T:System.ArgumentNullException">
375 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).
377 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
378 <exception cref="T:System.ArgumentOutOfRangeException">
379 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
381 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
383 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
384 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.
386 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
387 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
389 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
391 <member name="M:System.Text.UnicodeEncoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
392 <summary>Encodes a set of characters from the specified <see cref="T:System.String" /> into the specified byte array.</summary>
393 <param name="s">The string containing the set of characters to encode.</param>
394 <param name="charIndex">The index of the first character to encode.</param>
395 <param name="charCount">The number of characters to encode.</param>
396 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
397 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
398 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
399 <exception cref="T:System.ArgumentNullException">
400 <paramref name="s" /> is <see langword="null" />.
402 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
403 <exception cref="T:System.ArgumentOutOfRangeException">
404 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
406 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
408 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
409 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s" /> contains an invalid sequence of characters.
411 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
412 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
414 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
416 <member name="M:System.Text.UnicodeEncoding.GetCharCount(System.Byte*,System.Int32)">
417 <summary>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</summary>
418 <param name="bytes">A pointer to the first byte to decode.</param>
419 <param name="count">The number of bytes to decode.</param>
420 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
421 <exception cref="T:System.ArgumentNullException">
422 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
423 <exception cref="T:System.ArgumentOutOfRangeException">
424 <paramref name="count" /> is less than zero.
426 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
427 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
428 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
430 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
432 <member name="M:System.Text.UnicodeEncoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
433 <summary>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</summary>
434 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
435 <param name="index">The index of the first byte to decode.</param>
436 <param name="count">The number of bytes to decode.</param>
437 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
438 <exception cref="T:System.ArgumentNullException">
439 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
440 <exception cref="T:System.ArgumentOutOfRangeException">
441 <paramref name="index" /> or <paramref name="count" /> is less than zero.
443 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.
445 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
446 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
447 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
449 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
451 <member name="M:System.Text.UnicodeEncoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
452 <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>
453 <param name="bytes">A pointer to the first byte to decode.</param>
454 <param name="byteCount">The number of bytes to decode.</param>
455 <param name="chars">A pointer to the location at which to start writing the resulting set of characters.</param>
456 <param name="charCount">The maximum number of characters to write.</param>
457 <returns>The actual number of characters written at the location indicated by the <paramref name="chars" /> parameter.</returns>
458 <exception cref="T:System.ArgumentNullException">
459 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).
461 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
462 <exception cref="T:System.ArgumentOutOfRangeException">
463 <paramref name="byteCount" /> or <paramref name="charCount" /> is less than zero.</exception>
464 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.
466 <paramref name="charCount" /> is less than the resulting number of characters.</exception>
467 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
469 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
471 <member name="M:System.Text.UnicodeEncoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
472 <summary>Decodes a sequence of bytes from the specified byte array into the specified character array.</summary>
473 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
474 <param name="byteIndex">The index of the first byte to decode.</param>
475 <param name="byteCount">The number of bytes to decode.</param>
476 <param name="chars">The character array to contain the resulting set of characters.</param>
477 <param name="charIndex">The index at which to start writing the resulting set of characters.</param>
478 <returns>The actual number of characters written into <paramref name="chars" />.</returns>
479 <exception cref="T:System.ArgumentNullException">
480 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).
482 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
483 <exception cref="T:System.ArgumentOutOfRangeException">
484 <paramref name="byteIndex" /> or <paramref name="byteCount" /> or <paramref name="charIndex" /> is less than zero.
486 <paramref name="byteindex" /> and <paramref name="byteCount" /> do not denote a valid range in <paramref name="bytes" />.
488 <paramref name="charIndex" /> is not a valid index in <paramref name="chars" />.</exception>
489 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.
491 <paramref name="chars" /> does not have enough capacity from <paramref name="charIndex" /> to the end of the array to accommodate the resulting characters.</exception>
492 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
494 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
496 <member name="M:System.Text.UnicodeEncoding.GetDecoder">
497 <summary>Obtains a decoder that converts a UTF-16 encoded sequence of bytes into a sequence of Unicode characters.</summary>
498 <returns>A <see cref="T:System.Text.Decoder" /> that converts a UTF-16 encoded sequence of bytes into a sequence of Unicode characters.</returns>
500 <member name="M:System.Text.UnicodeEncoding.GetEncoder">
501 <summary>Obtains an encoder that converts a sequence of Unicode characters into a UTF-16 encoded sequence of bytes.</summary>
502 <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>
504 <member name="M:System.Text.UnicodeEncoding.GetHashCode">
505 <summary>Returns the hash code for the current instance.</summary>
506 <returns>The hash code for the current <see cref="T:System.Text.UnicodeEncoding" /> object.</returns>
508 <member name="M:System.Text.UnicodeEncoding.GetMaxByteCount(System.Int32)">
509 <summary>Calculates the maximum number of bytes produced by encoding the specified number of characters.</summary>
510 <param name="charCount">The number of characters to encode.</param>
511 <returns>The maximum number of bytes produced by encoding the specified number of characters.</returns>
512 <exception cref="T:System.ArgumentOutOfRangeException">
513 <paramref name="charCount" /> is less than zero.
515 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
516 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
518 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
520 <member name="M:System.Text.UnicodeEncoding.GetMaxCharCount(System.Int32)">
521 <summary>Calculates the maximum number of characters produced by decoding the specified number of bytes.</summary>
522 <param name="byteCount">The number of bytes to decode.</param>
523 <returns>The maximum number of characters produced by decoding the specified number of bytes.</returns>
524 <exception cref="T:System.ArgumentOutOfRangeException">
525 <paramref name="byteCount" /> 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.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
530 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
532 <member name="M:System.Text.UnicodeEncoding.GetPreamble">
533 <summary>Returns a Unicode byte order mark encoded in UTF-16 format, if the constructor for this instance requests a byte order mark.</summary>
534 <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>
536 <member name="M:System.Text.UnicodeEncoding.GetString(System.Byte[],System.Int32,System.Int32)">
537 <summary>Decodes a range of bytes from a byte array into a string.</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 <returns>A <see cref="T:System.String" /> object containing the results of decoding the specified sequence of bytes.</returns>
542 <exception cref="T:System.ArgumentNullException">
543 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
544 <exception cref="T:System.ArgumentOutOfRangeException">
545 <paramref name="index" /> or <paramref name="count" /> is less than zero.
547 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.</exception>
548 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
549 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
551 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
553 <member name="P:System.Text.UnicodeEncoding.Preamble">
554 <summary>Gets a Unicode byte order mark encoded in UTF-16 format, if this object is configured to supply one.</summary>
555 <returns>A byte span containing the Unicode byte order mark, if this object is configured to supply one; otherwise, the default span.</returns>
557 <member name="T:System.Text.UTF32Encoding">
558 <summary>Represents a UTF-32 encoding of Unicode characters.</summary>
560 <member name="M:System.Text.UTF32Encoding.#ctor">
561 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF32Encoding" /> class.</summary>
563 <member name="M:System.Text.UTF32Encoding.#ctor(System.Boolean,System.Boolean)">
564 <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>
565 <param name="bigEndian">
566 <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>
567 <param name="byteOrderMark">
568 <see langword="true" /> to specify that a Unicode byte order mark is provided; otherwise, <see langword="false" />.</param>
570 <member name="M:System.Text.UTF32Encoding.#ctor(System.Boolean,System.Boolean,System.Boolean)">
571 <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>
572 <param name="bigEndian">
573 <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>
574 <param name="byteOrderMark">
575 <see langword="true" /> to specify that a Unicode byte order mark is provided; otherwise, <see langword="false" />.</param>
576 <param name="throwOnInvalidCharacters">
577 <see langword="true" /> to specify that an exception should be thrown when an invalid encoding is detected; otherwise, <see langword="false" />.</param>
579 <member name="M:System.Text.UTF32Encoding.Equals(System.Object)">
580 <summary>Determines whether the specified <see cref="T:System.Object" /> is equal to the current <see cref="T:System.Text.UTF32Encoding" /> object.</summary>
581 <param name="value">The <see cref="T:System.Object" /> to compare with the current object.</param>
583 <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>
585 <member name="M:System.Text.UTF32Encoding.GetByteCount(System.Char*,System.Int32)">
586 <summary>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</summary>
587 <param name="chars">A pointer to the first character to encode.</param>
588 <param name="count">The number of characters to encode.</param>
589 <returns>The number of bytes produced by encoding the specified characters.</returns>
590 <exception cref="T:System.ArgumentNullException">
591 <paramref name="chars" /> is <see langword="null" />.</exception>
592 <exception cref="T:System.ArgumentOutOfRangeException">
593 <paramref name="count" /> is less than zero.
595 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
596 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.</exception>
597 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
599 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
601 <member name="M:System.Text.UTF32Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
602 <summary>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</summary>
603 <param name="chars">The character array containing the set of characters to encode.</param>
604 <param name="index">The index of the first character to encode.</param>
605 <param name="count">The number of characters to encode.</param>
606 <returns>The number of bytes produced by encoding the specified characters.</returns>
607 <exception cref="T:System.ArgumentNullException">
608 <paramref name="chars" /> is <see langword="null" />.</exception>
609 <exception cref="T:System.ArgumentOutOfRangeException">
610 <paramref name="index" /> or <paramref name="count" /> is less than zero.
612 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="chars" />.
614 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
615 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.</exception>
616 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
618 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
620 <member name="M:System.Text.UTF32Encoding.GetByteCount(System.String)">
621 <summary>Calculates the number of bytes produced by encoding the characters in the specified <see cref="T:System.String" />.</summary>
622 <param name="s">The <see cref="T:System.String" /> containing the set of characters to encode.</param>
623 <returns>The number of bytes produced by encoding the specified characters.</returns>
624 <exception cref="T:System.ArgumentNullException">
625 <paramref name="s" /> is <see langword="null" />.</exception>
626 <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
627 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s" /> contains an invalid sequence of characters.</exception>
628 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
630 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
632 <member name="M:System.Text.UTF32Encoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
633 <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>
634 <param name="chars">A pointer to the first character to encode.</param>
635 <param name="charCount">The number of characters to encode.</param>
636 <param name="bytes">A pointer to the location at which to start writing the resulting sequence of bytes.</param>
637 <param name="byteCount">The maximum number of bytes to write.</param>
638 <returns>The actual number of bytes written at the location indicated by the <paramref name="bytes" /> parameter.</returns>
639 <exception cref="T:System.ArgumentNullException">
640 <paramref name="chars" /> is <see langword="null" />.
642 <paramref name="bytes" /> is <see langword="null" />.</exception>
643 <exception cref="T:System.ArgumentOutOfRangeException">
644 <paramref name="charCount" /> or <paramref name="byteCount" /> is less than zero.</exception>
645 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.
647 <paramref name="byteCount" /> is less than the resulting number of bytes.</exception>
648 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
650 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
652 <member name="M:System.Text.UTF32Encoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
653 <summary>Encodes a set of characters from the specified character array into the specified byte array.</summary>
654 <param name="chars">The character array containing the set of characters to encode.</param>
655 <param name="charIndex">The index of the first character to encode.</param>
656 <param name="charCount">The number of characters to encode.</param>
657 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
658 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
659 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
660 <exception cref="T:System.ArgumentNullException">
661 <paramref name="chars" /> is <see langword="null" />.
663 <paramref name="bytes" /> is <see langword="null" />.</exception>
664 <exception cref="T:System.ArgumentOutOfRangeException">
665 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
667 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
669 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
670 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.
672 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
673 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
675 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
677 <member name="M:System.Text.UTF32Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
678 <summary>Encodes a set of characters from the specified <see cref="T:System.String" /> into the specified byte array.</summary>
679 <param name="s">The <see cref="T:System.String" /> containing the set of characters to encode.</param>
680 <param name="charIndex">The index of the first character to encode.</param>
681 <param name="charCount">The number of characters to encode.</param>
682 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
683 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
684 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
685 <exception cref="T:System.ArgumentNullException">
686 <paramref name="s" /> is <see langword="null" />.
688 <paramref name="bytes" /> is <see langword="null" />.</exception>
689 <exception cref="T:System.ArgumentOutOfRangeException">
690 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
692 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
694 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
695 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s" /> contains an invalid sequence of characters.
697 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
698 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
700 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
702 <member name="M:System.Text.UTF32Encoding.GetCharCount(System.Byte*,System.Int32)">
703 <summary>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</summary>
704 <param name="bytes">A pointer to the first byte to decode.</param>
705 <param name="count">The number of bytes to decode.</param>
706 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
707 <exception cref="T:System.ArgumentNullException">
708 <paramref name="bytes" /> is <see langword="null" />.</exception>
709 <exception cref="T:System.ArgumentOutOfRangeException">
710 <paramref name="count" /> is less than zero.
712 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
713 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
714 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
716 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
718 <member name="M:System.Text.UTF32Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
719 <summary>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</summary>
720 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
721 <param name="index">The index of the first byte to decode.</param>
722 <param name="count">The number of bytes to decode.</param>
723 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
724 <exception cref="T:System.ArgumentNullException">
725 <paramref name="bytes" /> is <see langword="null" />.</exception>
726 <exception cref="T:System.ArgumentOutOfRangeException">
727 <paramref name="index" /> or <paramref name="count" /> is less than zero.
729 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.
731 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
732 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
733 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
735 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
737 <member name="M:System.Text.UTF32Encoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
738 <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>
739 <param name="bytes">A pointer to the first byte to decode.</param>
740 <param name="byteCount">The number of bytes to decode.</param>
741 <param name="chars">A pointer to the location at which to start writing the resulting set of characters.</param>
742 <param name="charCount">The maximum number of characters to write.</param>
743 <returns>The actual number of characters written at the location indicated by <paramref name="chars" />.</returns>
744 <exception cref="T:System.ArgumentNullException">
745 <paramref name="bytes" /> is <see langword="null" />.
747 <paramref name="chars" /> is <see langword="null" />.</exception>
748 <exception cref="T:System.ArgumentOutOfRangeException">
749 <paramref name="byteCount" /> or <paramref name="charCount" /> is less than zero.</exception>
750 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.
752 <paramref name="charCount" /> is less than the resulting number of characters.</exception>
753 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
755 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
757 <member name="M:System.Text.UTF32Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
758 <summary>Decodes a sequence of bytes from the specified byte array into the specified character array.</summary>
759 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
760 <param name="byteIndex">The index of the first byte to decode.</param>
761 <param name="byteCount">The number of bytes to decode.</param>
762 <param name="chars">The character array to contain the resulting set of characters.</param>
763 <param name="charIndex">The index at which to start writing the resulting set of characters.</param>
764 <returns>The actual number of characters written into <paramref name="chars" />.</returns>
765 <exception cref="T:System.ArgumentNullException">
766 <paramref name="bytes" /> is <see langword="null" />.
768 <paramref name="chars" /> is <see langword="null" />.</exception>
769 <exception cref="T:System.ArgumentOutOfRangeException">
770 <paramref name="byteIndex" /> or <paramref name="byteCount" /> or <paramref name="charIndex" /> is less than zero.
772 <paramref name="byteindex" /> and <paramref name="byteCount" /> do not denote a valid range in <paramref name="bytes" />.
774 <paramref name="charIndex" /> is not a valid index in <paramref name="chars" />.</exception>
775 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.
777 <paramref name="chars" /> does not have enough capacity from <paramref name="charIndex" /> to the end of the array to accommodate the resulting characters.</exception>
778 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
780 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
782 <member name="M:System.Text.UTF32Encoding.GetDecoder">
783 <summary>Obtains a decoder that converts a UTF-32 encoded sequence of bytes into a sequence of Unicode characters.</summary>
784 <returns>A <see cref="T:System.Text.Decoder" /> that converts a UTF-32 encoded sequence of bytes into a sequence of Unicode characters.</returns>
786 <member name="M:System.Text.UTF32Encoding.GetEncoder">
787 <summary>Obtains an encoder that converts a sequence of Unicode characters into a UTF-32 encoded sequence of bytes.</summary>
788 <returns>A <see cref="T:System.Text.Encoder" /> that converts a sequence of Unicode characters into a UTF-32 encoded sequence of bytes.</returns>
790 <member name="M:System.Text.UTF32Encoding.GetHashCode">
791 <summary>Returns the hash code for the current instance.</summary>
792 <returns>The hash code for the current <see cref="T:System.Text.UTF32Encoding" /> object.</returns>
794 <member name="M:System.Text.UTF32Encoding.GetMaxByteCount(System.Int32)">
795 <summary>Calculates the maximum number of bytes produced by encoding the specified number of characters.</summary>
796 <param name="charCount">The number of characters to encode.</param>
797 <returns>The maximum number of bytes produced by encoding the specified number of characters.</returns>
798 <exception cref="T:System.ArgumentOutOfRangeException">
799 <paramref name="charCount" /> is less than zero.
801 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
802 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
804 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
806 <member name="M:System.Text.UTF32Encoding.GetMaxCharCount(System.Int32)">
807 <summary>Calculates the maximum number of characters produced by decoding the specified number of bytes.</summary>
808 <param name="byteCount">The number of bytes to decode.</param>
809 <returns>The maximum number of characters produced by decoding the specified number of bytes.</returns>
810 <exception cref="T:System.ArgumentOutOfRangeException">
811 <paramref name="byteCount" /> is less than zero.
813 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
814 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
816 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
818 <member name="M:System.Text.UTF32Encoding.GetPreamble">
819 <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>
820 <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>
822 <member name="M:System.Text.UTF32Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
823 <summary>Decodes a range of bytes from a byte array into a string.</summary>
824 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
825 <param name="index">The index of the first byte to decode.</param>
826 <param name="count">The number of bytes to decode.</param>
827 <returns>A string that contains the results of decoding the specified sequence of bytes.</returns>
828 <exception cref="T:System.ArgumentNullException">
829 <paramref name="bytes" /> is <see langword="null" />.</exception>
830 <exception cref="T:System.ArgumentOutOfRangeException">
831 <paramref name="index" /> or <paramref name="count" /> is less than zero.
833 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.</exception>
834 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
835 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for a complete explanation)
837 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
839 <member name="P:System.Text.UTF32Encoding.Preamble">
840 <summary>Gets a Unicode byte order mark encoded in UTF-32 format, if this object is configured to supply one.</summary>
841 <returns>A byte span containing the Unicode byte order mark, if this object is configured to supply one; otherwise, a default span.</returns>
843 <member name="T:System.Text.UTF7Encoding">
844 <summary>Represents a UTF-7 encoding of Unicode characters.</summary>
846 <member name="M:System.Text.UTF7Encoding.#ctor">
847 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF7Encoding" /> class.</summary>
849 <member name="M:System.Text.UTF7Encoding.#ctor(System.Boolean)">
850 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF7Encoding" /> class. A parameter specifies whether to allow optional characters.</summary>
851 <param name="allowOptionals">
852 <see langword="true" /> to specify that optional characters are allowed; otherwise, <see langword="false" />.</param>
854 <member name="M:System.Text.UTF7Encoding.Equals(System.Object)">
855 <summary>Gets a value indicating whether the specified object is equal to the current <see cref="T:System.Text.UTF7Encoding" /> object.</summary>
856 <param name="value">An object to compare to the current <see cref="T:System.Text.UTF7Encoding" /> object.</param>
858 <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>
860 <member name="M:System.Text.UTF7Encoding.GetByteCount(System.Char*,System.Int32)">
861 <summary>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</summary>
862 <param name="chars">A pointer to the first character to encode.</param>
863 <param name="count">The number of characters to encode.</param>
864 <returns>The number of bytes produced by encoding the specified characters.</returns>
865 <exception cref="T:System.ArgumentNullException">
866 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" /> in Visual Basic .NET).</exception>
867 <exception cref="T:System.ArgumentOutOfRangeException">
868 <paramref name="count" /> is less than zero.
870 The resulting number of bytes is greater than the maximum number that can be returned as an int.</exception>
871 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
873 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
875 <member name="M:System.Text.UTF7Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
876 <summary>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</summary>
877 <param name="chars">The character array containing the set of characters to encode.</param>
878 <param name="index">The index of the first character to encode.</param>
879 <param name="count">The number of characters to encode.</param>
880 <returns>The number of bytes produced by encoding the specified characters.</returns>
881 <exception cref="T:System.ArgumentNullException">
882 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
883 <exception cref="T:System.ArgumentOutOfRangeException">
884 <paramref name="index" /> or <paramref name="count" /> is less than zero.
886 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="chars" />.
888 The resulting number of bytes is greater than the maximum number that can be returned as an int.</exception>
889 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
891 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
893 <member name="M:System.Text.UTF7Encoding.GetByteCount(System.String)">
894 <summary>Calculates the number of bytes produced by encoding the characters in the specified <see cref="T:System.String" /> object.</summary>
895 <param name="s">The <see cref="T:System.String" /> object containing the set of characters to encode.</param>
896 <returns>The number of bytes produced by encoding the specified characters.</returns>
897 <exception cref="T:System.ArgumentNullException">
898 <paramref name="s" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
899 <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an int.</exception>
900 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
902 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
904 <member name="M:System.Text.UTF7Encoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
905 <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>
906 <param name="chars">A pointer to the first character to encode.</param>
907 <param name="charCount">The number of characters to encode.</param>
908 <param name="bytes">A pointer to the location at which to start writing the resulting sequence of bytes.</param>
909 <param name="byteCount">The maximum number of bytes to write.</param>
910 <returns>The actual number of bytes written at the location indicated by <paramref name="bytes" />.</returns>
911 <exception cref="T:System.ArgumentNullException">
912 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).
914 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
915 <exception cref="T:System.ArgumentOutOfRangeException">
916 <paramref name="charCount" /> or <paramref name="byteCount" /> is less than zero.</exception>
917 <exception cref="T:System.ArgumentException">
918 <paramref name="byteCount" /> is less than the resulting number of bytes.</exception>
919 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
921 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
923 <member name="M:System.Text.UTF7Encoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
924 <summary>Encodes a set of characters from the specified character array into the specified byte array.</summary>
925 <param name="chars">The character array containing the set of characters to encode.</param>
926 <param name="charIndex">The index of the first character to encode.</param>
927 <param name="charCount">The number of characters to encode.</param>
928 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
929 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
930 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
931 <exception cref="T:System.ArgumentNullException">
932 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).
934 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
935 <exception cref="T:System.ArgumentOutOfRangeException">
936 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
938 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
940 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
941 <exception cref="T:System.ArgumentException">
942 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
943 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
945 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
947 <member name="M:System.Text.UTF7Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
948 <summary>Encodes a set of characters from the specified <see cref="T:System.String" /> into the specified byte array.</summary>
949 <param name="s">The <see cref="T:System.String" /> containing the set of characters to encode.</param>
950 <param name="charIndex">The index of the first character to encode.</param>
951 <param name="charCount">The number of characters to encode.</param>
952 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
953 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
954 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
955 <exception cref="T:System.ArgumentNullException">
956 <paramref name="s" /> is <see langword="null" /> (<see langword="Nothing" />).
958 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
959 <exception cref="T:System.ArgumentOutOfRangeException">
960 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
962 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
964 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
965 <exception cref="T:System.ArgumentException">
966 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
967 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
969 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
971 <member name="M:System.Text.UTF7Encoding.GetCharCount(System.Byte*,System.Int32)">
972 <summary>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</summary>
973 <param name="bytes">A pointer to the first byte to decode.</param>
974 <param name="count">The number of bytes to decode.</param>
975 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
976 <exception cref="T:System.ArgumentNullException">
977 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
978 <exception cref="T:System.ArgumentOutOfRangeException">
979 <paramref name="count" /> is less than zero.
981 The resulting number of characters is greater than the maximum number that can be returned as an int.</exception>
982 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
984 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
986 <member name="M:System.Text.UTF7Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
987 <summary>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</summary>
988 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
989 <param name="index">The index of the first byte to decode.</param>
990 <param name="count">The number of bytes to decode.</param>
991 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
992 <exception cref="T:System.ArgumentNullException">
993 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
994 <exception cref="T:System.ArgumentOutOfRangeException">
995 <paramref name="index" /> or <paramref name="count" /> is less than zero.
997 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.
999 The resulting number of characters is greater than the maximum number that can be returned as an int.</exception>
1000 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
1002 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1004 <member name="M:System.Text.UTF7Encoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
1005 <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>
1006 <param name="bytes">A pointer to the first byte to decode.</param>
1007 <param name="byteCount">The number of bytes to decode.</param>
1008 <param name="chars">A pointer to the location at which to start writing the resulting set of characters.</param>
1009 <param name="charCount">The maximum number of characters to write.</param>
1010 <returns>The actual number of characters written at the location indicated by <paramref name="chars" />.</returns>
1011 <exception cref="T:System.ArgumentNullException">
1012 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).
1014 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
1015 <exception cref="T:System.ArgumentOutOfRangeException">
1016 <paramref name="byteCount" /> or <paramref name="charCount" /> is less than zero.</exception>
1017 <exception cref="T:System.ArgumentException">
1018 <paramref name="charCount" /> is less than the resulting number of characters.</exception>
1019 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
1021 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1023 <member name="M:System.Text.UTF7Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
1024 <summary>Decodes a sequence of bytes from the specified byte array into the specified character array.</summary>
1025 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
1026 <param name="byteIndex">The index of the first byte to decode.</param>
1027 <param name="byteCount">The number of bytes to decode.</param>
1028 <param name="chars">The character array to contain the resulting set of characters.</param>
1029 <param name="charIndex">The index at which to start writing the resulting set of characters.</param>
1030 <returns>The actual number of characters written into <paramref name="chars" />.</returns>
1031 <exception cref="T:System.ArgumentNullException">
1032 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).
1034 <paramref name="chars" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
1035 <exception cref="T:System.ArgumentOutOfRangeException">
1036 <paramref name="byteIndex" /> or <paramref name="byteCount" /> or <paramref name="charIndex" /> is less than zero.
1038 <paramref name="byteindex" /> and <paramref name="byteCount" /> do not denote a valid range in <paramref name="bytes" />.
1040 <paramref name="charIndex" /> is not a valid index in <paramref name="chars" />.</exception>
1041 <exception cref="T:System.ArgumentException">
1042 <paramref name="chars" /> does not have enough capacity from <paramref name="charIndex" /> to the end of the array to accommodate the resulting characters.</exception>
1043 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
1045 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1047 <member name="M:System.Text.UTF7Encoding.GetDecoder">
1048 <summary>Obtains a decoder that converts a UTF-7 encoded sequence of bytes into a sequence of Unicode characters.</summary>
1049 <returns>A <see cref="T:System.Text.Decoder" /> that converts a UTF-7 encoded sequence of bytes into a sequence of Unicode characters.</returns>
1051 <member name="M:System.Text.UTF7Encoding.GetEncoder">
1052 <summary>Obtains an encoder that converts a sequence of Unicode characters into a UTF-7 encoded sequence of bytes.</summary>
1053 <returns>A <see cref="T:System.Text.Encoder" /> that converts a sequence of Unicode characters into a UTF-7 encoded sequence of bytes.</returns>
1055 <member name="M:System.Text.UTF7Encoding.GetHashCode">
1056 <summary>Returns the hash code for the current <see cref="T:System.Text.UTF7Encoding" /> object.</summary>
1057 <returns>A 32-bit signed integer hash code.</returns>
1059 <member name="M:System.Text.UTF7Encoding.GetMaxByteCount(System.Int32)">
1060 <summary>Calculates the maximum number of bytes produced by encoding the specified number of characters.</summary>
1061 <param name="charCount">The number of characters to encode.</param>
1062 <returns>The maximum number of bytes produced by encoding the specified number of characters.</returns>
1063 <exception cref="T:System.ArgumentOutOfRangeException">
1064 <paramref name="charCount" /> is less than zero.
1066 The resulting number of bytes is greater than the maximum number that can be returned as an int.</exception>
1067 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
1069 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1071 <member name="M:System.Text.UTF7Encoding.GetMaxCharCount(System.Int32)">
1072 <summary>Calculates the maximum number of characters produced by decoding the specified number of bytes.</summary>
1073 <param name="byteCount">The number of bytes to decode.</param>
1074 <returns>The maximum number of characters produced by decoding the specified number of bytes.</returns>
1075 <exception cref="T:System.ArgumentOutOfRangeException">
1076 <paramref name="byteCount" /> is less than zero.
1078 The resulting number of characters is greater than the maximum number that can be returned as an int.</exception>
1079 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
1081 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1083 <member name="M:System.Text.UTF7Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
1084 <summary>Decodes a range of bytes from a byte array into a string.</summary>
1085 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
1086 <param name="index">The index of the first byte to decode.</param>
1087 <param name="count">The number of bytes to decode.</param>
1088 <returns>A <see cref="T:System.String" /> containing the results of decoding the specified sequence of bytes.</returns>
1089 <exception cref="T:System.ArgumentNullException">
1090 <paramref name="bytes" /> is <see langword="null" /> (<see langword="Nothing" />).</exception>
1091 <exception cref="T:System.ArgumentOutOfRangeException">
1092 <paramref name="index" /> or <paramref name="count" /> is less than zero.
1094 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.</exception>
1095 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
1097 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1099 <member name="T:System.Text.UTF8Encoding">
1100 <summary>Represents a UTF-8 encoding of Unicode characters.</summary>
1102 <member name="M:System.Text.UTF8Encoding.#ctor">
1103 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF8Encoding" /> class.</summary>
1105 <member name="M:System.Text.UTF8Encoding.#ctor(System.Boolean)">
1106 <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>
1107 <param name="encoderShouldEmitUTF8Identifier">
1108 <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>
1110 <member name="M:System.Text.UTF8Encoding.#ctor(System.Boolean,System.Boolean)">
1111 <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>
1112 <param name="encoderShouldEmitUTF8Identifier">
1113 <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>
1114 <param name="throwOnInvalidBytes">
1115 <see langword="true" /> to throw an exception when an invalid encoding is detected; otherwise, <see langword="false" />.</param>
1117 <member name="M:System.Text.UTF8Encoding.Equals(System.Object)">
1118 <summary>Determines whether the specified object is equal to the current <see cref="T:System.Text.UTF8Encoding" /> object.</summary>
1119 <param name="value">The object to compare with the current instance.</param>
1121 <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>
1123 <member name="M:System.Text.UTF8Encoding.GetByteCount(System.Char*,System.Int32)">
1124 <summary>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</summary>
1125 <param name="chars">A pointer to the first character to encode.</param>
1126 <param name="count">The number of characters to encode.</param>
1127 <returns>The number of bytes produced by encoding the specified characters.</returns>
1128 <exception cref="T:System.ArgumentNullException">
1129 <paramref name="chars" /> is <see langword="null" />.</exception>
1130 <exception cref="T:System.ArgumentOutOfRangeException">
1131 <paramref name="count" /> is less than zero.
1133 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1134 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.</exception>
1135 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for a complete explanation)
1137 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1139 <member name="M:System.Text.UTF8Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
1140 <summary>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</summary>
1141 <param name="chars">The character array containing the set of characters to encode.</param>
1142 <param name="index">The index of the first character to encode.</param>
1143 <param name="count">The number of characters to encode.</param>
1144 <returns>The number of bytes produced by encoding the specified characters.</returns>
1145 <exception cref="T:System.ArgumentNullException">
1146 <paramref name="chars" /> is <see langword="null" />.</exception>
1147 <exception cref="T:System.ArgumentOutOfRangeException">
1148 <paramref name="index" /> or <paramref name="count" /> is less than zero.
1150 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="chars" />.
1152 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1153 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.</exception>
1154 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
1156 The <see cref="P:System.Text.Encoding.EncoderFallback" /> property is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1158 <member name="M:System.Text.UTF8Encoding.GetByteCount(System.ReadOnlySpan{System.Char})">
1159 <summary>Calculates the number of bytes produced by encoding the specified character span.</summary>
1160 <param name="chars">The span that contains the set of characters to encode.</param>
1161 <returns>The number of bytes produced by encoding the specified character span.</returns>
1162 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.</exception>
1163 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
1165 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1167 <member name="M:System.Text.UTF8Encoding.GetByteCount(System.String)">
1168 <summary>Calculates the number of bytes produced by encoding the characters in the specified <see cref="T:System.String" />.</summary>
1169 <param name="chars">The <see cref="T:System.String" /> containing the set of characters to encode.</param>
1170 <returns>The number of bytes produced by encoding the specified characters.</returns>
1171 <exception cref="T:System.ArgumentNullException">
1172 <paramref name="chars" /> is <see langword="null" />.</exception>
1173 <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1174 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.</exception>
1175 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
1177 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1179 <member name="M:System.Text.UTF8Encoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
1180 <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>
1181 <param name="chars">A pointer to the first character to encode.</param>
1182 <param name="charCount">The number of characters to encode.</param>
1183 <param name="bytes">A pointer to the location at which to start writing the resulting sequence of bytes.</param>
1184 <param name="byteCount">The maximum number of bytes to write.</param>
1185 <returns>The actual number of bytes written at the location indicated by <paramref name="bytes" />.</returns>
1186 <exception cref="T:System.ArgumentNullException">
1187 <paramref name="chars" /> is <see langword="null" />.
1189 <paramref name="bytes" /> is <see langword="null" />.</exception>
1190 <exception cref="T:System.ArgumentOutOfRangeException">
1191 <paramref name="charCount" /> or <paramref name="byteCount" /> is less than zero.</exception>
1192 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.
1194 <paramref name="byteCount" /> is less than the resulting number of bytes.</exception>
1195 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
1197 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1199 <member name="M:System.Text.UTF8Encoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
1200 <summary>Encodes a set of characters from the specified character array into the specified byte array.</summary>
1201 <param name="chars">The character array containing the set of characters to encode.</param>
1202 <param name="charIndex">The index of the first character to encode.</param>
1203 <param name="charCount">The number of characters to encode.</param>
1204 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
1205 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
1206 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
1207 <exception cref="T:System.ArgumentNullException">
1208 <paramref name="chars" /> is <see langword="null" />.
1210 <paramref name="bytes" /> is <see langword="null" />.</exception>
1211 <exception cref="T:System.ArgumentOutOfRangeException">
1212 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
1214 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
1216 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
1217 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars" /> contains an invalid sequence of characters.
1219 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
1220 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
1222 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1224 <member name="M:System.Text.UTF8Encoding.GetBytes(System.ReadOnlySpan{System.Char},System.Span{System.Byte})">
1225 <summary>Encodes the specified character span into the specified byte span.</summary>
1226 <param name="chars">The character span to encode.</param>
1227 <param name="bytes">The span to contain the resulting set of bytes.</param>
1228 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
1230 <member name="M:System.Text.UTF8Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
1231 <summary>Encodes a set of characters from the specified <see cref="T:System.String" /> into the specified byte array.</summary>
1232 <param name="s">The <see cref="T:System.String" /> containing the set of characters to encode.</param>
1233 <param name="charIndex">The index of the first character to encode.</param>
1234 <param name="charCount">The number of characters to encode.</param>
1235 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
1236 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
1237 <returns>The actual number of bytes written into <paramref name="bytes" />.</returns>
1238 <exception cref="T:System.ArgumentNullException">
1239 <paramref name="s" /> is <see langword="null" />.
1241 <paramref name="bytes" /> is <see langword="null" />.</exception>
1242 <exception cref="T:System.ArgumentOutOfRangeException">
1243 <paramref name="charIndex" /> or <paramref name="charCount" /> or <paramref name="byteIndex" /> is less than zero.
1245 <paramref name="charIndex" /> and <paramref name="charCount" /> do not denote a valid range in <paramref name="chars" />.
1247 <paramref name="byteIndex" /> is not a valid index in <paramref name="bytes" />.</exception>
1248 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s" /> contains an invalid sequence of characters.
1250 <paramref name="bytes" /> does not have enough capacity from <paramref name="byteIndex" /> to the end of the array to accommodate the resulting bytes.</exception>
1251 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
1253 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1255 <member name="M:System.Text.UTF8Encoding.GetCharCount(System.Byte*,System.Int32)">
1256 <summary>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</summary>
1257 <param name="bytes">A pointer to the first byte to decode.</param>
1258 <param name="count">The number of bytes to decode.</param>
1259 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
1260 <exception cref="T:System.ArgumentNullException">
1261 <paramref name="bytes" /> is <see langword="null" />.</exception>
1262 <exception cref="T:System.ArgumentOutOfRangeException">
1263 <paramref name="count" /> is less than zero.
1265 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1266 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
1267 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
1269 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1271 <member name="M:System.Text.UTF8Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
1272 <summary>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</summary>
1273 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
1274 <param name="index">The index of the first byte to decode.</param>
1275 <param name="count">The number of bytes to decode.</param>
1276 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
1277 <exception cref="T:System.ArgumentNullException">
1278 <paramref name="bytes" /> is <see langword="null" />.</exception>
1279 <exception cref="T:System.ArgumentOutOfRangeException">
1280 <paramref name="index" /> or <paramref name="count" /> is less than zero.
1282 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.
1284 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1285 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
1286 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
1288 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1290 <member name="M:System.Text.UTF8Encoding.GetCharCount(System.ReadOnlySpan{System.Byte})">
1291 <summary>Calculates the number of characters produced by decoding the specified byte span.</summary>
1292 <param name="bytes">The span containing the set of bytes to decode.</param>
1293 <returns>The number of characters produced by decoding the specified byte span.</returns>
1295 <member name="M:System.Text.UTF8Encoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
1296 <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>
1297 <param name="bytes">A pointer to the first byte to decode.</param>
1298 <param name="byteCount">The number of bytes to decode.</param>
1299 <param name="chars">A pointer to the location at which to start writing the resulting set of characters.</param>
1300 <param name="charCount">The maximum number of characters to write.</param>
1301 <returns>The actual number of characters written at the location indicated by <paramref name="chars" />.</returns>
1302 <exception cref="T:System.ArgumentNullException">
1303 <paramref name="bytes" /> is <see langword="null" />.
1305 <paramref name="chars" /> is <see langword="null" />.</exception>
1306 <exception cref="T:System.ArgumentOutOfRangeException">
1307 <paramref name="byteCount" /> or <paramref name="charCount" /> is less than zero.</exception>
1308 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.
1310 <paramref name="charCount" /> is less than the resulting number of characters.</exception>
1311 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
1313 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1315 <member name="M:System.Text.UTF8Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
1316 <summary>Decodes a sequence of bytes from the specified byte array into the specified character array.</summary>
1317 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
1318 <param name="byteIndex">The index of the first byte to decode.</param>
1319 <param name="byteCount">The number of bytes to decode.</param>
1320 <param name="chars">The character array to contain the resulting set of characters.</param>
1321 <param name="charIndex">The index at which to start writing the resulting set of characters.</param>
1322 <returns>The actual number of characters written into <paramref name="chars" />.</returns>
1323 <exception cref="T:System.ArgumentNullException">
1324 <paramref name="bytes" /> is <see langword="null" />.
1326 <paramref name="chars" /> is <see langword="null" />.</exception>
1327 <exception cref="T:System.ArgumentOutOfRangeException">
1328 <paramref name="byteIndex" /> or <paramref name="byteCount" /> or <paramref name="charIndex" /> is less than zero.
1330 <paramref name="byteindex" /> and <paramref name="byteCount" /> do not denote a valid range in <paramref name="bytes" />.
1332 <paramref name="charIndex" /> is not a valid index in <paramref name="chars" />.</exception>
1333 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.
1335 <paramref name="chars" /> does not have enough capacity from <paramref name="charIndex" /> to the end of the array to accommodate the resulting characters.</exception>
1336 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
1338 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1340 <member name="M:System.Text.UTF8Encoding.GetChars(System.ReadOnlySpan{System.Byte},System.Span{System.Char})">
1341 <summary>Decodes the specified byte span into the specified character span.</summary>
1342 <param name="bytes">The span containing the bytes to decode.</param>
1343 <param name="chars">The span to contain the resulting set of characters.</param>
1344 <returns>The actual number of characters written into <paramref name="chars" />.</returns>
1346 <member name="M:System.Text.UTF8Encoding.GetDecoder">
1347 <summary>Obtains a decoder that converts a UTF-8 encoded sequence of bytes into a sequence of Unicode characters.</summary>
1348 <returns>A decoder that converts a UTF-8 encoded sequence of bytes into a sequence of Unicode characters.</returns>
1350 <member name="M:System.Text.UTF8Encoding.GetEncoder">
1351 <summary>Obtains an encoder that converts a sequence of Unicode characters into a UTF-8 encoded sequence of bytes.</summary>
1352 <returns>A <see cref="T:System.Text.Encoder" /> that converts a sequence of Unicode characters into a UTF-8 encoded sequence of bytes.</returns>
1354 <member name="M:System.Text.UTF8Encoding.GetHashCode">
1355 <summary>Returns the hash code for the current instance.</summary>
1356 <returns>The hash code for the current instance.</returns>
1358 <member name="M:System.Text.UTF8Encoding.GetMaxByteCount(System.Int32)">
1359 <summary>Calculates the maximum number of bytes produced by encoding the specified number of characters.</summary>
1360 <param name="charCount">The number of characters to encode.</param>
1361 <returns>The maximum number of bytes produced by encoding the specified number of characters.</returns>
1362 <exception cref="T:System.ArgumentOutOfRangeException">
1363 <paramref name="charCount" /> is less than zero.
1365 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1366 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
1368 <see cref="P:System.Text.Encoding.EncoderFallback" /> is set to <see cref="T:System.Text.EncoderExceptionFallback" />.</exception>
1370 <member name="M:System.Text.UTF8Encoding.GetMaxCharCount(System.Int32)">
1371 <summary>Calculates the maximum number of characters produced by decoding the specified number of bytes.</summary>
1372 <param name="byteCount">The number of bytes to decode.</param>
1373 <returns>The maximum number of characters produced by decoding the specified number of bytes.</returns>
1374 <exception cref="T:System.ArgumentOutOfRangeException">
1375 <paramref name="byteCount" /> is less than zero.
1377 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1378 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
1380 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1382 <member name="M:System.Text.UTF8Encoding.GetPreamble">
1383 <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>
1384 <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>
1386 <member name="M:System.Text.UTF8Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
1387 <summary>Decodes a range of bytes from a byte array into a string.</summary>
1388 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
1389 <param name="index">The index of the first byte to decode.</param>
1390 <param name="count">The number of bytes to decode.</param>
1391 <returns>A <see cref="T:System.String" /> containing the results of decoding the specified sequence of bytes.</returns>
1392 <exception cref="T:System.ArgumentNullException">
1393 <paramref name="bytes" /> is <see langword="null" />.</exception>
1394 <exception cref="T:System.ArgumentOutOfRangeException">
1395 <paramref name="index" /> or <paramref name="count" /> is less than zero.
1397 <paramref name="index" /> and <paramref name="count" /> do not denote a valid range in <paramref name="bytes" />.</exception>
1398 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes" /> contains an invalid sequence of bytes.</exception>
1399 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
1401 <see cref="P:System.Text.Encoding.DecoderFallback" /> is set to <see cref="T:System.Text.DecoderExceptionFallback" />.</exception>
1403 <member name="P:System.Text.UTF8Encoding.Preamble">
1404 <summary>Gets a Unicode byte order mark encoded in UTF-8 format, if this object is configured to supply one.</summary>
1405 <returns>A byte span containing the Unicode byte order mark, if this object is configured to supply one; otherwise, the default span.</returns>