System.Text.Encoding
Converts a sequence of encoded bytes into a set of characters.
1
Initializes a new instance of the class.
Converts an array of encoded bytes to UTF-16 encoded characters and stores the result in a character array.
A byte array to convert.
The first element of to convert.
The number of elements of to convert.
An array to store the converted characters.
The first element of in which data is stored.
The maximum number of elements of to use in the conversion.
true to indicate that no further data is to be converted; otherwise, false.
When this method returns, contains the number of bytes that were used in the conversion. This parameter is passed uninitialized.
When this method returns, contains the number of characters from that were produced by the conversion. This parameter is passed uninitialized.
When this method returns, contains true if all the characters specified by were converted; otherwise, false. This parameter is passed uninitialized.
or is null (Nothing).
, , , or is less than zero.-or-The length of - is less than .-or-The length of - is less than .
The output buffer is too small to contain any of the converted input. The output buffer should be greater than or equal to the size indicated by the method.
A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)-and- is set to .
2
When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.
The number of characters produced by decoding the specified sequence of bytes and any bytes in the internal buffer.
The byte array containing the sequence of bytes to decode.
The index of the first byte to decode.
The number of bytes to decode.
is null (Nothing).
or is less than zero.-or- and do not denote a valid range in .
A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)-and- is set to .
2
When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes from the specified byte array. A parameter indicates whether to clear the internal state of the decoder after the calculation.
The number of characters produced by decoding the specified sequence of bytes and any bytes in the internal buffer.
The byte array containing the sequence of bytes to decode.
The index of the first byte to decode.
The number of bytes to decode.
true to simulate clearing the internal state of the encoder after the calculation; otherwise, false.
is null (Nothing).
or is less than zero.-or- and do not denote a valid range in .
A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)-and- is set to .
2
When overridden in a derived class, decodes a sequence of bytes from the specified byte array and any bytes in the internal buffer into the specified character array.
The actual number of characters written into .
The byte array containing the sequence of bytes to decode.
The index of the first byte to decode.
The number of bytes to decode.
The character array to contain the resulting set of characters.
The index at which to start writing the resulting set of characters.
is null (Nothing).-or- is null (Nothing).
or or is less than zero.-or- and do not denote a valid range in .-or- is not a valid index in .
does not have enough capacity from to the end of the array to accommodate the resulting characters.
A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)-and- is set to .
2
When overridden in a derived class, decodes a sequence of bytes from the specified byte array and any bytes in the internal buffer into the specified character array. A parameter indicates whether to clear the internal state of the decoder after the conversion.
The actual number of characters written into the parameter.
The byte array containing the sequence of bytes to decode.
The index of the first byte to decode.
The number of bytes to decode.
The character array to contain the resulting set of characters.
The index at which to start writing the resulting set of characters.
true to clear the internal state of the decoder after the conversion; otherwise, false.
is null (Nothing).-or- is null (Nothing).
or or is less than zero.-or- and do not denote a valid range in .-or- is not a valid index in .
does not have enough capacity from to the end of the array to accommodate the resulting characters.
A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)-and- is set to .
2
When overridden in a derived class, sets the decoder back to its initial state.
2
The exception that is thrown when a decoder fallback operation fails. This class cannot be inherited.
2
Initializes a new instance of the class.
Initializes a new instance of the class. A parameter specifies the error message.
An error message.
Initializes a new instance of the class. Parameters specify the error message, the array of bytes being decoded, and the index of the byte that cannot be decoded.
An error message.
The input byte array.
The index position in of the byte that cannot be decoded.
Initializes a new instance of the class. Parameters specify the error message and the inner exception that is the cause of this exception.
An error message.
The exception that caused this exception.
Gets the input byte sequence that caused the exception.
The input byte array that cannot be decoded.
2
Gets the index position in the input byte sequence of the byte that caused the exception.
The index position in the input byte array of the byte that cannot be decoded. The index position is zero-based.
1
Converts a set of characters into a sequence of bytes.
1
Initializes a new instance of the class.
Converts an array of Unicode characters to an encoded byte sequence and stores the result in an array of bytes.
An array of characters to convert.
The first element of to convert.
The number of elements of to convert.
An array where the converted bytes are stored.
The first element of in which data is stored.
The maximum number of elements of to use in the conversion.
true to indicate no further data is to be converted; otherwise, false.
When this method returns, contains the number of characters from that were used in the conversion. This parameter is passed uninitialized.
When this method returns, contains the number of bytes that were produced by the conversion. This parameter is passed uninitialized.
When this method returns, contains true if all the characters specified by were converted; otherwise, false. This parameter is passed uninitialized.
or is null (Nothing).
, , , or is less than zero.-or-The length of - is less than .-or-The length of - is less than .
The output buffer is too small to contain any of the converted input. The output buffer should be greater than or equal to the size indicated by the method.
A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)-and- is set to .
2
When overridden in a derived class, calculates the number of bytes produced by encoding a set of characters from the specified character array. A parameter indicates whether to clear the internal state of the encoder after the calculation.
The number of bytes produced by encoding the specified characters and any characters in the internal buffer.
The character array containing the set of characters to encode.
The index of the first character to encode.
The number of characters to encode.
true to simulate clearing the internal state of the encoder after the calculation; otherwise, false.
is null.
or is less than zero.-or- and do not denote a valid range in .
A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)-and- is set to .
2
When overridden in a derived class, encodes a set of characters from the specified character array and any characters in the internal buffer into the specified byte array. A parameter indicates whether to clear the internal state of the encoder after the conversion.
The actual number of bytes written into .
The character array containing the set of characters to encode.
The index of the first character to encode.
The number of characters to encode.
The byte array to contain the resulting sequence of bytes.
The index at which to start writing the resulting sequence of bytes.
true to clear the internal state of the encoder after the conversion; otherwise, false.
is null (Nothing).-or- is null (Nothing).
or or is less than zero.-or- and do not denote a valid range in .-or- is not a valid index in .
does not have enough capacity from to the end of the array to accommodate the resulting bytes.
A fallback occurred (see Character Encoding in the .NET Framework for fuller explanation)-and- is set to .
2
The exception that is thrown when an encoder fallback operation fails. This class cannot be inherited.
2
Initializes a new instance of the class.
Initializes a new instance of the class. A parameter specifies the error message.
An error message.
Initializes a new instance of the class. Parameters specify the error message and the inner exception that is the cause of this exception.
An error message.
The exception that caused this exception.
Gets the input character that caused the exception.
The character that cannot be encoded.
2
Gets the high component character of the surrogate pair that caused the exception.
The high component character of the surrogate pair that cannot be encoded.
2
Gets the low component character of the surrogate pair that caused the exception.
The low component character of the surrogate pair that cannot be encoded.
2
Gets the index position in the input buffer of the character that caused the exception.
The index position in the input buffer of the character that cannot be encoded.
1
Represents a character encoding.
1
Initializes a new instance of the class.
Gets an encoding for the UTF-16 format that uses the big endian byte order.
An encoding object for the UTF-16 format that uses the big endian byte order.
1
Converts an entire byte array from one encoding to another.
An array of type containing the results of converting from to .
The encoding format of .
The target encoding format.
The bytes to convert.
is null.-or- is null.-or- is null.
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and-srcEncoding. is set to .
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and-dstEncoding. is set to .
1
Converts a range of bytes in a byte array from one encoding to another.
An array of type containing the result of converting a range of bytes in from to .
The encoding of the source array, .
The encoding of the output array.
The array of bytes to convert.
The index of the first element of to convert.
The number of bytes to convert.
is null.-or- is null.-or- is null.
and do not specify a valid range in the byte array.
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and-srcEncoding. is set to .
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and-dstEncoding. is set to .
1
Determines whether the specified is equal to the current instance.
true if is an instance of and is equal to the current instance; otherwise, false.
The to compare with the current instance.
2
When overridden in a derived class, calculates the number of bytes produced by encoding all the characters in the specified character array.
The number of bytes produced by encoding all the characters in the specified character array.
The character array containing the characters to encode.
is null.
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and- is set to .
1
When overridden in a derived class, calculates the number of bytes produced by encoding a set of characters from the specified character array.
The number of bytes produced by encoding the specified characters.
The character array containing the set of characters to encode.
The index of the first character to encode.
The number of characters to encode.
is null.
or is less than zero.-or- and do not denote a valid range in .
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and- is set to .
1
When overridden in a derived class, calculates the number of bytes produced by encoding the characters in the specified string.
The number of bytes produced by encoding the specified characters.
The string containing the set of characters to encode.
is null.
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and- is set to .
1
When overridden in a derived class, encodes all the characters in the specified character array into a sequence of bytes.
A byte array containing the results of encoding the specified set of characters.
The character array containing the characters to encode.
is null.
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and- is set to .
1
When overridden in a derived class, encodes a set of characters from the specified character array into a sequence of bytes.
A byte array containing the results of encoding the specified set of characters.
The character array containing the set of characters to encode.
The index of the first character to encode.
The number of characters to encode.
is null.
or is less than zero.-or- and do not denote a valid range in .
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and- is set to .
1
When overridden in a derived class, encodes a set of characters from the specified character array into the specified byte array.
The actual number of bytes written into .
The character array containing the set of characters to encode.
The index of the first character to encode.
The number of characters to encode.
The byte array to contain the resulting sequence of bytes.
The index at which to start writing the resulting sequence of bytes.
is null.-or- is null.
or or is less than zero.-or- and do not denote a valid range in .-or- is not a valid index in .
does not have enough capacity from to the end of the array to accommodate the resulting bytes.
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and- is set to .
1
When overridden in a derived class, encodes all the characters in the specified string into a sequence of bytes.
A byte array containing the results of encoding the specified set of characters.
The string containing the characters to encode.
is null.
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and- is set to .
1
When overridden in a derived class, encodes a set of characters from the specified string into the specified byte array.
The actual number of bytes written into .
The string containing the set of characters to encode.
The index of the first character to encode.
The number of characters to encode.
The byte array to contain the resulting sequence of bytes.
The index at which to start writing the resulting sequence of bytes.
is null.-or- is null.
or or is less than zero.-or- and do not denote a valid range in .-or- is not a valid index in .
does not have enough capacity from to the end of the array to accommodate the resulting bytes.
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and- is set to .
1
When overridden in a derived class, calculates the number of characters produced by decoding all the bytes in the specified byte array.
The number of characters produced by decoding the specified sequence of bytes.
The byte array containing the sequence of bytes to decode.
is null.
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and- is set to .
1
When overridden in a derived class, calculates the number of characters produced by decoding a sequence of bytes from the specified byte array.
The number of characters produced by decoding the specified sequence of bytes.
The byte array containing the sequence of bytes to decode.
The index of the first byte to decode.
The number of bytes to decode.
is null.
or is less than zero.-or- and do not denote a valid range in .
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and- is set to .
1
When overridden in a derived class, decodes all the bytes in the specified byte array into a set of characters.
A character array containing the results of decoding the specified sequence of bytes.
The byte array containing the sequence of bytes to decode.
is null.
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and- is set to .
1
When overridden in a derived class, decodes a sequence of bytes from the specified byte array into a set of characters.
A character array containing the results of decoding the specified sequence of bytes.
The byte array containing the sequence of bytes to decode.
The index of the first byte to decode.
The number of bytes to decode.
is null.
or is less than zero.-or- and do not denote a valid range in .
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and- is set to .
1
When overridden in a derived class, decodes a sequence of bytes from the specified byte array into the specified character array.
The actual number of characters written into .
The byte array containing the sequence of bytes to decode.
The index of the first byte to decode.
The number of bytes to decode.
The character array to contain the resulting set of characters.
The index at which to start writing the resulting set of characters.
is null.-or- is null.
or or is less than zero.-or- and do not denote a valid range in .-or- is not a valid index in .
does not have enough capacity from to the end of the array to accommodate the resulting characters.
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and- is set to .
1
When overridden in a derived class, obtains a decoder that converts an encoded sequence of bytes into a sequence of characters.
A that converts an encoded sequence of bytes into a sequence of characters.
1
When overridden in a derived class, obtains an encoder that converts a sequence of Unicode characters into an encoded sequence of bytes.
A that converts a sequence of Unicode characters into an encoded sequence of bytes.
1
Returns the encoding associated with the specified code page name.
The encoding associated with the specified code page.
The code page name of the preferred encoding. Any value returned by the property is valid. Possible values are listed in the Name column of the table that appears in the class topic.
is not a valid code page name.-or- The code page indicated by is not supported by the underlying platform.
1
Returns the hash code for the current instance.
The hash code for the current instance.
1
When overridden in a derived class, calculates the maximum number of bytes produced by encoding the specified number of characters.
The maximum number of bytes produced by encoding the specified number of characters.
The number of characters to encode.
is less than zero.
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and- is set to .
1
When overridden in a derived class, calculates the maximum number of characters produced by decoding the specified number of bytes.
The maximum number of characters produced by decoding the specified number of bytes.
The number of bytes to decode.
is less than zero.
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and- is set to .
1
When overridden in a derived class, returns a sequence of bytes that specifies the encoding used.
A byte array containing a sequence of bytes that specifies the encoding used.-or- A byte array of length zero, if a preamble is not required.
1
When overridden in a derived class, decodes a sequence of bytes from the specified byte array into a string.
A string that contains the results of decoding the specified sequence of bytes.
The byte array containing the sequence of bytes to decode.
The index of the first byte to decode.
The number of bytes to decode.
The byte array contains invalid Unicode code points.
is null.
or is less than zero.-or- and do not denote a valid range in .
A fallback occurred (see Character Encoding in the .NET Framework for complete explanation)-and- is set to .
1
Gets an encoding for the UTF-16 format using the little endian byte order.
An encoding for the UTF-16 format using the little endian byte order.
1
Gets an encoding for the UTF-8 format.
An encoding for the UTF-8 format.
1
When overridden in a derived class, gets the name registered with the Internet Assigned Numbers Authority (IANA) for the current encoding.
The IANA name for the current .
2