DecoderExceptionFallback Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje mechanismus zpracování chyb, označovaný jako záložní, pro zakódovanou vstupní bajtovou sekvenci, kterou nelze převést na vstupní znak. Náhradní sekvenci vyvolá výjimku místo dekódování vstupní sekvence bajtů. Tuto třídu nelze dědit.
public ref class DecoderExceptionFallback sealed : System::Text::DecoderFallbackpublic sealed class DecoderExceptionFallback : System.Text.DecoderFallback[System.Serializable]
public sealed class DecoderExceptionFallback : System.Text.DecoderFallbacktype DecoderExceptionFallback = class
inherit DecoderFallback[<System.Serializable>]
type DecoderExceptionFallback = class
inherit DecoderFallbackPublic NotInheritable Class DecoderExceptionFallback
Inherits DecoderFallback- Dědičnost
- Atributy
Příklady
Následující příklad kódu ukazuje DecoderExceptionFallback třídy a DecoderFallbackException .
// This example demonstrates the DecoderExceptionFallback class.
using namespace System;
using namespace System::Text;
int main()
{
// Create an encoding, which is equivalent to calling the
// ASCIIEncoding class constructor.
// The DecoderExceptionFallback parameter specifies that an exception
// is thrown if a character cannot be encoded.
// An encoder exception fallback is also specified, but in this code
// example the encoding operation cannot fail.
Encoding^ asciiEncoding = Encoding::GetEncoding("us-ascii",
gcnew EncoderExceptionFallback(), gcnew DecoderExceptionFallback());
String^ inputString = "XYZ";
String^ decodedString;
String^ twoNewLines = Environment::NewLine + Environment::NewLine ;
array<Byte>^ encodedBytes =
gcnew array<Byte>(asciiEncoding->GetByteCount(inputString));
int numberOfEncodedBytes = 0;
// ---------------------------------------------------------------------
Console::Clear();
// Display the name of the encoding.
Console::WriteLine("The name of the encoding is \"{0}\".{1}",
asciiEncoding->WebName, Environment::NewLine);
// Display the input string in text.
Console::WriteLine("Input string ({0} characters): \"{1}\"",
inputString->Length, inputString);
// Display the input string in hexadecimal.
Console::Write("Input string in hexadecimal: ");
for each (char c in inputString)
{
Console::Write("0x{0:X2} ", c);
}
Console::Write(twoNewLines);
// ---------------------------------------------------------------------
// Encode the input string.
Console::WriteLine("Encode the input string...");
numberOfEncodedBytes = asciiEncoding->GetBytes(inputString, 0,
inputString->Length, encodedBytes, 0);
// Display the encoded bytes.
Console::WriteLine("Encoded bytes in hexadecimal ({0} bytes):{1}",
numberOfEncodedBytes, Environment::NewLine);
for each (Byte b in encodedBytes)
{
Console::Write("0x{0:X2} ", b);
}
Console::Write(twoNewLines);
// ---------------------------------------------------------------------
// Replace the encoded byte sequences for the characters 'X' and 'Z'
// with the value 0xFF, which is outside the valid range of 0x00 to 0x7F
// for ASCIIEncoding. The resulting byte sequence is actually the
// beginning of this code example because it is the input to the decoder
// operation, and is equivalent to a corrupted or improperly encoded
// byte sequence.
encodedBytes[0] = 0xFF;
encodedBytes[2] = 0xFF;
Console::WriteLine("Display the corrupted byte sequence...");
Console::WriteLine("Encoded bytes in hexadecimal ({0} bytes):{1}",
numberOfEncodedBytes, Environment::NewLine);
for each (Byte b in encodedBytes)
{
Console::Write("0x{0:X2} ", b);
}
Console::Write(twoNewLines);
// ---------------------------------------------------------------------
// Attempt to decode the encoded bytes. However, an exception is thrown
// before the byte sequence can be decoded.
Console::WriteLine("Compare the decoded bytes to the input string...");
try
{
decodedString = asciiEncoding->GetString(encodedBytes);
// This statement is never executed.
Console::WriteLine("This statement is never executed.");
}
catch (DecoderFallbackException^ ex)
{
Console::WriteLine(ex);
Console::WriteLine(
"{0}*** THE CODE EXAMPLE TERMINATES HERE AS INTENDED. ***",
Environment::NewLine);
}
}
/*
This code example produces the following results:
The name of the encoding is "us-ascii".
Input string (3 characters): "XYZ"
Input string in hexadecimal: 0x58 0x59 0x5A
Encode the input string...
Encoded bytes in hexadecimal (3 bytes):
0x58 0x59 0x5A
Display the corrupted byte sequence...
Encoded bytes in hexadecimal (3 bytes):
0xFF 0x59 0xFF
Compare the decoded bytes to the input string...
System.Text.DecoderFallbackException: Unable to translate bytes [FF] at index 0 from speci
fied code page to Unicode.
at System.Text.DecoderExceptionFallbackBuffer.Throw(Byte[] bytesUnknown, Int32 index)
at System.Text.DecoderExceptionFallbackBuffer.Fallback(Byte[] bytesUnknown, Int32 index
)
at System.Text.DecoderFallbackBuffer.InternalFallback(Byte[] bytes, Byte* pBytes)
at System.Text.ASCIIEncoding.GetCharCount(Byte* bytes, Int32 count, DecoderNLS decoder)
at System.String.CreateStringFromEncoding(Byte* bytes, Int32 byteLength, Encoding encod
ing)
at System.Text.ASCIIEncoding.GetString(Byte[] bytes, Int32 byteIndex, Int32 byteCount)
at System.Text.Encoding.GetString(Byte[] bytes)
at Sample.Main()
*** THE CODE EXAMPLE TERMINATES HERE AS INTENDED. ***
*/
// This example demonstrates the DecoderExceptionFallback class.
using System;
using System.Text;
class Sample
{
public static void Main()
{
// Create an encoding, which is equivalent to calling the
// ASCIIEncoding class constructor.
// The DecoderExceptionFallback parameter specifies that an exception
// is thrown if a character cannot be encoded.
// An encoder exception fallback is also specified, but in this code
// example the encoding operation cannot fail.
Encoding ae = Encoding.GetEncoding(
"us-ascii",
new EncoderExceptionFallback(),
new DecoderExceptionFallback());
string inputString = "XYZ";
string decodedString;
string twoNewLines = "\n\n";
byte[] encodedBytes = new byte[ae.GetByteCount(inputString)];
int numberOfEncodedBytes = 0;
// --------------------------------------------------------------------------
Console.Clear();
// Display the name of the encoding.
Console.WriteLine("The name of the encoding is \"{0}\".\n", ae.WebName);
// Display the input string in text.
Console.WriteLine("Input string ({0} characters): \"{1}\"",
inputString.Length, inputString);
// Display the input string in hexadecimal.
Console.Write("Input string in hexadecimal: ");
foreach (char c in inputString.ToCharArray())
{
Console.Write("0x{0:X2} ", (int)c);
}
Console.Write(twoNewLines);
// --------------------------------------------------------------------------
// Encode the input string.
Console.WriteLine("Encode the input string...");
numberOfEncodedBytes = ae.GetBytes(inputString, 0, inputString.Length,
encodedBytes, 0);
// Display the encoded bytes.
Console.WriteLine("Encoded bytes in hexadecimal ({0} bytes):\n",
numberOfEncodedBytes);
foreach (byte b in encodedBytes)
{
Console.Write("0x{0:X2} ", (int)b);
}
Console.Write(twoNewLines);
// --------------------------------------------------------------------------
// Replace the encoded byte sequences for the characters 'X' and 'Z' with the
// value 0xFF, which is outside the valid range of 0x00 to 0x7F for
// ASCIIEncoding. The resulting byte sequence is actually the beginning of
// this code example because it is the input to the decoder operation, and
// is equivalent to a corrupted or improperly encoded byte sequence.
encodedBytes[0] = 0xFF;
encodedBytes[2] = 0xFF;
Console.WriteLine("Display the corrupted byte sequence...");
Console.WriteLine("Encoded bytes in hexadecimal ({0} bytes):\n",
numberOfEncodedBytes);
foreach (byte b in encodedBytes)
{
Console.Write("0x{0:X2} ", (int)b);
}
Console.Write(twoNewLines);
// --------------------------------------------------------------------------
// Attempt to decode the encoded bytes. However, an exception is thrown
// before the byte sequence can be decoded.
Console.WriteLine("Compare the decoded bytes to the input string...");
try {
decodedString = ae.GetString(encodedBytes);
}
catch (DecoderFallbackException dfe)
{
Console.WriteLine(dfe);
Console.WriteLine("\n*** THE CODE EXAMPLE TERMINATES HERE AS INTENDED. ***");
return;
}
// This statement is never executed.
Console.WriteLine("This statement is never executed.");
}
}
/*
This code example produces the following results:
The name of the encoding is "us-ascii".
Input string (3 characters): "XYZ"
Input string in hexadecimal: 0x58 0x59 0x5A
Encode the input string...
Encoded bytes in hexadecimal (3 bytes):
0x58 0x59 0x5A
Display the corrupted byte sequence...
Encoded bytes in hexadecimal (3 bytes):
0xFF 0x59 0xFF
Compare the decoded bytes to the input string...
System.Text.DecoderFallbackException: Unable to translate bytes [FF] at index 0 from speci
fied code page to Unicode.
at System.Text.DecoderExceptionFallbackBuffer.Throw(Byte[] bytesUnknown, Int32 index)
at System.Text.DecoderExceptionFallbackBuffer.Fallback(Byte[] bytesUnknown, Int32 index
)
at System.Text.DecoderFallbackBuffer.InternalFallback(Byte[] bytes, Byte* pBytes)
at System.Text.ASCIIEncoding.GetCharCount(Byte* bytes, Int32 count, DecoderNLS decoder)
at System.String.CreateStringFromEncoding(Byte* bytes, Int32 byteLength, Encoding encod
ing)
at System.Text.ASCIIEncoding.GetString(Byte[] bytes, Int32 byteIndex, Int32 byteCount)
at System.Text.Encoding.GetString(Byte[] bytes)
at Sample.Main()
*** THE CODE EXAMPLE TERMINATES HERE AS INTENDED. ***
*/
' This example demonstrates the DecoderExceptionFallback class.
Imports System.Text
Class Sample
Public Shared Sub Main()
' Create an encoding, which is equivalent to calling the
' ASCIIEncoding class constructor.
' The DecoderExceptionFallback parameter specifies that an exception
' is thrown if a character cannot be encoded.
' An encoder exception fallback is also specified, but in this code
' example the encoding operation cannot fail.
Dim eef As New EncoderExceptionFallback()
Dim def As New DecoderExceptionFallback()
Dim ae As Encoding = Encoding.GetEncoding("us-ascii", eef, def)
Dim inputString As String = "XYZ"
Dim decodedString As String
Dim twoNewLines As String = vbCrLf & vbCrLf
Dim numberOfEncodedBytes As Integer = ae.GetByteCount(inputString)
' Counteract the compiler adding an extra element.
Dim encodedBytes(numberOfEncodedBytes - 1) As Byte
' --------------------------------------------------------------------------
Console.Clear()
' Display the name of the encoding.
Console.WriteLine("The name of the encoding is ""{0}""." & vbCrLf, ae.WebName)
' Display the input string in text.
Console.WriteLine("Input string ({0} characters): ""{1}""", inputString.Length, inputString)
' Display the input string in hexadecimal.
' Each element is converted to an integer with Convert.ToInt32.
Console.Write("Input string in hexadecimal: ")
Dim c As Char
For Each c In inputString.ToCharArray()
Console.Write("0x{0:X2} ", Convert.ToInt32(c))
Next c
Console.Write(twoNewLines)
' --------------------------------------------------------------------------
' Encode the input string.
Console.WriteLine("Encode the input string...")
numberOfEncodedBytes = ae.GetBytes(inputString, 0, inputString.Length, _
encodedBytes, 0)
' Display the encoded bytes.
' Each element is converted to an integer with Convert.ToInt32.
Console.WriteLine("Encoded bytes in hexadecimal ({0} bytes):" & vbCrLf, _
numberOfEncodedBytes)
Dim b As Byte
For Each b In encodedBytes
Console.Write("0x{0:X2} ", Convert.ToInt32(b))
Next b
Console.Write(twoNewLines)
' --------------------------------------------------------------------------
' Replace the encoded byte sequences for the characters 'X' and 'Z' with the
' value 0xFF, which is outside the valid range of 0x00 to 0x7F for
' ASCIIEncoding. The resulting byte sequence is actually the beginning of
' this code example because it is the input to the decoder operation, and
' is equivalent to a corrupted or improperly encoded byte sequence.
encodedBytes(0) = &HFF
encodedBytes(2) = &HFF
Console.WriteLine("Display the corrupted byte sequence...")
' Each element is converted to an integer with Convert.ToInt32.
Console.WriteLine("Encoded bytes in hexadecimal ({0} bytes):" & vbCrLf, _
numberOfEncodedBytes)
For Each b In encodedBytes
Console.Write("0x{0:X2} ", Convert.ToInt32(b))
Next b
Console.Write(twoNewLines)
' --------------------------------------------------------------------------
' Attempt to decode the encoded bytes. However, an exception is thrown
' before the byte sequence can be decoded.
Console.WriteLine("Compare the decoded bytes to the input string...")
Try
decodedString = ae.GetString(encodedBytes)
Catch dfe As DecoderFallbackException
Console.WriteLine(dfe)
Console.WriteLine(vbCrLf & _
"*** THE CODE EXAMPLE TERMINATES HERE AS INTENDED. ***")
Return
End Try
' This statement is never executed.
Console.WriteLine("This statement is never executed.")
End Sub
End Class
'
'This code example produces the following results:
'
'The name of the encoding is "us-ascii".
'
'Input string (3 characters): "XYZ"
'Input string in hexadecimal: 0x58 0x59 0x5A
'
'Encode the input string...
'Encoded bytes in hexadecimal (3 bytes):
'
'0x58 0x59 0x5A
'
'Display the corrupted byte sequence...
'Encoded bytes in hexadecimal (3 bytes):
'
'0xFF 0x59 0xFF
'
'Compare the decoded bytes to the input string...
'System.Text.DecoderFallbackException: Unable to translate bytes [FF] at index 0 from speci
'fied code page to Unicode.
' at System.Text.DecoderExceptionFallbackBuffer.Throw(Byte[] bytesUnknown, Int32 index)
' at System.Text.DecoderExceptionFallbackBuffer.Fallback(Byte[] bytesUnknown, Int32 index
')
' at System.Text.DecoderFallbackBuffer.InternalFallback(Byte[] bytes, Byte* pBytes)
' at System.Text.ASCIIEncoding.GetCharCount(Byte* bytes, Int32 count, DecoderNLS decoder)
'
' at System.String.CreateStringFromEncoding(Byte* bytes, Int32 byteLength, Encoding encod
'ing)
' at System.Text.ASCIIEncoding.GetString(Byte[] bytes, Int32 byteIndex, Int32 byteCount)
' at System.Text.Encoding.GetString(Byte[] bytes)
' at Sample.Main()
'
'*** THE CODE EXAMPLE TERMINATES HERE AS INTENDED. ***
'
'
Poznámky
Kódování mapuje znak Unicode na zakódovanou sekvenci bajtů, která může být následně přenesena na fyzické médium, jako je disk, nebo přes komunikační propojení. Znaky lze mapovat různými způsoby a konkrétní kódování je reprezentováno typem odvozeným z Encoding třídy . Konkrétně metoda typu GetBytes kódování kóduje znak do sekvence bajtů a GetChars metoda dekóduje posloupnost bajtů na znak.
Operace dekódování může selhat, pokud kódování nemůže namapovat vstupní sekvenci bajtů. Objekt například nemůže dekódovat posloupnost bajtů, ASCIIEncoding která vynáší znak s hodnotou bodu kódu, která je mimo rozsah U+0000 až U+007F.
V případech, kdy kódování nebo dekódování převod nelze provést, rozhraní .NET Framework poskytuje mechanismus zpracování selhání, který se nazývá náhradní. Vaše aplikace může používat předdefinovaný dekodér rozhraní .NET Framework náhradní nebo může vytvořit vlastní dekodér odvozený z DecoderFallback tříd a DecoderFallbackBuffer .
Rozhraní .NET Framework poskytuje dvě předdefinované třídy, které implementují různé záložní strategie pro zpracování selhání dekódování převodu. Třída DecoderReplacementFallback nahrazuje řetězec zadaný místo jakékoli vstupní sekvence bajtů, který nelze převést. Po vygenerování náhradního řetězce bude operace dekódování pokračovat v převodu zbytku vstupu. Naproti tomu DecoderExceptionFallback třída vyvolá výjimku , DecoderFallbackException pokud dojde k neplatné sekvenci bajtů.
Konstruktory
| DecoderExceptionFallback() |
Inicializuje novou instanci DecoderExceptionFallback třídy . |
Vlastnosti
| MaxCharCount |
Získá maximální počet znaků, které může tato instance vrátit. |
Metody
| CreateFallbackBuffer() |
Vrátí záložní vyrovnávací paměť dekodéru, která vyvolá výjimku, pokud nemůže převést posloupnost bajtů na znak. |
| Equals(Object) |
Určuje, zda je aktuální DecoderExceptionFallback objekt a zadaný objekt shodný. |
| GetHashCode() |
Načte kód hash pro tuto instanci. |
| GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |