1 <?xml version="1.0" encoding="utf-8"?><doc>
3 <name>System.Text.Encoding.Extensions</name>
6 <member name="T:System.Text.ASCIIEncoding">
7 <summary>Represents an ASCII character encoding of Unicode characters.</summary>
9 <member name="M:System.Text.ASCIIEncoding.#ctor">
10 <summary>Initializes a new instance of the <see cref="T:System.Text.ASCIIEncoding"></see> class.</summary>
12 <member name="M:System.Text.ASCIIEncoding.GetByteCount(System.String)">
13 <summary>Calculates the number of bytes produced by encoding the characters in the specified <see cref="T:System.String"></see>.</summary>
14 <param name="chars">The <see cref="T:System.String"></see> containing the set of characters to encode.</param>
15 <returns>The number of bytes produced by encoding the specified characters.</returns>
16 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see>.</exception>
17 <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
18 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
20 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
22 <member name="M:System.Text.ASCIIEncoding.GetByteCount(System.Char*,System.Int32)">
23 <summary>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</summary>
24 <param name="chars">A pointer to the first character to encode.</param>
25 <param name="count">The number of characters to encode.</param>
26 <returns>The number of bytes produced by encoding the specified characters.</returns>
27 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see>.</exception>
28 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="count">count</paramref> is less than zero.
30 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
31 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
33 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
35 <member name="M:System.Text.ASCIIEncoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
36 <summary>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</summary>
37 <param name="chars">The character array containing the set of characters to encode.</param>
38 <param name="index">The index of the first character to encode.</param>
39 <param name="count">The number of characters to encode.</param>
40 <returns>The number of bytes produced by encoding the specified characters.</returns>
41 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see>.</exception>
42 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index">index</paramref> or <paramref name="count">count</paramref> is less than zero.
44 <paramref name="index">index</paramref> and <paramref name="count">count</paramref> do not denote a valid range in <paramref name="chars">chars</paramref>.
46 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
47 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
49 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
51 <member name="M:System.Text.ASCIIEncoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
52 <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>
53 <param name="chars">A pointer to the first character to encode.</param>
54 <param name="charCount">The number of characters to encode.</param>
55 <param name="bytes">A pointer to the location at which to start writing the resulting sequence of bytes.</param>
56 <param name="byteCount">The maximum number of bytes to write.</param>
57 <returns>The actual number of bytes written at the location indicated by <paramref name="bytes">bytes</paramref>.</returns>
58 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see>.
60 <paramref name="bytes">bytes</paramref> is <see langword="null"></see>.</exception>
61 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charCount">charCount</paramref> or <paramref name="byteCount">byteCount</paramref> is less than zero.</exception>
62 <exception cref="T:System.ArgumentException"><paramref name="byteCount">byteCount</paramref> is less than the resulting number of bytes.</exception>
63 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
65 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
67 <member name="M:System.Text.ASCIIEncoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
68 <summary>Encodes a set of characters from the specified character array into the specified byte array.</summary>
69 <param name="chars">The character array containing the set of characters to encode.</param>
70 <param name="charIndex">The index of the first character to encode.</param>
71 <param name="charCount">The number of characters to encode.</param>
72 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
73 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
74 <returns>The actual number of bytes written into <paramref name="bytes">bytes</paramref>.</returns>
75 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see>.
77 <paramref name="bytes">bytes</paramref> is <see langword="null"></see>.</exception>
78 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charIndex">charIndex</paramref> or <paramref name="charCount">charCount</paramref> or <paramref name="byteIndex">byteIndex</paramref> is less than zero.
80 <paramref name="charIndex">charIndex</paramref> and <paramref name="charCount">charCount</paramref> do not denote a valid range in <paramref name="chars">chars</paramref>.
82 <paramref name="byteIndex">byteIndex</paramref> is not a valid index in <paramref name="bytes">bytes</paramref>.</exception>
83 <exception cref="T:System.ArgumentException"><paramref name="bytes">bytes</paramref> does not have enough capacity from <paramref name="byteIndex">byteIndex</paramref> to the end of the array to accommodate the resulting bytes.</exception>
84 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
86 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
88 <member name="M:System.Text.ASCIIEncoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
89 <summary>Encodes a set of characters from the specified <see cref="T:System.String"></see> into the specified byte array.</summary>
90 <param name="chars">The <see cref="T:System.String"></see> containing the set of characters to encode.</param>
91 <param name="charIndex">The index of the first character to encode.</param>
92 <param name="charCount">The number of characters to encode.</param>
93 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
94 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
95 <returns>The actual number of bytes written into <paramref name="bytes">bytes</paramref>.</returns>
96 <exception cref="T:System.ArgumentNullException"><paramref name="s">s</paramref> is <see langword="null"></see>.
98 <paramref name="bytes">bytes</paramref> is <see langword="null"></see>.</exception>
99 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charIndex">charIndex</paramref> or <paramref name="charCount">charCount</paramref> or <paramref name="byteIndex">byteIndex</paramref> is less than zero.
101 <paramref name="charIndex">charIndex</paramref> and <paramref name="charCount">charCount</paramref> do not denote a valid range in <paramref name="chars">chars</paramref>.
103 <paramref name="byteIndex">byteIndex</paramref> is not a valid index in <paramref name="bytes">bytes</paramref>.</exception>
104 <exception cref="T:System.ArgumentException"><paramref name="bytes">bytes</paramref> does not have enough capacity from <paramref name="byteIndex">byteIndex</paramref> to the end of the array to accommodate the resulting bytes.</exception>
105 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
107 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
109 <member name="M:System.Text.ASCIIEncoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
110 <summary>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</summary>
111 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
112 <param name="index">The index of the first byte to decode.</param>
113 <param name="count">The number of bytes to decode.</param>
114 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
115 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see>.</exception>
116 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index">index</paramref> or <paramref name="count">count</paramref> is less than zero.
118 <paramref name="index">index</paramref> and <paramref name="count">count</paramref> do not denote a valid range in <paramref name="bytes">bytes</paramref>.
120 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
121 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
123 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
125 <member name="M:System.Text.ASCIIEncoding.GetCharCount(System.Byte*,System.Int32)">
126 <summary>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</summary>
127 <param name="bytes">A pointer to the first byte to decode.</param>
128 <param name="count">The number of bytes to decode.</param>
129 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
130 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see>.</exception>
131 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="count">count</paramref> is less than zero.
133 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
134 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
136 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
138 <member name="M:System.Text.ASCIIEncoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
139 <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>
140 <param name="bytes">A pointer to the first byte to decode.</param>
141 <param name="byteCount">The number of bytes to decode.</param>
142 <param name="chars">A pointer to the location at which to start writing the resulting set of characters.</param>
143 <param name="charCount">The maximum number of characters to write.</param>
144 <returns>The actual number of characters written at the location indicated by <paramref name="chars">chars</paramref>.</returns>
145 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see>.
147 <paramref name="chars">chars</paramref> is <see langword="null"></see>.</exception>
148 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="byteCount">byteCount</paramref> or <paramref name="charCount">charCount</paramref> is less than zero.</exception>
149 <exception cref="T:System.ArgumentException"><paramref name="charCount">charCount</paramref> is less than the resulting number of characters.</exception>
150 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
152 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
154 <member name="M:System.Text.ASCIIEncoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
155 <summary>Decodes a sequence of bytes from the specified byte array into the specified character array.</summary>
156 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
157 <param name="byteIndex">The index of the first byte to decode.</param>
158 <param name="byteCount">The number of bytes to decode.</param>
159 <param name="chars">The character array to contain the resulting set of characters.</param>
160 <param name="charIndex">The index at which to start writing the resulting set of characters.</param>
161 <returns>The actual number of characters written into <paramref name="chars">chars</paramref>.</returns>
162 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see>.
164 <paramref name="chars">chars</paramref> is <see langword="null"></see>.</exception>
165 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="byteIndex">byteIndex</paramref> or <paramref name="byteCount">byteCount</paramref> or <paramref name="charIndex">charIndex</paramref> is less than zero.
167 <paramref name="byteindex">byteindex</paramref> and <paramref name="byteCount">byteCount</paramref> do not denote a valid range in <paramref name="bytes">bytes</paramref>.
169 <paramref name="charIndex">charIndex</paramref> is not a valid index in <paramref name="chars">chars</paramref>.</exception>
170 <exception cref="T:System.ArgumentException"><paramref name="chars">chars</paramref> does not have enough capacity from <paramref name="charIndex">charIndex</paramref> to the end of the array to accommodate the resulting characters.</exception>
171 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
173 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
175 <member name="M:System.Text.ASCIIEncoding.GetDecoder">
176 <summary>Obtains a decoder that converts an ASCII encoded sequence of bytes into a sequence of Unicode characters.</summary>
177 <returns>A <see cref="T:System.Text.Decoder"></see> that converts an ASCII encoded sequence of bytes into a sequence of Unicode characters.</returns>
179 <member name="M:System.Text.ASCIIEncoding.GetEncoder">
180 <summary>Obtains an encoder that converts a sequence of Unicode characters into an ASCII encoded sequence of bytes.</summary>
181 <returns>An <see cref="T:System.Text.Encoder"></see> that converts a sequence of Unicode characters into an ASCII encoded sequence of bytes.</returns>
183 <member name="M:System.Text.ASCIIEncoding.GetMaxByteCount(System.Int32)">
184 <summary>Calculates the maximum number of bytes produced by encoding the specified number of characters.</summary>
185 <param name="charCount">The number of characters to encode.</param>
186 <returns>The maximum number of bytes produced by encoding the specified number of characters.</returns>
187 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charCount">charCount</paramref> is less than zero.
189 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
191 <member name="M:System.Text.ASCIIEncoding.GetMaxCharCount(System.Int32)">
192 <summary>Calculates the maximum number of characters produced by decoding the specified number of bytes.</summary>
193 <param name="byteCount">The number of bytes to decode.</param>
194 <returns>The maximum number of characters produced by decoding the specified number of bytes.</returns>
195 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="byteCount">byteCount</paramref> is less than zero.
197 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
199 <member name="M:System.Text.ASCIIEncoding.GetString(System.Byte[],System.Int32,System.Int32)">
200 <summary>Decodes a range of bytes from a byte array into a string.</summary>
201 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
202 <param name="byteIndex">The index of the first byte to decode.</param>
203 <param name="byteCount">The number of bytes to decode.</param>
204 <returns>A <see cref="T:System.String"></see> containing the results of decoding the specified sequence of bytes.</returns>
205 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see>.</exception>
206 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index">index</paramref> or <paramref name="count">count</paramref> is less than zero.
208 <paramref name="index">index</paramref> and <paramref name="count">count</paramref> do not denote a valid range in <paramref name="bytes">bytes</paramref>.</exception>
209 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
211 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
213 <member name="P:System.Text.ASCIIEncoding.IsSingleByte">
214 <summary>Gets a value indicating whether the current encoding uses single-byte code points.</summary>
215 <returns>This property is always <see langword="true"></see>.</returns>
217 <member name="T:System.Text.UTF8Encoding">
218 <summary>Represents a UTF-8 encoding of Unicode characters.</summary>
220 <member name="M:System.Text.UTF8Encoding.#ctor">
221 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF8Encoding"></see> class.</summary>
223 <member name="M:System.Text.UTF8Encoding.#ctor(System.Boolean)">
224 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF8Encoding"></see> class. A parameter specifies whether to provide a Unicode byte order mark.</summary>
225 <param name="encoderShouldEmitUTF8Identifier"><see langword="true"></see> to specify that the <see cref="M:System.Text.UTF8Encoding.GetPreamble"></see> method returns a Unicode byte order mark; otherwise, <see langword="false"></see>.</param>
227 <member name="M:System.Text.UTF8Encoding.#ctor(System.Boolean,System.Boolean)">
228 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF8Encoding"></see> class. Parameters specify whether to provide a Unicode byte order mark and whether to throw an exception when an invalid encoding is detected.</summary>
229 <param name="encoderShouldEmitUTF8Identifier"><see langword="true"></see> to specify that the <see cref="M:System.Text.UTF8Encoding.GetPreamble"></see> method should return a Unicode byte order mark; otherwise, <see langword="false"></see>.</param>
230 <param name="throwOnInvalidBytes"><see langword="true"></see> to throw an exception when an invalid encoding is detected; otherwise, <see langword="false"></see>.</param>
232 <member name="M:System.Text.UTF8Encoding.Equals(System.Object)">
233 <summary>Determines whether the specified object is equal to the current <see cref="T:System.Text.UTF8Encoding"></see> object.</summary>
234 <param name="value">The object to compare with the current instance.</param>
235 <returns><see langword="true"></see> if <paramref name="value">value</paramref> is an instance of <see cref="T:System.Text.UTF8Encoding"></see> and is equal to the current object; otherwise, <see langword="false"></see>.</returns>
237 <member name="M:System.Text.UTF8Encoding.GetByteCount(System.String)">
238 <summary>Calculates the number of bytes produced by encoding the characters in the specified <see cref="T:System.String"></see>.</summary>
239 <param name="chars">The <see cref="T:System.String"></see> containing the set of characters to encode.</param>
240 <returns>The number of bytes produced by encoding the specified characters.</returns>
241 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see>.</exception>
242 <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
243 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars">chars</paramref> contains an invalid sequence of characters.</exception>
244 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
246 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
248 <member name="M:System.Text.UTF8Encoding.GetByteCount(System.Char*,System.Int32)">
249 <summary>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</summary>
250 <param name="chars">A pointer to the first character to encode.</param>
251 <param name="count">The number of characters to encode.</param>
252 <returns>The number of bytes produced by encoding the specified characters.</returns>
253 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see>.</exception>
254 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="count">count</paramref> is less than zero.
256 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
257 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars">chars</paramref> contains an invalid sequence of characters.</exception>
258 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for a complete explanation)
260 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
262 <member name="M:System.Text.UTF8Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
263 <summary>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</summary>
264 <param name="chars">The character array containing the set of characters to encode.</param>
265 <param name="index">The index of the first character to encode.</param>
266 <param name="count">The number of characters to encode.</param>
267 <returns>The number of bytes produced by encoding the specified characters.</returns>
268 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see>.</exception>
269 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index">index</paramref> or <paramref name="count">count</paramref> is less than zero.
271 <paramref name="index">index</paramref> and <paramref name="count">count</paramref> do not denote a valid range in <paramref name="chars">chars</paramref>.
273 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
274 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars">chars</paramref> contains an invalid sequence of characters.</exception>
275 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
277 The <see cref="System.Text.Encoding.EncoderFallback"></see> property is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
279 <member name="M:System.Text.UTF8Encoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
280 <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>
281 <param name="chars">A pointer to the first character to encode.</param>
282 <param name="charCount">The number of characters to encode.</param>
283 <param name="bytes">A pointer to the location at which to start writing the resulting sequence of bytes.</param>
284 <param name="byteCount">The maximum number of bytes to write.</param>
285 <returns>The actual number of bytes written at the location indicated by <paramref name="bytes">bytes</paramref>.</returns>
286 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see>.
288 <paramref name="bytes">bytes</paramref> is <see langword="null"></see>.</exception>
289 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charCount">charCount</paramref> or <paramref name="byteCount">byteCount</paramref> is less than zero.</exception>
290 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars">chars</paramref> contains an invalid sequence of characters.
292 <paramref name="byteCount">byteCount</paramref> is less than the resulting number of bytes.</exception>
293 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
295 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
297 <member name="M:System.Text.UTF8Encoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
298 <summary>Encodes a set of characters from the specified character array into the specified byte array.</summary>
299 <param name="chars">The character array containing the set of characters to encode.</param>
300 <param name="charIndex">The index of the first character to encode.</param>
301 <param name="charCount">The number of characters to encode.</param>
302 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
303 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
304 <returns>The actual number of bytes written into <paramref name="bytes">bytes</paramref>.</returns>
305 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see>.
307 <paramref name="bytes">bytes</paramref> is <see langword="null"></see>.</exception>
308 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charIndex">charIndex</paramref> or <paramref name="charCount">charCount</paramref> or <paramref name="byteIndex">byteIndex</paramref> is less than zero.
310 <paramref name="charIndex">charIndex</paramref> and <paramref name="charCount">charCount</paramref> do not denote a valid range in <paramref name="chars">chars</paramref>.
312 <paramref name="byteIndex">byteIndex</paramref> is not a valid index in <paramref name="bytes">bytes</paramref>.</exception>
313 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars">chars</paramref> contains an invalid sequence of characters.
315 <paramref name="bytes">bytes</paramref> does not have enough capacity from <paramref name="byteIndex">byteIndex</paramref> to the end of the array to accommodate the resulting bytes.</exception>
316 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
318 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
320 <member name="M:System.Text.UTF8Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
321 <summary>Encodes a set of characters from the specified <see cref="T:System.String"></see> into the specified byte array.</summary>
322 <param name="s">The <see cref="T:System.String"></see> containing the set of characters to encode.</param>
323 <param name="charIndex">The index of the first character to encode.</param>
324 <param name="charCount">The number of characters to encode.</param>
325 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
326 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
327 <returns>The actual number of bytes written into <paramref name="bytes">bytes</paramref>.</returns>
328 <exception cref="T:System.ArgumentNullException"><paramref name="s">s</paramref> is <see langword="null"></see>.
330 <paramref name="bytes">bytes</paramref> is <see langword="null"></see>.</exception>
331 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charIndex">charIndex</paramref> or <paramref name="charCount">charCount</paramref> or <paramref name="byteIndex">byteIndex</paramref> is less than zero.
333 <paramref name="charIndex">charIndex</paramref> and <paramref name="charCount">charCount</paramref> do not denote a valid range in <paramref name="chars">chars</paramref>.
335 <paramref name="byteIndex">byteIndex</paramref> is not a valid index in <paramref name="bytes">bytes</paramref>.</exception>
336 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s">s</paramref> contains an invalid sequence of characters.
338 <paramref name="bytes">bytes</paramref> does not have enough capacity from <paramref name="byteIndex">byteIndex</paramref> to the end of the array to accommodate the resulting bytes.</exception>
339 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
341 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
343 <member name="M:System.Text.UTF8Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
344 <summary>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</summary>
345 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
346 <param name="index">The index of the first byte to decode.</param>
347 <param name="count">The number of bytes to decode.</param>
348 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
349 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see>.</exception>
350 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index">index</paramref> or <paramref name="count">count</paramref> is less than zero.
352 <paramref name="index">index</paramref> and <paramref name="count">count</paramref> do not denote a valid range in <paramref name="bytes">bytes</paramref>.
354 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
355 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes">bytes</paramref> contains an invalid sequence of bytes.</exception>
356 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
358 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
360 <member name="M:System.Text.UTF8Encoding.GetCharCount(System.Byte*,System.Int32)">
361 <summary>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</summary>
362 <param name="bytes">A pointer to the first byte to decode.</param>
363 <param name="count">The number of bytes to decode.</param>
364 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
365 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see>.</exception>
366 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="count">count</paramref> is less than zero.
368 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
369 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes">bytes</paramref> contains an invalid sequence of bytes.</exception>
370 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
372 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
374 <member name="M:System.Text.UTF8Encoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
375 <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>
376 <param name="bytes">A pointer to the first byte to decode.</param>
377 <param name="byteCount">The number of bytes to decode.</param>
378 <param name="chars">A pointer to the location at which to start writing the resulting set of characters.</param>
379 <param name="charCount">The maximum number of characters to write.</param>
380 <returns>The actual number of characters written at the location indicated by <paramref name="chars">chars</paramref>.</returns>
381 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see>.
383 <paramref name="chars">chars</paramref> is <see langword="null"></see>.</exception>
384 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="byteCount">byteCount</paramref> or <paramref name="charCount">charCount</paramref> is less than zero.</exception>
385 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes">bytes</paramref> contains an invalid sequence of bytes.
387 <paramref name="charCount">charCount</paramref> is less than the resulting number of characters.</exception>
388 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
390 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
392 <member name="M:System.Text.UTF8Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
393 <summary>Decodes a sequence of bytes from the specified byte array into the specified character array.</summary>
394 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
395 <param name="byteIndex">The index of the first byte to decode.</param>
396 <param name="byteCount">The number of bytes to decode.</param>
397 <param name="chars">The character array to contain the resulting set of characters.</param>
398 <param name="charIndex">The index at which to start writing the resulting set of characters.</param>
399 <returns>The actual number of characters written into <paramref name="chars">chars</paramref>.</returns>
400 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see>.
402 <paramref name="chars">chars</paramref> is <see langword="null"></see>.</exception>
403 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="byteIndex">byteIndex</paramref> or <paramref name="byteCount">byteCount</paramref> or <paramref name="charIndex">charIndex</paramref> is less than zero.
405 <paramref name="byteindex">byteindex</paramref> and <paramref name="byteCount">byteCount</paramref> do not denote a valid range in <paramref name="bytes">bytes</paramref>.
407 <paramref name="charIndex">charIndex</paramref> is not a valid index in <paramref name="chars">chars</paramref>.</exception>
408 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes">bytes</paramref> contains an invalid sequence of bytes.
410 <paramref name="chars">chars</paramref> does not have enough capacity from <paramref name="charIndex">charIndex</paramref> to the end of the array to accommodate the resulting characters.</exception>
411 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
413 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
415 <member name="M:System.Text.UTF8Encoding.GetDecoder">
416 <summary>Obtains a decoder that converts a UTF-8 encoded sequence of bytes into a sequence of Unicode characters.</summary>
417 <returns>A decoder that converts a UTF-8 encoded sequence of bytes into a sequence of Unicode characters.</returns>
419 <member name="M:System.Text.UTF8Encoding.GetEncoder">
420 <summary>Obtains an encoder that converts a sequence of Unicode characters into a UTF-8 encoded sequence of bytes.</summary>
421 <returns>A <see cref="T:System.Text.Encoder"></see> that converts a sequence of Unicode characters into a UTF-8 encoded sequence of bytes.</returns>
423 <member name="M:System.Text.UTF8Encoding.GetHashCode">
424 <summary>Returns the hash code for the current instance.</summary>
425 <returns>The hash code for the current instance.</returns>
427 <member name="M:System.Text.UTF8Encoding.GetMaxByteCount(System.Int32)">
428 <summary>Calculates the maximum number of bytes produced by encoding the specified number of characters.</summary>
429 <param name="charCount">The number of characters to encode.</param>
430 <returns>The maximum number of bytes produced by encoding the specified number of characters.</returns>
431 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charCount">charCount</paramref> is less than zero.
433 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
434 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
436 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
438 <member name="M:System.Text.UTF8Encoding.GetMaxCharCount(System.Int32)">
439 <summary>Calculates the maximum number of characters produced by decoding the specified number of bytes.</summary>
440 <param name="byteCount">The number of bytes to decode.</param>
441 <returns>The maximum number of characters produced by decoding the specified number of bytes.</returns>
442 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="byteCount">byteCount</paramref> is less than zero.
444 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
445 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
447 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
449 <member name="M:System.Text.UTF8Encoding.GetPreamble">
450 <summary>Returns a Unicode byte order mark encoded in UTF-8 format, if the <see cref="T:System.Text.UTF8Encoding"></see> encoding object is configured to supply one.</summary>
451 <returns>A byte array containing the Unicode byte order mark, if the <see cref="T:System.Text.UTF8Encoding"></see> encoding object is configured to supply one. Otherwise, this method returns a zero-length byte array.</returns>
453 <member name="M:System.Text.UTF8Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
454 <summary>Decodes a range of bytes from a byte array into a string.</summary>
455 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
456 <param name="index">The index of the first byte to decode.</param>
457 <param name="count">The number of bytes to decode.</param>
458 <returns>A <see cref="T:System.String"></see> containing the results of decoding the specified sequence of bytes.</returns>
459 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see>.</exception>
460 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index">index</paramref> or <paramref name="count">count</paramref> is less than zero.
462 <paramref name="index">index</paramref> and <paramref name="count">count</paramref> do not denote a valid range in <paramref name="bytes">bytes</paramref>.</exception>
463 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes">bytes</paramref> contains an invalid sequence of bytes.</exception>
464 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
466 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
468 <member name="T:System.Text.UTF7Encoding">
469 <summary>Represents a UTF-7 encoding of Unicode characters.</summary>
471 <member name="M:System.Text.UTF7Encoding.#ctor">
472 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF7Encoding"></see> class.</summary>
474 <member name="M:System.Text.UTF7Encoding.#ctor(System.Boolean)">
475 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF7Encoding"></see> class. A parameter specifies whether to allow optional characters.</summary>
476 <param name="allowOptionals"><see langword="true"></see> to specify that optional characters are allowed; otherwise, <see langword="false"></see>.</param>
478 <member name="M:System.Text.UTF7Encoding.Equals(System.Object)">
479 <summary>Gets a value indicating whether the specified object is equal to the current <see cref="T:System.Text.UTF7Encoding"></see> object.</summary>
480 <param name="value">An object to compare to the current <see cref="T:System.Text.UTF7Encoding"></see> object.</param>
481 <returns><see langword="true"></see> if <paramref name="value">value</paramref> is a <see cref="T:System.Text.UTF7Encoding"></see> object and is equal to the current <see cref="T:System.Text.UTF7Encoding"></see> object; otherwise, <see langword="false"></see>.</returns>
483 <member name="M:System.Text.UTF7Encoding.GetByteCount(System.String)">
484 <summary>Calculates the number of bytes produced by encoding the characters in the specified <see cref="T:System.String"></see> object.</summary>
485 <param name="s">The <see cref="T:System.String"></see> object containing the set of characters to encode.</param>
486 <returns>The number of bytes produced by encoding the specified characters.</returns>
487 <exception cref="T:System.ArgumentNullException"><paramref name="s">s</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
488 <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an int.</exception>
489 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
491 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
493 <member name="M:System.Text.UTF7Encoding.GetByteCount(System.Char*,System.Int32)">
494 <summary>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</summary>
495 <param name="chars">A pointer to the first character to encode.</param>
496 <param name="count">The number of characters to encode.</param>
497 <returns>The number of bytes produced by encoding the specified characters.</returns>
498 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see> (<see langword="Nothing"></see> in Visual Basic .NET).</exception>
499 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="count">count</paramref> is less than zero.
501 The resulting number of bytes is greater than the maximum number that can be returned as an int.</exception>
502 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
504 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
506 <member name="M:System.Text.UTF7Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
507 <summary>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</summary>
508 <param name="chars">The character array containing the set of characters to encode.</param>
509 <param name="index">The index of the first character to encode.</param>
510 <param name="count">The number of characters to encode.</param>
511 <returns>The number of bytes produced by encoding the specified characters.</returns>
512 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
513 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index">index</paramref> or <paramref name="count">count</paramref> is less than zero.
515 <paramref name="index">index</paramref> and <paramref name="count">count</paramref> do not denote a valid range in <paramref name="chars">chars</paramref>.
517 The resulting number of bytes is greater than the maximum number that can be returned as an int.</exception>
518 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
520 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
522 <member name="M:System.Text.UTF7Encoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
523 <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>
524 <param name="chars">A pointer to the first character to encode.</param>
525 <param name="charCount">The number of characters to encode.</param>
526 <param name="bytes">A pointer to the location at which to start writing the resulting sequence of bytes.</param>
527 <param name="byteCount">The maximum number of bytes to write.</param>
528 <returns>The actual number of bytes written at the location indicated by <paramref name="bytes">bytes</paramref>.</returns>
529 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).
531 <paramref name="bytes">bytes</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
532 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charCount">charCount</paramref> or <paramref name="byteCount">byteCount</paramref> is less than zero.</exception>
533 <exception cref="T:System.ArgumentException"><paramref name="byteCount">byteCount</paramref> is less than the resulting number of bytes.</exception>
534 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
536 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
538 <member name="M:System.Text.UTF7Encoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
539 <summary>Encodes a set of characters from the specified character array into the specified byte array.</summary>
540 <param name="chars">The character array containing the set of characters to encode.</param>
541 <param name="charIndex">The index of the first character to encode.</param>
542 <param name="charCount">The number of characters to encode.</param>
543 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
544 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
545 <returns>The actual number of bytes written into <paramref name="bytes">bytes</paramref>.</returns>
546 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).
548 <paramref name="bytes">bytes</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
549 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charIndex">charIndex</paramref> or <paramref name="charCount">charCount</paramref> or <paramref name="byteIndex">byteIndex</paramref> is less than zero.
551 <paramref name="charIndex">charIndex</paramref> and <paramref name="charCount">charCount</paramref> do not denote a valid range in <paramref name="chars">chars</paramref>.
553 <paramref name="byteIndex">byteIndex</paramref> is not a valid index in <paramref name="bytes">bytes</paramref>.</exception>
554 <exception cref="T:System.ArgumentException"><paramref name="bytes">bytes</paramref> does not have enough capacity from <paramref name="byteIndex">byteIndex</paramref> to the end of the array to accommodate the resulting bytes.</exception>
555 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
557 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
559 <member name="M:System.Text.UTF7Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
560 <summary>Encodes a set of characters from the specified <see cref="T:System.String"></see> into the specified byte array.</summary>
561 <param name="s">The <see cref="T:System.String"></see> containing the set of characters to encode.</param>
562 <param name="charIndex">The index of the first character to encode.</param>
563 <param name="charCount">The number of characters to encode.</param>
564 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
565 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
566 <returns>The actual number of bytes written into <paramref name="bytes">bytes</paramref>.</returns>
567 <exception cref="T:System.ArgumentNullException"><paramref name="s">s</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).
569 <paramref name="bytes">bytes</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
570 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charIndex">charIndex</paramref> or <paramref name="charCount">charCount</paramref> or <paramref name="byteIndex">byteIndex</paramref> is less than zero.
572 <paramref name="charIndex">charIndex</paramref> and <paramref name="charCount">charCount</paramref> do not denote a valid range in <paramref name="chars">chars</paramref>.
574 <paramref name="byteIndex">byteIndex</paramref> is not a valid index in <paramref name="bytes">bytes</paramref>.</exception>
575 <exception cref="T:System.ArgumentException"><paramref name="bytes">bytes</paramref> does not have enough capacity from <paramref name="byteIndex">byteIndex</paramref> to the end of the array to accommodate the resulting bytes.</exception>
576 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
578 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
580 <member name="M:System.Text.UTF7Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
581 <summary>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</summary>
582 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
583 <param name="index">The index of the first byte to decode.</param>
584 <param name="count">The number of bytes to decode.</param>
585 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
586 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
587 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index">index</paramref> or <paramref name="count">count</paramref> is less than zero.
589 <paramref name="index">index</paramref> and <paramref name="count">count</paramref> do not denote a valid range in <paramref name="bytes">bytes</paramref>.
591 The resulting number of characters is greater than the maximum number that can be returned as an int.</exception>
592 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
594 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
596 <member name="M:System.Text.UTF7Encoding.GetCharCount(System.Byte*,System.Int32)">
597 <summary>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</summary>
598 <param name="bytes">A pointer to the first byte to decode.</param>
599 <param name="count">The number of bytes to decode.</param>
600 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
601 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
602 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="count">count</paramref> is less than zero.
604 The resulting number of characters is greater than the maximum number that can be returned as an int.</exception>
605 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
607 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
609 <member name="M:System.Text.UTF7Encoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
610 <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>
611 <param name="bytes">A pointer to the first byte to decode.</param>
612 <param name="byteCount">The number of bytes to decode.</param>
613 <param name="chars">A pointer to the location at which to start writing the resulting set of characters.</param>
614 <param name="charCount">The maximum number of characters to write.</param>
615 <returns>The actual number of characters written at the location indicated by <paramref name="chars">chars</paramref>.</returns>
616 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).
618 <paramref name="chars">chars</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
619 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="byteCount">byteCount</paramref> or <paramref name="charCount">charCount</paramref> is less than zero.</exception>
620 <exception cref="T:System.ArgumentException"><paramref name="charCount">charCount</paramref> is less than the resulting number of characters.</exception>
621 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
623 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
625 <member name="M:System.Text.UTF7Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
626 <summary>Decodes a sequence of bytes from the specified byte array into the specified character array.</summary>
627 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
628 <param name="byteIndex">The index of the first byte to decode.</param>
629 <param name="byteCount">The number of bytes to decode.</param>
630 <param name="chars">The character array to contain the resulting set of characters.</param>
631 <param name="charIndex">The index at which to start writing the resulting set of characters.</param>
632 <returns>The actual number of characters written into <paramref name="chars">chars</paramref>.</returns>
633 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).
635 <paramref name="chars">chars</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
636 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="byteIndex">byteIndex</paramref> or <paramref name="byteCount">byteCount</paramref> or <paramref name="charIndex">charIndex</paramref> is less than zero.
638 <paramref name="byteindex">byteindex</paramref> and <paramref name="byteCount">byteCount</paramref> do not denote a valid range in <paramref name="bytes">bytes</paramref>.
640 <paramref name="charIndex">charIndex</paramref> is not a valid index in <paramref name="chars">chars</paramref>.</exception>
641 <exception cref="T:System.ArgumentException"><paramref name="chars">chars</paramref> does not have enough capacity from <paramref name="charIndex">charIndex</paramref> to the end of the array to accommodate the resulting characters.</exception>
642 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
644 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
646 <member name="M:System.Text.UTF7Encoding.GetDecoder">
647 <summary>Obtains a decoder that converts a UTF-7 encoded sequence of bytes into a sequence of Unicode characters.</summary>
648 <returns>A <see cref="T:System.Text.Decoder"></see> that converts a UTF-7 encoded sequence of bytes into a sequence of Unicode characters.</returns>
650 <member name="M:System.Text.UTF7Encoding.GetEncoder">
651 <summary>Obtains an encoder that converts a sequence of Unicode characters into a UTF-7 encoded sequence of bytes.</summary>
652 <returns>A <see cref="T:System.Text.Encoder"></see> that converts a sequence of Unicode characters into a UTF-7 encoded sequence of bytes.</returns>
654 <member name="M:System.Text.UTF7Encoding.GetHashCode">
655 <summary>Returns the hash code for the current <see cref="T:System.Text.UTF7Encoding"></see> object.</summary>
656 <returns>A 32-bit signed integer hash code.</returns>
658 <member name="M:System.Text.UTF7Encoding.GetMaxByteCount(System.Int32)">
659 <summary>Calculates the maximum number of bytes produced by encoding the specified number of characters.</summary>
660 <param name="charCount">The number of characters to encode.</param>
661 <returns>The maximum number of bytes produced by encoding the specified number of characters.</returns>
662 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charCount">charCount</paramref> is less than zero.
664 The resulting number of bytes is greater than the maximum number that can be returned as an int.</exception>
665 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
667 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
669 <member name="M:System.Text.UTF7Encoding.GetMaxCharCount(System.Int32)">
670 <summary>Calculates the maximum number of characters produced by decoding the specified number of bytes.</summary>
671 <param name="byteCount">The number of bytes to decode.</param>
672 <returns>The maximum number of characters produced by decoding the specified number of bytes.</returns>
673 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="byteCount">byteCount</paramref> is less than zero.
675 The resulting number of characters is greater than the maximum number that can be returned as an int.</exception>
676 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
678 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
680 <member name="M:System.Text.UTF7Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
681 <summary>Decodes a range of bytes from a byte array into a string.</summary>
682 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
683 <param name="index">The index of the first byte to decode.</param>
684 <param name="count">The number of bytes to decode.</param>
685 <returns>A <see cref="T:System.String"></see> containing the results of decoding the specified sequence of bytes.</returns>
686 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
687 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index">index</paramref> or <paramref name="count">count</paramref> is less than zero.
689 <paramref name="index">index</paramref> and <paramref name="count">count</paramref> do not denote a valid range in <paramref name="bytes">bytes</paramref>.</exception>
690 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
692 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
694 <member name="T:System.Text.UTF32Encoding">
695 <summary>Represents a UTF-32 encoding of Unicode characters.</summary>
697 <member name="M:System.Text.UTF32Encoding.#ctor">
698 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF32Encoding"></see> class.</summary>
700 <member name="M:System.Text.UTF32Encoding.#ctor(System.Boolean,System.Boolean)">
701 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF32Encoding"></see> class. Parameters specify whether to use the big endian byte order and whether the <see cref="M:System.Text.UTF32Encoding.GetPreamble"></see> method returns a Unicode Unicode byte order mark.</summary>
702 <param name="bigEndian"><see langword="true"></see> to use the big endian byte order (most significant byte first), or <see langword="false"></see> to use the little endian byte order (least significant byte first).</param>
703 <param name="byteOrderMark"><see langword="true"></see> to specify that a Unicode byte order mark is provided; otherwise, <see langword="false"></see>.</param>
705 <member name="M:System.Text.UTF32Encoding.#ctor(System.Boolean,System.Boolean,System.Boolean)">
706 <summary>Initializes a new instance of the <see cref="T:System.Text.UTF32Encoding"></see> 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>
707 <param name="bigEndian"><see langword="true"></see> to use the big endian byte order (most significant byte first), or <see langword="false"></see> to use the little endian byte order (least significant byte first).</param>
708 <param name="byteOrderMark"><see langword="true"></see> to specify that a Unicode byte order mark is provided; otherwise, <see langword="false"></see>.</param>
709 <param name="throwOnInvalidCharacters"><see langword="true"></see> to specify that an exception should be thrown when an invalid encoding is detected; otherwise, <see langword="false"></see>.</param>
711 <member name="M:System.Text.UTF32Encoding.Equals(System.Object)">
712 <summary>Determines whether the specified <see cref="T:System.Object"></see> is equal to the current <see cref="T:System.Text.UTF32Encoding"></see> object.</summary>
713 <param name="value">The <see cref="T:System.Object"></see> to compare with the current object.</param>
714 <returns><see langword="true"></see> if <paramref name="value">value</paramref> is an instance of <see cref="T:System.Text.UTF32Encoding"></see> and is equal to the current object; otherwise, <see langword="false"></see>.</returns>
716 <member name="M:System.Text.UTF32Encoding.GetByteCount(System.String)">
717 <summary>Calculates the number of bytes produced by encoding the characters in the specified <see cref="T:System.String"></see>.</summary>
718 <param name="s">The <see cref="T:System.String"></see> containing the set of characters to encode.</param>
719 <returns>The number of bytes produced by encoding the specified characters.</returns>
720 <exception cref="T:System.ArgumentNullException"><paramref name="s">s</paramref> is <see langword="null"></see>.</exception>
721 <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
722 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s">s</paramref> contains an invalid sequence of characters.</exception>
723 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
725 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
727 <member name="M:System.Text.UTF32Encoding.GetByteCount(System.Char*,System.Int32)">
728 <summary>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</summary>
729 <param name="chars">A pointer to the first character to encode.</param>
730 <param name="count">The number of characters to encode.</param>
731 <returns>The number of bytes produced by encoding the specified characters.</returns>
732 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see>.</exception>
733 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="count">count</paramref> is less than zero.
735 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
736 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars">chars</paramref> contains an invalid sequence of characters.</exception>
737 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
739 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
741 <member name="M:System.Text.UTF32Encoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
742 <summary>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</summary>
743 <param name="chars">The character array containing the set of characters to encode.</param>
744 <param name="index">The index of the first character to encode.</param>
745 <param name="count">The number of characters to encode.</param>
746 <returns>The number of bytes produced by encoding the specified characters.</returns>
747 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see>.</exception>
748 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index">index</paramref> or <paramref name="count">count</paramref> is less than zero.
750 <paramref name="index">index</paramref> and <paramref name="count">count</paramref> do not denote a valid range in <paramref name="chars">chars</paramref>.
752 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
753 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars">chars</paramref> contains an invalid sequence of characters.</exception>
754 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
756 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
758 <member name="M:System.Text.UTF32Encoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
759 <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>
760 <param name="chars">A pointer to the first character to encode.</param>
761 <param name="charCount">The number of characters to encode.</param>
762 <param name="bytes">A pointer to the location at which to start writing the resulting sequence of bytes.</param>
763 <param name="byteCount">The maximum number of bytes to write.</param>
764 <returns>The actual number of bytes written at the location indicated by the <paramref name="bytes">bytes</paramref> parameter.</returns>
765 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see>.
767 <paramref name="bytes">bytes</paramref> is <see langword="null"></see>.</exception>
768 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charCount">charCount</paramref> or <paramref name="byteCount">byteCount</paramref> is less than zero.</exception>
769 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars">chars</paramref> contains an invalid sequence of characters.
771 <paramref name="byteCount">byteCount</paramref> is less than the resulting number of bytes.</exception>
772 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
774 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
776 <member name="M:System.Text.UTF32Encoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
777 <summary>Encodes a set of characters from the specified character array into the specified byte array.</summary>
778 <param name="chars">The character array containing the set of characters to encode.</param>
779 <param name="charIndex">The index of the first character to encode.</param>
780 <param name="charCount">The number of characters to encode.</param>
781 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
782 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
783 <returns>The actual number of bytes written into <paramref name="bytes">bytes</paramref>.</returns>
784 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see>.
786 <paramref name="bytes">bytes</paramref> is <see langword="null"></see>.</exception>
787 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charIndex">charIndex</paramref> or <paramref name="charCount">charCount</paramref> or <paramref name="byteIndex">byteIndex</paramref> is less than zero.
789 <paramref name="charIndex">charIndex</paramref> and <paramref name="charCount">charCount</paramref> do not denote a valid range in <paramref name="chars">chars</paramref>.
791 <paramref name="byteIndex">byteIndex</paramref> is not a valid index in <paramref name="bytes">bytes</paramref>.</exception>
792 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars">chars</paramref> contains an invalid sequence of characters.
794 <paramref name="bytes">bytes</paramref> does not have enough capacity from <paramref name="byteIndex">byteIndex</paramref> to the end of the array to accommodate the resulting bytes.</exception>
795 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
797 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
799 <member name="M:System.Text.UTF32Encoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
800 <summary>Encodes a set of characters from the specified <see cref="T:System.String"></see> into the specified byte array.</summary>
801 <param name="s">The <see cref="T:System.String"></see> containing the set of characters to encode.</param>
802 <param name="charIndex">The index of the first character to encode.</param>
803 <param name="charCount">The number of characters to encode.</param>
804 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
805 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
806 <returns>The actual number of bytes written into <paramref name="bytes">bytes</paramref>.</returns>
807 <exception cref="T:System.ArgumentNullException"><paramref name="s">s</paramref> is <see langword="null"></see>.
809 <paramref name="bytes">bytes</paramref> is <see langword="null"></see>.</exception>
810 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charIndex">charIndex</paramref> or <paramref name="charCount">charCount</paramref> or <paramref name="byteIndex">byteIndex</paramref> is less than zero.
812 <paramref name="charIndex">charIndex</paramref> and <paramref name="charCount">charCount</paramref> do not denote a valid range in <paramref name="chars">chars</paramref>.
814 <paramref name="byteIndex">byteIndex</paramref> is not a valid index in <paramref name="bytes">bytes</paramref>.</exception>
815 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s">s</paramref> contains an invalid sequence of characters.
817 <paramref name="bytes">bytes</paramref> does not have enough capacity from <paramref name="byteIndex">byteIndex</paramref> to the end of the array to accommodate the resulting bytes.</exception>
818 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
820 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
822 <member name="M:System.Text.UTF32Encoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
823 <summary>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</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>The number of characters produced by decoding the specified sequence of bytes.</returns>
828 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see>.</exception>
829 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index">index</paramref> or <paramref name="count">count</paramref> is less than zero.
831 <paramref name="index">index</paramref> and <paramref name="count">count</paramref> do not denote a valid range in <paramref name="bytes">bytes</paramref>.
833 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
834 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes">bytes</paramref> 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 complete explanation)
837 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
839 <member name="M:System.Text.UTF32Encoding.GetCharCount(System.Byte*,System.Int32)">
840 <summary>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</summary>
841 <param name="bytes">A pointer to the first byte to decode.</param>
842 <param name="count">The number of bytes to decode.</param>
843 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
844 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see>.</exception>
845 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="count">count</paramref> is less than zero.
847 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
848 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes">bytes</paramref> contains an invalid sequence of bytes.</exception>
849 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
851 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
853 <member name="M:System.Text.UTF32Encoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
854 <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>
855 <param name="bytes">A pointer to the first byte to decode.</param>
856 <param name="byteCount">The number of bytes to decode.</param>
857 <param name="chars">A pointer to the location at which to start writing the resulting set of characters.</param>
858 <param name="charCount">The maximum number of characters to write.</param>
859 <returns>The actual number of characters written at the location indicated by <paramref name="chars">chars</paramref>.</returns>
860 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see>.
862 <paramref name="chars">chars</paramref> is <see langword="null"></see>.</exception>
863 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="byteCount">byteCount</paramref> or <paramref name="charCount">charCount</paramref> is less than zero.</exception>
864 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes">bytes</paramref> contains an invalid sequence of bytes.
866 <paramref name="charCount">charCount</paramref> is less than the resulting number of characters.</exception>
867 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
869 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
871 <member name="M:System.Text.UTF32Encoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
872 <summary>Decodes a sequence of bytes from the specified byte array into the specified character array.</summary>
873 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
874 <param name="byteIndex">The index of the first byte to decode.</param>
875 <param name="byteCount">The number of bytes to decode.</param>
876 <param name="chars">The character array to contain the resulting set of characters.</param>
877 <param name="charIndex">The index at which to start writing the resulting set of characters.</param>
878 <returns>The actual number of characters written into <paramref name="chars">chars</paramref>.</returns>
879 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see>.
881 <paramref name="chars">chars</paramref> is <see langword="null"></see>.</exception>
882 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="byteIndex">byteIndex</paramref> or <paramref name="byteCount">byteCount</paramref> or <paramref name="charIndex">charIndex</paramref> is less than zero.
884 <paramref name="byteindex">byteindex</paramref> and <paramref name="byteCount">byteCount</paramref> do not denote a valid range in <paramref name="bytes">bytes</paramref>.
886 <paramref name="charIndex">charIndex</paramref> is not a valid index in <paramref name="chars">chars</paramref>.</exception>
887 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes">bytes</paramref> contains an invalid sequence of bytes.
889 <paramref name="chars">chars</paramref> does not have enough capacity from <paramref name="charIndex">charIndex</paramref> to the end of the array to accommodate the resulting characters.</exception>
890 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
892 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
894 <member name="M:System.Text.UTF32Encoding.GetDecoder">
895 <summary>Obtains a decoder that converts a UTF-32 encoded sequence of bytes into a sequence of Unicode characters.</summary>
896 <returns>A <see cref="T:System.Text.Decoder"></see> that converts a UTF-32 encoded sequence of bytes into a sequence of Unicode characters.</returns>
898 <member name="M:System.Text.UTF32Encoding.GetEncoder">
899 <summary>Obtains an encoder that converts a sequence of Unicode characters into a UTF-32 encoded sequence of bytes.</summary>
900 <returns>A <see cref="T:System.Text.Encoder"></see> that converts a sequence of Unicode characters into a UTF-32 encoded sequence of bytes.</returns>
902 <member name="M:System.Text.UTF32Encoding.GetHashCode">
903 <summary>Returns the hash code for the current instance.</summary>
904 <returns>The hash code for the current <see cref="T:System.Text.UTF32Encoding"></see> object.</returns>
906 <member name="M:System.Text.UTF32Encoding.GetMaxByteCount(System.Int32)">
907 <summary>Calculates the maximum number of bytes produced by encoding the specified number of characters.</summary>
908 <param name="charCount">The number of characters to encode.</param>
909 <returns>The maximum number of bytes produced by encoding the specified number of characters.</returns>
910 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charCount">charCount</paramref> is less than zero.
912 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
913 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
915 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
917 <member name="M:System.Text.UTF32Encoding.GetMaxCharCount(System.Int32)">
918 <summary>Calculates the maximum number of characters produced by decoding the specified number of bytes.</summary>
919 <param name="byteCount">The number of bytes to decode.</param>
920 <returns>The maximum number of characters produced by decoding the specified number of bytes.</returns>
921 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="byteCount">byteCount</paramref> is less than zero.
923 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
924 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)
926 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
928 <member name="M:System.Text.UTF32Encoding.GetPreamble">
929 <summary>Returns a Unicode byte order mark encoded in UTF-32 format, if the <see cref="T:System.Text.UTF32Encoding"></see> object is configured to supply one.</summary>
930 <returns>A byte array containing the Unicode byte order mark, if the <see cref="T:System.Text.UTF32Encoding"></see> object is configured to supply one. Otherwise, this method returns a zero-length byte array.</returns>
932 <member name="M:System.Text.UTF32Encoding.GetString(System.Byte[],System.Int32,System.Int32)">
933 <summary>Decodes a range of bytes from a byte array into a string.</summary>
934 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
935 <param name="index">The index of the first byte to decode.</param>
936 <param name="count">The number of bytes to decode.</param>
937 <returns>A string that contains the results of decoding the specified sequence of bytes.</returns>
938 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see>.</exception>
939 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index">index</paramref> or <paramref name="count">count</paramref> is less than zero.
941 <paramref name="index">index</paramref> and <paramref name="count">count</paramref> do not denote a valid range in <paramref name="bytes">bytes</paramref>.</exception>
942 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes">bytes</paramref> contains an invalid sequence of bytes.</exception>
943 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for a complete explanation)
945 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
947 <member name="T:System.Text.UnicodeEncoding">
948 <summary>Represents a UTF-16 encoding of Unicode characters.</summary>
950 <member name="M:System.Text.UnicodeEncoding.#ctor">
951 <summary>Initializes a new instance of the <see cref="T:System.Text.UnicodeEncoding"></see> class.</summary>
953 <member name="M:System.Text.UnicodeEncoding.#ctor(System.Boolean,System.Boolean)">
954 <summary>Initializes a new instance of the <see cref="T:System.Text.UnicodeEncoding"></see> class. Parameters specify whether to use the big endian byte order and whether the <see cref="M:System.Text.UnicodeEncoding.GetPreamble"></see> method returns a Unicode byte order mark.</summary>
955 <param name="bigEndian"><see langword="true"></see> to use the big endian byte order (most significant byte first), or <see langword="false"></see> to use the little endian byte order (least significant byte first).</param>
956 <param name="byteOrderMark"><see langword="true"></see> to specify that the <see cref="M:System.Text.UnicodeEncoding.GetPreamble"></see> method returns a Unicode byte order mark; otherwise, <see langword="false"></see>.</param>
958 <member name="M:System.Text.UnicodeEncoding.#ctor(System.Boolean,System.Boolean,System.Boolean)">
959 <summary>Initializes a new instance of the <see cref="T:System.Text.UnicodeEncoding"></see> 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>
960 <param name="bigEndian"><see langword="true"></see> to use the big endian byte order (most significant byte first); <see langword="false"></see> to use the little endian byte order (least significant byte first).</param>
961 <param name="byteOrderMark"><see langword="true"></see> to specify that the <see cref="M:System.Text.UnicodeEncoding.GetPreamble"></see> method returns a Unicode byte order mark; otherwise, <see langword="false"></see>.</param>
962 <param name="throwOnInvalidBytes"><see langword="true"></see> to specify that an exception should be thrown when an invalid encoding is detected; otherwise, <see langword="false"></see>.</param>
964 <member name="F:System.Text.UnicodeEncoding.CharSize">
965 <summary>Represents the Unicode character size in bytes. This field is a constant.</summary>
968 <member name="M:System.Text.UnicodeEncoding.Equals(System.Object)">
969 <summary>Determines whether the specified <see cref="T:System.Object"></see> is equal to the current <see cref="T:System.Text.UnicodeEncoding"></see> object.</summary>
970 <param name="value">The object to compare with the current object.</param>
971 <returns><see langword="true"></see> if <paramref name="value">value</paramref> is an instance of <see cref="T:System.Text.UnicodeEncoding"></see> and is equal to the current object; otherwise, <see langword="false"></see>.</returns>
973 <member name="M:System.Text.UnicodeEncoding.GetByteCount(System.String)">
974 <summary>Calculates the number of bytes produced by encoding the characters in the specified string.</summary>
975 <param name="s">The string that contains the set of characters to encode.</param>
976 <returns>The number of bytes produced by encoding the specified characters.</returns>
977 <exception cref="T:System.ArgumentNullException"><paramref name="s">s</paramref> is <see langword="null"></see>.</exception>
978 <exception cref="T:System.ArgumentOutOfRangeException">The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
979 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s">s</paramref> contains an invalid sequence of characters.</exception>
980 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
982 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
984 <member name="M:System.Text.UnicodeEncoding.GetByteCount(System.Char*,System.Int32)">
985 <summary>Calculates the number of bytes produced by encoding a set of characters starting at the specified character pointer.</summary>
986 <param name="chars">A pointer to the first character to encode.</param>
987 <param name="count">The number of characters to encode.</param>
988 <returns>The number of bytes produced by encoding the specified characters.</returns>
989 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see>.</exception>
990 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="count">count</paramref> is less than zero.
992 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
993 <exception cref="T:System.ArgumentException">Error detection is enabled and <paramref name="chars">chars</paramref> contains an invalid sequence of characters.</exception>
994 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
996 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
998 <member name="M:System.Text.UnicodeEncoding.GetByteCount(System.Char[],System.Int32,System.Int32)">
999 <summary>Calculates the number of bytes produced by encoding a set of characters from the specified character array.</summary>
1000 <param name="chars">The character array containing the set of characters to encode.</param>
1001 <param name="index">The index of the first character to encode.</param>
1002 <param name="count">The number of characters to encode.</param>
1003 <returns>The number of bytes produced by encoding the specified characters.</returns>
1004 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
1005 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index">index</paramref> or <paramref name="count">count</paramref> is less than zero.
1007 <paramref name="index">index</paramref> and <paramref name="count">count</paramref> do not denote a valid range in <paramref name="chars">chars</paramref>.
1009 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1010 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars">chars</paramref> contains an invalid sequence of characters.</exception>
1011 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
1013 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
1015 <member name="M:System.Text.UnicodeEncoding.GetBytes(System.Char[],System.Int32,System.Int32,System.Byte[],System.Int32)">
1016 <summary>Encodes a set of characters from the specified character array into the specified byte array.</summary>
1017 <param name="chars">The character array containing the set of characters to encode.</param>
1018 <param name="charIndex">The index of the first character to encode.</param>
1019 <param name="charCount">The number of characters to encode.</param>
1020 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
1021 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
1022 <returns>The actual number of bytes written into <paramref name="bytes">bytes</paramref>.</returns>
1023 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).
1025 <paramref name="bytes">bytes</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
1026 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charIndex">charIndex</paramref> or <paramref name="charCount">charCount</paramref> or <paramref name="byteIndex">byteIndex</paramref> is less than zero.
1028 <paramref name="charIndex">charIndex</paramref> and <paramref name="charCount">charCount</paramref> do not denote a valid range in <paramref name="chars">chars</paramref>.
1030 <paramref name="byteIndex">byteIndex</paramref> is not a valid index in <paramref name="bytes">bytes</paramref>.</exception>
1031 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars">chars</paramref> contains an invalid sequence of characters.
1033 <paramref name="bytes">bytes</paramref> does not have enough capacity from <paramref name="byteIndex">byteIndex</paramref> to the end of the array to accommodate the resulting bytes.</exception>
1034 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
1036 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
1038 <member name="M:System.Text.UnicodeEncoding.GetBytes(System.String,System.Int32,System.Int32,System.Byte[],System.Int32)">
1039 <summary>Encodes a set of characters from the specified <see cref="T:System.String"></see> into the specified byte array.</summary>
1040 <param name="s">The string containing the set of characters to encode.</param>
1041 <param name="charIndex">The index of the first character to encode.</param>
1042 <param name="charCount">The number of characters to encode.</param>
1043 <param name="bytes">The byte array to contain the resulting sequence of bytes.</param>
1044 <param name="byteIndex">The index at which to start writing the resulting sequence of bytes.</param>
1045 <returns>The actual number of bytes written into <paramref name="bytes">bytes</paramref>.</returns>
1046 <exception cref="T:System.ArgumentNullException"><paramref name="s">s</paramref> is <see langword="null"></see>.
1048 <paramref name="bytes">bytes</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
1049 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charIndex">charIndex</paramref> or <paramref name="charCount">charCount</paramref> or <paramref name="byteIndex">byteIndex</paramref> is less than zero.
1051 <paramref name="charIndex">charIndex</paramref> and <paramref name="charCount">charCount</paramref> do not denote a valid range in <paramref name="chars">chars</paramref>.
1053 <paramref name="byteIndex">byteIndex</paramref> is not a valid index in <paramref name="bytes">bytes</paramref>.</exception>
1054 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="s">s</paramref> contains an invalid sequence of characters.
1056 <paramref name="bytes">bytes</paramref> does not have enough capacity from <paramref name="byteIndex">byteIndex</paramref> to the end of the array to accommodate the resulting bytes.</exception>
1057 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
1059 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
1061 <member name="M:System.Text.UnicodeEncoding.GetBytes(System.Char*,System.Int32,System.Byte*,System.Int32)">
1062 <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>
1063 <param name="chars">A pointer to the first character to encode.</param>
1064 <param name="charCount">The number of characters to encode.</param>
1065 <param name="bytes">A pointer to the location at which to start writing the resulting sequence of bytes.</param>
1066 <param name="byteCount">The maximum number of bytes to write.</param>
1067 <returns>The actual number of bytes written at the location indicated by the <paramref name="bytes">bytes</paramref> parameter.</returns>
1068 <exception cref="T:System.ArgumentNullException"><paramref name="chars">chars</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).
1070 <paramref name="bytes">bytes</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
1071 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charCount">charCount</paramref> or <paramref name="byteCount">byteCount</paramref> is less than zero.</exception>
1072 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="chars">chars</paramref> contains an invalid sequence of characters.
1074 <paramref name="byteCount">byteCount</paramref> is less than the resulting number of bytes.</exception>
1075 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
1077 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
1079 <member name="M:System.Text.UnicodeEncoding.GetCharCount(System.Byte*,System.Int32)">
1080 <summary>Calculates the number of characters produced by decoding a sequence of bytes starting at the specified byte pointer.</summary>
1081 <param name="bytes">A pointer to the first byte to decode.</param>
1082 <param name="count">The number of bytes to decode.</param>
1083 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
1084 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
1085 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="count">count</paramref> is less than zero.
1087 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1088 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes">bytes</paramref> contains an invalid sequence of bytes.</exception>
1089 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
1091 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
1093 <member name="M:System.Text.UnicodeEncoding.GetCharCount(System.Byte[],System.Int32,System.Int32)">
1094 <summary>Calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.</summary>
1095 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
1096 <param name="index">The index of the first byte to decode.</param>
1097 <param name="count">The number of bytes to decode.</param>
1098 <returns>The number of characters produced by decoding the specified sequence of bytes.</returns>
1099 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
1100 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index">index</paramref> or <paramref name="count">count</paramref> is less than zero.
1102 <paramref name="index">index</paramref> and <paramref name="count">count</paramref> do not denote a valid range in <paramref name="bytes">bytes</paramref>.
1104 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1105 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes">bytes</paramref> contains an invalid sequence of bytes.</exception>
1106 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
1108 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
1110 <member name="M:System.Text.UnicodeEncoding.GetChars(System.Byte*,System.Int32,System.Char*,System.Int32)">
1111 <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>
1112 <param name="bytes">A pointer to the first byte to decode.</param>
1113 <param name="byteCount">The number of bytes to decode.</param>
1114 <param name="chars">A pointer to the location at which to start writing the resulting set of characters.</param>
1115 <param name="charCount">The maximum number of characters to write.</param>
1116 <returns>The actual number of characters written at the location indicated by the <paramref name="chars">chars</paramref> parameter.</returns>
1117 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).
1119 <paramref name="chars">chars</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
1120 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="byteCount">byteCount</paramref> or <paramref name="charCount">charCount</paramref> is less than zero.</exception>
1121 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes">bytes</paramref> contains an invalid sequence of bytes.
1123 <paramref name="charCount">charCount</paramref> is less than the resulting number of characters.</exception>
1124 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
1126 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
1128 <member name="M:System.Text.UnicodeEncoding.GetChars(System.Byte[],System.Int32,System.Int32,System.Char[],System.Int32)">
1129 <summary>Decodes a sequence of bytes from the specified byte array into the specified character array.</summary>
1130 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
1131 <param name="byteIndex">The index of the first byte to decode.</param>
1132 <param name="byteCount">The number of bytes to decode.</param>
1133 <param name="chars">The character array to contain the resulting set of characters.</param>
1134 <param name="charIndex">The index at which to start writing the resulting set of characters.</param>
1135 <returns>The actual number of characters written into <paramref name="chars">chars</paramref>.</returns>
1136 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).
1138 <paramref name="chars">chars</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
1139 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="byteIndex">byteIndex</paramref> or <paramref name="byteCount">byteCount</paramref> or <paramref name="charIndex">charIndex</paramref> is less than zero.
1141 <paramref name="byteindex">byteindex</paramref> and <paramref name="byteCount">byteCount</paramref> do not denote a valid range in <paramref name="bytes">bytes</paramref>.
1143 <paramref name="charIndex">charIndex</paramref> is not a valid index in <paramref name="chars">chars</paramref>.</exception>
1144 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes">bytes</paramref> contains an invalid sequence of bytes.
1146 <paramref name="chars">chars</paramref> does not have enough capacity from <paramref name="charIndex">charIndex</paramref> to the end of the array to accommodate the resulting characters.</exception>
1147 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
1149 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
1151 <member name="M:System.Text.UnicodeEncoding.GetDecoder">
1152 <summary>Obtains a decoder that converts a UTF-16 encoded sequence of bytes into a sequence of Unicode characters.</summary>
1153 <returns>A <see cref="T:System.Text.Decoder"></see> that converts a UTF-16 encoded sequence of bytes into a sequence of Unicode characters.</returns>
1155 <member name="M:System.Text.UnicodeEncoding.GetEncoder">
1156 <summary>Obtains an encoder that converts a sequence of Unicode characters into a UTF-16 encoded sequence of bytes.</summary>
1157 <returns>A <see cref="T:System.Text.Encoder"></see> object that converts a sequence of Unicode characters into a UTF-16 encoded sequence of bytes.</returns>
1159 <member name="M:System.Text.UnicodeEncoding.GetHashCode">
1160 <summary>Returns the hash code for the current instance.</summary>
1161 <returns>The hash code for the current <see cref="T:System.Text.UnicodeEncoding"></see> object.</returns>
1163 <member name="M:System.Text.UnicodeEncoding.GetMaxByteCount(System.Int32)">
1164 <summary>Calculates the maximum number of bytes produced by encoding the specified number of characters.</summary>
1165 <param name="charCount">The number of characters to encode.</param>
1166 <returns>The maximum number of bytes produced by encoding the specified number of characters.</returns>
1167 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="charCount">charCount</paramref> is less than zero.
1169 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1170 <exception cref="T:System.Text.EncoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
1172 <see cref="System.Text.Encoding.EncoderFallback"></see> is set to <see cref="System.Text.EncoderExceptionFallback"></see>.</exception>
1174 <member name="M:System.Text.UnicodeEncoding.GetMaxCharCount(System.Int32)">
1175 <summary>Calculates the maximum number of characters produced by decoding the specified number of bytes.</summary>
1176 <param name="byteCount">The number of bytes to decode.</param>
1177 <returns>The maximum number of characters produced by decoding the specified number of bytes.</returns>
1178 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="byteCount">byteCount</paramref> is less than zero.
1180 The resulting number of bytes is greater than the maximum number that can be returned as an integer.</exception>
1181 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
1183 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>
1185 <member name="M:System.Text.UnicodeEncoding.GetPreamble">
1186 <summary>Returns a Unicode byte order mark encoded in UTF-16 format, if the constructor for this instance requests a byte order mark.</summary>
1187 <returns>A byte array containing the Unicode byte order mark, if the <see cref="T:System.Text.UnicodeEncoding"></see> object is configured to supply one. Otherwise, this method returns a zero-length byte array.</returns>
1189 <member name="M:System.Text.UnicodeEncoding.GetString(System.Byte[],System.Int32,System.Int32)">
1190 <summary>Decodes a range of bytes from a byte array into a string.</summary>
1191 <param name="bytes">The byte array containing the sequence of bytes to decode.</param>
1192 <param name="index">The index of the first byte to decode.</param>
1193 <param name="count">The number of bytes to decode.</param>
1194 <returns>A <see cref="T:System.String"></see> object containing the results of decoding the specified sequence of bytes.</returns>
1195 <exception cref="T:System.ArgumentNullException"><paramref name="bytes">bytes</paramref> is <see langword="null"></see> (<see langword="Nothing"></see>).</exception>
1196 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="index">index</paramref> or <paramref name="count">count</paramref> is less than zero.
1198 <paramref name="index">index</paramref> and <paramref name="count">count</paramref> do not denote a valid range in <paramref name="bytes">bytes</paramref>.</exception>
1199 <exception cref="T:System.ArgumentException">Error detection is enabled, and <paramref name="bytes">bytes</paramref> contains an invalid sequence of bytes.</exception>
1200 <exception cref="T:System.Text.DecoderFallbackException">A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)
1202 <see cref="System.Text.Encoding.DecoderFallback"></see> is set to <see cref="System.Text.DecoderExceptionFallback"></see>.</exception>