EncoderFallback Klas

Definitie

Naamruimte:
System.Text
Assembly's:
mscorlib.dll, System.Text.Encoding.dll
Assembly:
mscorlib.dll
Assembly:
System.Text.Encoding.dll
Assembly:
netstandard.dll

Biedt een mechanisme voor foutafhandeling, een terugval genoemd, voor een invoerteken dat niet kan worden geconverteerd naar een gecodeerde bytereeks voor uitvoer.

public ref class EncoderFallback abstract
public abstract class EncoderFallback
[System.Serializable]
public abstract class EncoderFallback
type EncoderFallback = class
[<System.Serializable>]
type EncoderFallback = class
Public MustInherit Class EncoderFallback
Overname
Object
EncoderFallback
Afgeleid
Kenmerken
SerializableAttribute

Opmerkingen

Een codering wijst een Unicode-teken toe aan een gecodeerde reeks bytes. Een bepaalde codering wordt vertegenwoordigd door een type dat is afgeleid van de Encoding klasse. Een teken wordt met name gecodeerd in een bytereeks door de methode van Encoding.GetBytes het coderingstype aan te roepen en de bytereeks wordt gedecodeerd naar een tekenmatrix of een tekenreeks door de Encoding.GetChars of Encoding.GetString methode aan te roepen.

Een coderingsbewerking kan mislukken als het invoerteken niet kan worden vertegenwoordigd door de codering. Een object kan bijvoorbeeld ASCIIEncoding geen teken coderen waarvan de Waarde van het Unicode-codepunt buiten het bereik U+0000 tot U+0007F valt.

Wanneer een coderingsconversie niet kan worden uitgevoerd, biedt .NET Framework een mechanisme voor foutafhandeling dat een terugval wordt genoemd. Uw toepassing kan vooraf gedefinieerde .NET Framework-coderingsprogramma-terugval gebruiken of kan een aangepaste encoderback maken die is afgeleid van de klassen EncoderFallback en EncoderFallbackBuffer.

EncoderFallback en EncoderFallbackBuffer zijn de basisklassen voor alle coderingshandlers in het .NET Framework. Ze ondersteunen de volgende drie soorten terugvalafhandelingsmechanismen:

  • Meest geschikte terugval, waarmee geldige Unicode-tekens worden toegewezen die niet kunnen worden gecodeerd naar een geschatte equivalent. Een best passende terugvalhandler voor de ASCIIEncoding klasse kan bijvoorbeeld Æ (U+00C6) toewijzen aan AE (U+0041 + U+0045). Een geschiktste terugvalhandler kan ook worden geïmplementeerd om één alfabet (zoals Cyrillisch) te translitereren naar een ander (zoals Latijns of Romeins). .NET Framework biedt geen openbare best passende terugval-implementaties.

  • Vervangende terugval, die elk teken vervangt dat niet kan worden gecodeerd door een vooraf gedefinieerde tekenreeks. .NET Framework biedt een vooraf gedefinieerde vervangingshandler. De EncoderReplacementFallback klasse vervangt elke bytereeks die niet kan worden gedecodeerd met een vraagteken (', of U+003F) of een VERVANGEND TEKEN (U+FFFD). U kunt de vervangende tekenreeks aanpassen door een vervanging op te geven in de aanroep naar de EncoderReplacementFallback.EncoderReplacementFallback(String) constructor. Nadat de vervangende tekenreeks is verzonden, blijft de coderingsbewerking de rest van de invoer converteren.

  • Uitzonderingsterugval, waardoor een uitzondering wordt gegenereerd wanneer een teken niet kan worden gecodeerd. .NET Framework biedt een vooraf gedefinieerde uitzonderingsbackhandler. De EncoderExceptionFallback klasse genereert een EncoderFallbackException wanneer er een ongeldig teken wordt aangetroffen en de coderingsbewerking wordt beëindigd.

Als u ervoor kiest om een aangepaste oplossing te implementeren, moet u de volgende abstracte leden van de EncoderFallback klasse overschrijven:

  • De CreateFallbackBuffer methode, die een klasse-exemplaar retourneert dat is afgeleid van EncoderFallbackBuffer. Afhankelijk van het type terugvalhandler dat u ontwikkelt, is de EncoderFallbackBuffer implementatie verantwoordelijk voor het uitvoeren van de toewijzing of vervanging of voor het genereren van de uitzondering.

  • De MaxCharCount eigenschap, die het maximum aantal tekens retourneert dat door de terugval-implementatie kan worden geretourneerd. Voor een terugvalhandler voor uitzonderingen moet de waarde nul zijn.

Zie Character Encoding in het .NET Framework voor meer informatie over coderings-, coderings- en terugvalstrategieën.

Constructors

Name Description
EncoderFallback()

Initialiseert een nieuw exemplaar van de EncoderFallback klasse.

Eigenschappen

Name Description
ExceptionFallback

Hiermee wordt een object opgehaald dat een uitzondering genereert wanneer een invoerteken niet kan worden gecodeerd.
MaxCharCount

Wanneer het wordt overschreven in een afgeleide klasse, wordt het maximum aantal tekens opgehaald dat het huidige EncoderFallback object kan retourneren.
ReplacementFallback

Hiermee wordt een object opgehaald dat een vervangende tekenreeks uitvoert in plaats van een invoerteken dat niet kan worden gecodeerd.

Methoden

Name Description
CreateFallbackBuffer()

Wanneer deze wordt overschreven in een afgeleide klasse, initialiseert u een nieuw exemplaar van de EncoderFallbackBuffer klasse.
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Van toepassing op

Zie ook