EncoderReplacementFallback Klass

Definition

Namnområde:

System.Text

Sammansättning:

mscorlib.dll

Tillhandahåller en mekanism för felhantering, som kallas återställning, för ett indatatecken som inte kan konverteras till en utdatabytesekvens. Återställningen använder en användardefinerad ersättningssträng i stället för det ursprungliga indatatecknet. Det går inte att ärva den här klassen.

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

[System.Serializable]
public sealed class EncoderReplacementFallback : System.Text.EncoderFallback

[<System.Serializable>]
type EncoderReplacementFallback = class
    inherit EncoderFallback

Public NotInheritable Class EncoderReplacementFallback
Inherits EncoderFallback

Arv

Object

EncoderFallback

EncoderReplacementFallback

Attribut

SerializableAttribute

Exempel

I följande exempel visas EncoderReplacementFallback klassen.

// 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)"
'

Kommentarer

En vanlig orsak till att en kodnings- eller avkodningsåtgärd misslyckas är om den underliggande kodningsklassen inte tillhandahåller någon mappning mellan ett tecken och en motsvarande bytesekvens. Ett objekt kan till exempel ASCIIEncoding inte koda ett tecken med ett Unicode-kodpunktsvärde som ligger utanför intervallet U+0000 till U+007F. Om indatatecknet inte kan konverteras till en utdatabytesekvens ersätter ett EncoderReplacementFallback objekt en angiven ersättningssträng för det ursprungliga indatatecknet. Konverteringsprocessen kodar ersättningssträngen och fortsätter sedan att bearbeta resten av de ursprungliga indata.

Ersättningssträngen som används av ett EncoderReplacementFallback objekt bestäms av anropet till dess klasskonstruktor. Det finns två alternativ:

• Ersättning med standardtecknet. Om du anropar EncoderReplacementFallback() konstruktorn är ersättningstecknet "?" (U+003F).

• Ersätt med valfri sträng. Om du anropar EncoderReplacementFallback(String) konstruktorn anger du ersättningssträngen.

Om du väljer en reservsträng som ska användas med den här klassen kontrollerar du att strängen helt består av tecken som kan kodas i målkodningen. Annars resulterar en rekursiv reserv som orsakar en ArgumentException.

Den här klassen är en av två .NET Framework-klasser som implementerar olika återställningsstrategier för hantering av kodningskonverteringsfel. Den andra klassen är EncoderExceptionFallback klassen, som genererar ett EncoderFallbackException när ett ogiltigt tecken påträffas.

Konstruktorer

Name	Description
EncoderReplacementFallback()	Initierar en ny instans av EncoderReplacementFallback klassen.
EncoderReplacementFallback(String)	Initierar en ny instans av klassen med hjälp av EncoderReplacementFallback en angiven ersättningssträng.

Egenskaper

Name	Description
DefaultString	Hämtar ersättningssträngen som är objektets EncoderReplacementFallback värde.
MaxCharCount	Hämtar antalet tecken i ersättningssträngen EncoderReplacementFallback för objektet.

Metoder

Name	Description
CreateFallbackBuffer()	Skapar ett EncoderFallbackBuffer objekt som initieras med ersättningssträngen för det här EncoderReplacementFallback objektet.
Equals(Object)	Anger om värdet för ett angivet objekt är lika med objektet EncoderReplacementFallback .
GetHashCode()	Hämtar hash-koden för objektets EncoderReplacementFallback värde.
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)

Se även

• EncoderReplacementFallbackBuffer
• EncoderReplacementFallback
• DefaultString
• Förstå kodningar