EncoderFallbackBuffer Klasse

Definition

Stellt einen Puffer bereit, der einen Fallback-Handler zulässt, der eine alternative Zeichenfolge an einen Encoder zurückzugibt, wenn eine Eingabezeichen nicht codiert werden kann.Provides a buffer that allows a fallback handler to return an alternate string to an encoder when it cannot encode an input character.

public ref class EncoderFallbackBuffer abstract
public abstract class EncoderFallbackBuffer
type EncoderFallbackBuffer = class
Public MustInherit Class EncoderFallbackBuffer
Vererbung
EncoderFallbackBuffer
Abgeleitet

Hinweise

Eine Codierung definiert eine Zuordnung zwischen einem Unicode-Zeichen und einer codierten Bytefolge.An encoding defines a mapping between a Unicode character and an encoded sequence of bytes. Ein Codierungs Vorgang, der ein Eingabezeichen in eine Ausgabe Byte Sequenz konvertiert, schlägt fehl, wenn für ein bestimmtes Zeichen keine Zuordnung definiert ist.An encoding operation, which converts an input character to an output byte sequence, fails if no mapping is defined for a particular character.

Der .NET Framework bietet einen Fehler Behandlungs Mechanismus, der als Fallback bezeichnet wird, wenn keine Konvertierung ausgeführt werden kann.The .NET Framework provides a failure handling mechanism, called a fallback, if a conversion cannot be performed. Alle encoderfallbackhandler müssen Folgendes implementieren:All encoder fallback handlers must implement the following:

  • Ein EncoderFallback, der durch eine von der EncoderFallback-Klasse abgeleitete Klasse dargestellt wird.An encoder fallback, which is represented by a class derived from the EncoderFallback class.

  • Ein Fall Back Puffer für einen Encoder, der durch einen von der EncoderFallbackBuffer-Klasse abgeleiteten Typ dargestellt wird, der eine Zeichenfolge an den Konvertierungs Vorgang zurückgeben kann.An encoder fallback buffer, which is represented by a type derived from the EncoderFallbackBuffer class that can return a string to the conversion operation.

Fallbacks können drei Strategien zur Behandlung von Konvertierungs Fehlern verwenden:Fallbacks can use three strategies to handle conversion failures:

  • Zuordnung mit einer optimalen Anpassung.Best-fit mapping. Der Fall Back Puffer des Encoders kann eine Zeichenfolge zurückgeben, die eine nahe Näherung zum Eingabezeichen darstellt.The encoder fallback buffer can return a string that represents a close approximation to the input character. Der .NET Framework stellt keine öffentliche EncoderFallbackBuffer Implementierung mit optimaler Anpassung bereit.The .NET Framework does not provide a public best-fit EncoderFallbackBuffer implementation.

  • Nachfolger.Replacement. Der Fall Back Puffer des Encoders kann eine Zeichenfolge zurückgeben, z. b. ein Fragezeichen ("?"), das angibt, dass ein Zeichen nicht codiert werden konnte.The encoder fallback buffer can return a string, such as a question mark ("?"), that indicates that a character could not be encoded. In der .NET Framework stellen die Klassen EncoderReplacementFallback und EncoderReplacementFallbackBuffer eine öffentliche Ersatz Fall Back Puffer Implementierung bereit.In the .NET Framework, the EncoderReplacementFallback and EncoderReplacementFallbackBuffer classes provide a public replacement fallback buffer implementation. Der Konstruktor der EncoderReplacementFallback-Klasse ermöglicht es Ihnen, die Ersetzungs Zeichenfolge zu definieren.The constructor of the EncoderReplacementFallback class enables you to define the replacement string.

  • Ausnahme.Exception. Die EncoderFallbackBuffer-Implementierung löst eine Ausnahme aus, die angibt, dass ein Zeichen nicht codiert werden kann, und beendet den Codierungs Vorgang.The EncoderFallbackBuffer implementation throws an exception, which indicates that a character cannot be encoded, and terminates the encoding operation. In diesem Fall muss der Fall Back Handler eine EncoderFallbackBuffer Implementierung bereitstellen, obwohl er keine Zeichenfolge an den Encoder zurückgibt.In this case, the fallback handler must provide an EncoderFallbackBuffer implementation, although it does not return a string to the encoder. In der .NET Framework stellen die Klassen EncoderExceptionFallback und EncoderExceptionFallbackBuffer eine öffentliche Ausnahmefall Back Implementierung dar, die eine EncoderFallbackException auslöst, wenn ein Zeichen nicht codiert werden kann.In the .NET Framework, the EncoderExceptionFallback and EncoderExceptionFallbackBuffer classes provide a public exception fallback implementation that throws an EncoderFallbackException when a character cannot be encoded.

Der Puffer in einer EncoderFallbackBuffer-Implementierung stellt die gesamte Zeichenfolge dar, die als Reaktion auf einen EncoderFallback an den Encoder zurückgegeben werden soll.The buffer in an EncoderFallbackBuffer implementation represents the entire string to be returned to the encoder in response to an encoder fallback. Im Allgemeinen enthalten Implementierungen auch Zustandsinformationen, z. b. den Index des nächsten Zeichens, das an den Encoder zurückgegeben werden soll, und die Anzahl der verbleibenden Zeichen, die zurückgegeben werden sollen.Generally, implementations also include state information, such as the index of the next character to return to the encoder and the number of remaining characters to be returned. Da EncoderFallbackBuffer eine abstrakte Klasse ist, ist es erforderlich, dass abgeleitete Klassen mindestens die folgenden Member implementieren:Because EncoderFallbackBuffer is an abstract class, it requires derived classes to implement the following members at a minimum:

  • Die überladene Fallback Methode, die vom Encoder aufgerufen wird, wenn ein Zeichen nicht codiert werden kann.The overloaded Fallback method, which is called by the encoder when it cannot encode a character. Der Encoder übergibt zwei Informationen an die Implementierung des Fall Back Puffers: das Zeichen oder Ersatz Zeichenpaar, das nicht codiert werden konnte, und den Index des Zeichens in der Eingabe.The encoder passes two pieces of information to the fallback buffer implementation: the character or surrogate pair that could not be encoded and the index of the character in the input. In einem Ausnahmehandler für einen EncoderFallback wird die Ausnahme in dieser Methode ausgelöst.In an encoder fallback exception handler, the exception is thrown in this method. Andernfalls gibt die Methode true zurück, wenn Sie einen Fallback bereitstellt, oder false, wenn dies nicht der Fall ist.Otherwise, the method returns true if it provides a fallback, or false if it does not.

  • Die GetNextChar-Methode, die wiederholt vom Encoder aufgerufen wird, wenn die Fallback-Methode truezurückgibt.The GetNextChar method, which is called repeatedly by the encoder if the Fallback method returns true. Bei aufeinander folgenden Aufrufen sollte der Handler jedes Zeichen im Puffer zurückgeben.In successive calls, the handler should return each character in its buffer. Wenn alle Zeichen zurückgegeben wurden, sollte Sie U + 0000 zurückgeben.When it has returned all characters, it should return U+0000. Ein Ausnahmehandler gibt immer U + 0000 zurück.An exception handler always returns U+0000.

  • Die MovePrevious-Methode, die versucht, den Zeiger auf die vorherige Position im Puffer zu verschieben und angibt, ob die Verschiebung erfolgreich war.The MovePrevious method, which tries to move the pointer to the previous position in the buffer and indicates whether the move was successful. Ein Ausnahmehandler gibt immer falsezurück.An exception handler always returns false.

  • Die Remaining-Eigenschaft, die die Anzahl der verbleibenden Zeichen angibt, die an den Encoder zurückgegeben werden sollen.The Remaining property, which indicates the number of remaining characters to be returned to the encoder. Ein Ausnahmefall Back Handler gibt immer 0 (null) zurück.An exception fallback handler always returns zero.

Konstruktoren

EncoderFallbackBuffer()

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

Eigenschaften

Remaining

Ruft beim Überschreiben in einer abgeleiteten Klasse die Anzahl der Zeichen im aktuellen EncoderFallbackBuffer-Objekt ab, die noch zu verarbeiten sind.When overridden in a derived class, gets the number of characters in the current EncoderFallbackBuffer object that remain to be processed.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
Fallback(Char, Char, Int32)

Bereitet beim Überschreiben in einer abgeleiteten Klasse den Fallbackpuffer darauf vor, das angegebene Ersatzzeichenpaar zu behandeln.When overridden in a derived class, prepares the fallback buffer to handle the specified surrogate pair.

Fallback(Char, Int32)

Bereitet beim Überschreiben in einer abgeleiteten Klasse den Fallbackpuffer darauf vor, das angegebene Eingabezeichen zu behandeln.When overridden in a derived class, prepares the fallback buffer to handle the specified input character.

GetHashCode()

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

(Geerbt von Object)
GetNextChar()

Ruft beim Überschreiben in einer abgeleiteten Klasse das nächste Zeichen im Fallbackpuffer ab.When overridden in a derived class, retrieves the next character in the fallback buffer.

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)
MovePrevious()

Veranlasst beim Überschreiben in einer abgeleiteten Klasse, dass der nächste Aufruf an die GetNextChar()-Methode auf die Datenpufferzeichenposition vor der aktuellen Zeichenposition zugreift.When overridden in a derived class, causes the next call to the GetNextChar() method to access the data buffer character position that is prior to the current character position.

Reset()

Initialisiert alle Daten und Zustandsinformationen, die diesen Fallbackpuffer betreffen.Initializes all data and state information pertaining to this fallback buffer.

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