EncoderReplacementFallback Třída

Definice

Obor názvů:

System.Text

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

EncoderReplacementFallback.cs

Poskytuje mechanismus zpracování selhání, označovaný jako záložní, pro vstupní znak, který nelze převést na výstupní bajtovou sekvenci. Náhradní řetězec používá místo původního vstupního znaku zadanou uživatelem. Tato třída se nemůže dědit.

public ref class EncoderReplacementFallback sealed : System::Text::EncoderFallback

public sealed class EncoderReplacementFallback : System.Text.EncoderFallback

type EncoderReplacementFallback = class
    inherit EncoderFallback

Public NotInheritable Class EncoderReplacementFallback
Inherits EncoderFallback

Dědičnost

Object

EncoderFallback

EncoderReplacementFallback

Příklady

Následující příklad ukazuje EncoderReplacementFallback třídu.

// This example demonstrates the EncoderReplacementFallback 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 EncoderReplacementFallback parameter specifies that the
// string, "(unknown)", replace characters that cannot be encoded.
// A decoder replacement fallback is also specified, but in this
// code example the decoding operation cannot fail.

    Encoding ae = Encoding.GetEncoding(
                  "us-ascii",
                  new EncoderReplacementFallback("(unknown)"),
                  new DecoderReplacementFallback("(error)"));

// The input string consists of the Unicode characters LEFT POINTING
// DOUBLE ANGLE QUOTATION MARK (U+00AB), 'X' (U+0058), and RIGHT POINTING
// DOUBLE ANGLE QUOTATION MARK (U+00BB).
// The encoding can only encode characters in the US-ASCII range of U+0000
// through U+007F. Consequently, the characters bracketing the 'X' character
// are replaced with the fallback replacement string, "(unknown)".

    string inputString = "\u00abX\u00bb";
    string decodedString;
    string twoNewLines = "\n\n";
    byte[] encodedBytes = new byte[ae.GetByteCount(inputString)];
    int numberOfEncodedBytes = 0;
    int ix = 0;

// --------------------------------------------------------------------------
// 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);
    ix = 0;
    foreach (byte b in encodedBytes)
        {
        Console.Write("0x{0:X2} ", (int)b);
        ix++;
        if (0 == ix % 6) Console.WriteLine();
        }
    Console.Write(twoNewLines);

// --------------------------------------------------------------------------
// Decode the encoded bytes, yielding a reconstituted string.

    Console.WriteLine("Decode the encoded bytes...");
    decodedString = ae.GetString(encodedBytes);

// Display the input string and the decoded string for comparison.
    Console.WriteLine("Input string:  \"{0}\"", inputString);
    Console.WriteLine("Decoded string:\"{0}\"", decodedString);
    }
}
/*
This code example produces the following results:

The name of the encoding is "us-ascii".

Input string (3 characters): "«X»"
Input string in hexadecimal: 0xAB 0x58 0xBB

Encode the input string...
Encoded bytes in hexadecimal (19 bytes):

0x28 0x75 0x6E 0x6B 0x6E 0x6F
0x77 0x6E 0x29 0x58 0x28 0x75
0x6E 0x6B 0x6E 0x6F 0x77 0x6E
0x29

Decode the encoded bytes...
Input string:  "«X»"
Decoded string:"(unknown)X(unknown)"

*/

' This example demonstrates the EncoderReplacementFallback class.
Imports System.Text

Class Sample
    Public Shared Sub Main() 
        
        ' Create an encoding, which is equivalent to calling the 
        ' ASCIIEncoding class constructor. 
        ' The EncoderReplacementFallback parameter specifies that the 
        ' string, "(unknown)", replace characters that cannot be encoded. 
        ' A decoder replacement fallback is also specified, but in this 
        ' code example the decoding operation cannot fail.  

        Dim erf As New EncoderReplacementFallback("(unknown)")
        Dim drf As New DecoderReplacementFallback("(error)")
        Dim ae As Encoding = Encoding.GetEncoding("us-ascii", erf, drf)
        
        ' The input string consists of the Unicode characters LEFT POINTING 
        ' DOUBLE ANGLE QUOTATION MARK (U+00AB), 'X' (U+0058), and RIGHT POINTING 
        ' DOUBLE ANGLE QUOTATION MARK (U+00BB). 
        ' The encoding can only encode characters in the US-ASCII range of U+0000 
        ' through U+007F. Consequently, the characters bracketing the 'X' character
        ' are replaced with the fallback replacement string, "(unknown)".

        Dim inputString As String = "«X»"
        Dim decodedString As String
        Dim twoNewLines As String = vbCrLf & vbCrLf
        Dim ix As Integer = 0
        Dim numberOfEncodedBytes As Integer = ae.GetByteCount(inputString)
        ' Counteract the compiler adding an extra byte to the array.
        Dim encodedBytes(numberOfEncodedBytes - 1) As Byte
        
        ' --------------------------------------------------------------------------
        ' 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)
        ix = 0
        Dim b As Byte
        For Each b In encodedBytes
            Console.Write("0x{0:X2} ", Convert.ToInt32(b))
            ix += 1
            If 0 = ix Mod 6 Then
                Console.WriteLine()
            End If
        Next b
        Console.Write(twoNewLines)
        
        ' --------------------------------------------------------------------------
        ' Decode the encoded bytes, yielding a reconstituted string.
        Console.WriteLine("Decode the encoded bytes...")
        decodedString = ae.GetString(encodedBytes)
        
        ' Display the input string and the decoded string for comparison.
        Console.WriteLine("Input string:  ""{0}""", inputString)
        Console.WriteLine("Decoded string:""{0}""", decodedString)
    
    End Sub
End Class
'
'This code example produces the following results:
'
'The name of the encoding is "us-ascii".
'
'Input string (3 characters): "X"
'Input string in hexadecimal: 0xAB 0x58 0xBB
'
'Encode the input string...
'Encoded bytes in hexadecimal (19 bytes):
'
'0x28 0x75 0x6E 0x6B 0x6E 0x6F
'0x77 0x6E 0x29 0x58 0x28 0x75
'0x6E 0x6B 0x6E 0x6F 0x77 0x6E
'0x29
'
'Decode the encoded bytes...
'Input string:  "X"
'Decoded string:"(unknown)X(unknown)"
'

Poznámky

Běžným důvodem selhání operace kódování nebo dekódování je, že základní třída kódování neposkytuje mapování mezi znakem a ekvivalentní bajtovou sekvencí. ASCIIEncoding Například objekt nemůže kódovat znak s hodnotou bodu kódu Unicode, která je mimo rozsah U+0000 až U+007F. Pokud vstupní znak nelze převést na výstupní bajtovou sekvenci, EncoderReplacementFallback nahradí objekt zadaný náhradní řetězec původním vstupním znakem. Proces převodu zakóduje náhradní řetězec a potom pokračuje ve zpracování zbytku původního vstupu.

Náhradní řetězec používaný objektem EncoderReplacementFallback je určen voláním jeho konstruktoru třídy. Jsou dostupné dvě možnosti:

• Nahrazení výchozím znakem Pokud voláte EncoderReplacementFallback() konstruktor, náhradní znak je "?" (U+003F).

• Nahrazení řetězcem podle vašeho výběru. Pokud voláte EncoderReplacementFallback(String) konstruktor, zadáte náhradní řetězec.

Pokud zvolíte záložní řetězec, který se má použít s touto třídou, ujistěte se, že se řetězec skládá zcela z znaků, které lze zakódovat v cílovém kódování. V opačném případě rekurzivní náhradní výsledky, což způsobuje ArgumentException.

Tato třída je jednou ze dvou tříd .NET Framework, které implementují různé záložní strategie pro zpracování chyb převodu kódování. Druhá třída je EncoderExceptionFallback třída, která vyvolá EncoderFallbackException , když je zjištěn neplatný znak.

Konstruktory

Name	Description
EncoderReplacementFallback()	Inicializuje novou instanci EncoderReplacementFallback třídy.
EncoderReplacementFallback(String)	Inicializuje novou instanci EncoderReplacementFallback třídy pomocí zadaného náhradního řetězce.

Vlastnosti

Name	Description
DefaultString	Získá náhradní řetězec, který je hodnota objektu EncoderReplacementFallback .
MaxCharCount	Získá počet znaků v náhradním řetězci objektu EncoderReplacementFallback .

Metody

Name	Description
CreateFallbackBuffer()	Vytvoří EncoderFallbackBuffer objekt, který se inicializuje s náhradním řetězcem tohoto EncoderReplacementFallback objektu.
Equals(Object)	Určuje, zda je hodnota zadaného objektu rovna objektu EncoderReplacementFallback .
GetHashCode()	Načte kód hash pro hodnotu objektu EncoderReplacementFallback .
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• EncoderReplacementFallbackBuffer
• EncoderReplacementFallback
• DefaultString
• Principy kódování