EncoderFallback Klasse

Definition

Stellt einen als Fallback bezeichneten Fehlerbehandlungsmechanismus für ein Eingabezeichen bereit, das nicht in eine codierte Ausgabebytefolge konvertiert werden kann.Provides a failure-handling mechanism, called a fallback, for an input character that cannot be converted to an encoded output byte sequence.

public ref class EncoderFallback abstract
[System.Serializable]
public abstract class EncoderFallback
type EncoderFallback = class
Public MustInherit Class EncoderFallback
Vererbung
EncoderFallback
Abgeleitet
Attribute

Hinweise

Eine Codierung ordnet ein Unicode-Zeichen einer codierten Bytefolge zu.An encoding maps a Unicode character to an encoded sequence of bytes. Eine bestimmte Codierung wird durch einen Typ dargestellt, der von der Encoding -Klasse abgeleitet wird.A particular encoding is represented by a type that is derived from the Encoding class. Insbesondere wird ein Zeichen in eine Bytefolge codiert, indem die-Methode Encoding.GetBytes des Codierungs Typs aufgerufen wird, und die Byte Sequenz wird in ein Zeichen Array oder eine Zeichenfolge Encoding.GetString decodiert, indem die-Methode oder die Encoding.GetChars -Methode aufgerufen wird.Specifically, a character is encoded to a byte sequence by calling the encoding type's Encoding.GetBytes method, and the byte sequence is decoded to a character array or a string by calling the Encoding.GetChars or Encoding.GetString method.

Ein Codierungs Vorgang kann fehlschlagen, wenn das Eingabezeichen nicht durch die Codierung dargestellt werden kann.An encoding operation can fail if the input character cannot be represented by the encoding. Ein ASCIIEncoding Objekt kann z. b. kein Zeichen codieren, dessen Unicode-Code Punkt Wert außerhalb des Bereichs u + 0000 bis u + 007F liegt.For example, an ASCIIEncoding object cannot encode a character whose Unicode code point value is outside the range U+0000 to U+007F.

Wenn eine Codierungs Konvertierung nicht durchgeführt werden kann, stellt die .NET Framework einen als Fallback bezeichneten Fehler Behandlungs Mechanismus bereit.When an encoding conversion cannot be performed, the .NET Framework provides a failure-handling mechanism called a fallback. Die Anwendung kann vordefinierte .NET Framework Encoder-Fallbacks verwenden oder ein benutzerdefiniertes EncoderFallback erstellen, EncoderFallback das EncoderFallbackBuffer von der-Klasse und der-Klasse abgeleitet wird.Your application can use predefined .NET Framework encoder fallbacks, or it can create a custom encoder fallback derived from the EncoderFallback and EncoderFallbackBuffer classes.

EncoderFallbackund EncoderFallbackBuffer sind die Basisklassen für alle Codierungs Fall Back Handler in der .NET Framework.EncoderFallback and EncoderFallbackBuffer are the base classes for all encoding fallback handlers in the .NET Framework. Sie unterstützen die folgenden drei Arten von Fall Back Behandlungs Mechanismen:They support the following three kinds of fallback handling mechanisms:

  • Fallback mit ähnlichen Zeichen, bei dem gültige Unicode-Zeichen zugeordnet werden, die nicht in eine ungefähre Entsprechung codiert werden können.Best-fit fallback, which maps valid Unicode characters that cannot be encoded to an approximate equivalent. Beispielsweise kann ein Fall Back-Handler mit einer optimalen Anpassung ASCIIEncoding für die-Klasse "Æ (u + 00c6)" in "AE" (u + 0041 + U + 0045) zuordnen.For example, a best-fit fallback handler for the ASCIIEncoding class might map Æ (U+00C6) to AE (U+0041 + U+0045). Ein Fall Back-Handler mit einer optimalen Anpassung kann auch für die Umwandlung eines Alphabets (z. b. Kyrillisch) in einen anderen (z. b. lateinisch oder Roman) implementiert werden.A best-fit fallback handler might also be implemented to transliterate one alphabet (such as Cyrillic) to another (such as Latin or Roman). Der .NET Framework stellt keine öffentlichen Fall Back-Implementierungen mit einer optimalen Anpassung bereit.The .NET Framework does not provide any public best-fit fallback implementations.

  • Ersatz Fall Back, bei dem jedes Zeichen, das nicht mit einer vordefinierten Zeichenfolge codiert werden kann, ersetzt wird.Replacement fallback, which replaces each character that cannot be encoded with a predefined string. Der .NET Framework stellt einen vordefinierten Ersatz Fall Back Handler bereit.The .NET Framework provides a predefined replacement fallback handler. Die EncoderReplacementFallback -Klasse ersetzt jede Byte Sequenz, die nicht decodiert werden kann, durch ein Fragezeichen ("?", u + 003F) oder ein Ersatz Zeichen (u + FFFD).The EncoderReplacementFallback class replaces each byte sequence that cannot be decoded with a question mark character ("?", or U+003F) or a REPLACEMENT CHARACTER (U+FFFD). Sie können die Ersetzungs Zeichenfolge anpassen, EncoderReplacementFallback.EncoderReplacementFallback(String) indem Sie einen Ersatz im aufrufkonstruktor angeben.You can customize the replacement string by specifying a substitute in the call to the EncoderReplacementFallback.EncoderReplacementFallback(String) constructor. Nachdem die Ersatz Zeichenfolge ausgegeben wurde, setzt der Codierungs Vorgang den Rest der Eingabe fort.After the substitute string is emitted, the encoding operation continues converting the remainder of the input.

  • Ausnahmefall Back, wodurch eine Ausnahme ausgelöst wird, wenn ein Zeichen nicht codiert werden kann.Exception fallback, which throws an exception when a character cannot be encoded. Der .NET Framework stellt einen vordefinierten Ausnahmefall Back Handler bereit.The .NET Framework provides a predefined exception fallback handler. Die EncoderExceptionFallback -Klasse löst EncoderFallbackException eine aus, wenn ein ungültiges Zeichen gefunden wird und der Codierungs Vorgang beendet wird.The EncoderExceptionFallback class throws an EncoderFallbackException when an invalid character is encountered, and the encoding operation terminates.

Wenn Sie sich dafür entscheiden, eine benutzerdefinierte Lösung zu implementieren, müssen Sie die folgenden abstrakten EncoderFallback Member der-Klasse überschreiben:If you choose to implement a custom solution, you must override the following abstract members of the EncoderFallback class:

  • Die CreateFallbackBuffer -Methode, die eine von EncoderFallbackBufferabgeleitete Klasseninstanz zurückgibt.The CreateFallbackBuffer method, which returns a class instance derived from EncoderFallbackBuffer. Abhängig vom Typ des Fall Back Handlers, den Sie entwickeln, ist EncoderFallbackBuffer die Implementierung für die Durchführung der Zuordnung oder Ersetzung oder für das Auslösen der Ausnahme verantwortlich.Depending on the type of fallback handler that you are developing, the EncoderFallbackBuffer implementation is responsible for performing the mapping or replacement, or for throwing the exception.

  • Die MaxCharCount -Eigenschaft, die die maximale Anzahl von Zeichen zurückgibt, die die Fall Back Implementierung zurückgeben kann.The MaxCharCount property, which returns the maximum number of characters that the fallback implementation can return. Bei einem Ausnahmefall Back Handler sollte der Wert 0 (null) lauten.For an exception fallback handler, its value should be zero.

Weitere Informationen zu Codierungs-, Decodierungs-und Fall Back Strategien finden Sie unter Zeichencodierung in der .NET Framework.For more information about encoding, decoding, and fallback strategies, see Character Encoding in the .NET Framework.

Konstruktoren

EncoderFallback()

Initialisiert eine neue Instanz der EncoderFallback-Klasse.Initializes a new instance of the EncoderFallback class.

Eigenschaften

ExceptionFallback

Ruft ein Objekt ab, das eine Ausnahme auslöst, wenn ein Eingabezeichen nicht codiert werden kann.Gets an object that throws an exception when an input character cannot be encoded.

MaxCharCount

Beim Überschreiben in einer abgeleiteten Klasse wird die maximale Anzahl von Zeichen abgerufen, die das aktuelle EncoderFallback-Objekt zurückgeben kann.When overridden in a derived class, gets the maximum number of characters the current EncoderFallback object can return.

ReplacementFallback

Ruft ein Objekt ab, das eine Ersatzzeichenfolge anstelle eines Eingabezeichens ausgibt, die nicht codiert werden kann.Gets an object that outputs a substitute string in place of an input character that cannot be encoded.

Methoden

CreateFallbackBuffer()

Initialisiert beim Überschreiben in einer abgeleiteten Klasse eine neue Instanz der EncoderFallbackBuffer-Klasse.When overridden in a derived class, initializes a new instance of the EncoderFallbackBuffer class.

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch