System.Text-Namespace

Aktualisiert: April 2011

Die Codierungsklassen sind hauptsächlich für die Konvertierung zwischen verschiedenen Codierungen bzw. Codepages und einer Unicode-Codierung vorgesehen. Encoding.Unicode (UTF-16)-Codierung wird von .NET Framework intern verwendet, und Encoding.UTF8-Codierung wird oft zum Speichern von Zeichendaten verwendet, um Portabilität zwischen Computern und Kulturen sicherzustellen.

Die von Encoding abgeleiteten Klassen ermöglichen es Ihnen, eine Fallbackstrategie auszuwählen, die bestimmt, wie Zeichen, die nicht in eine Bytesequenz codiert werden können, oder Bytes, die nicht in Zeichen decodiert werden können, behandelt werden. Sie können eine der folgenden Optionen auswählen:

• Ausnahmefallback. Sie können Ausnahmen bei Datenfehlern entweder mit einem throwonerror-Flag, das in einigen Klassenkonstruktoren zur Verfügung steht, oder mit den Klassen EncoderExceptionFallback und DecoderExceptionFallback auslösen. Wenn Sie um die Integrität des Datenstreams besorgt sind, wird empfohlen, eine Ausnahme auszulösen.

• Ersatzfallback. Sie können mit den Klassen EncoderFallback und DecoderFallback ein Zeichen ohne Meldung in "?" oder das Unicode-Ersatzzeichen (U+FFFD) ändern.

• Fallback mit ähnlichen Zeichen. Diese Option ordnet einem Zeichen in einer Codierung ein Zeichen in einer anderen Codierung zu. Der Fallback auf das am besten geeignete Zeichen wird häufig nicht empfohlen, da dies zu Datenverlusten und Verwechslungen führen kann und zudem langsamer als einfache "?"-Zeichenersetzungen ist. Bei ANSI-Codepages ist jedoch das am besten geeignete Verhalten der Standard.

Die StringBuilder-Klasse wird für Vorgänge entworfen, die umfangreiche Bearbeitungen auf einer einzelnen Zeichenfolge ausführen. Im Gegensatz zur String-Klasse ist die StringBuilder-Klasse änderbar und stellt bessere Leistung beim Verketten oder Löschen von Zeichenfolgen bereit.

Weitere Informationen zu System.Text finden Sie unter Zeichencodierung in .NET Framework und im MSDN-Blog Gedanken zu Windows- und .NET Framework-Globalisierungs-APIs von Shawn Steele.

Klassen

---

	Klasse	Beschreibung
	ASCIIEncoding	Stellt eine ASCII-Zeichencodierung von Unicode-Zeichen dar.
	Decoder	Konvertiert eine Folge codierter Bytes in Zeichen.
	DecoderExceptionFallback	Löst DecoderFallbackException aus, wenn eine codierte Eingabebytefolge nicht in ein decodiertes Ausgabezeichen konvertiert werden kann. Diese Klasse kann nicht vererbt werden.
	DecoderExceptionFallbackBuffer	Löst DecoderFallbackException aus, wenn eine codierte Eingabebytefolge nicht in ein decodiertes Ausgabezeichen konvertiert werden kann. Diese Klasse kann nicht vererbt werden.
	DecoderFallback	Stellt einen als Fallback bezeichneten Fehlerbehandlungsmechanismus für eine codierte Eingabebytefolge bereit, die nicht in ein Ausgabezeichen konvertiert werden kann.
	DecoderFallbackBuffer	Stellt einen Puffer bereit, der einem Fallbackhandler ermöglicht, eine alternative Zeichenfolge an einen Decoder zurückzugeben, wenn keine Eingabebytesequenz decodiert werden kann.
	DecoderFallbackException	Die Ausnahme, die ausgelöst wird, wenn ein Decoderfallback fehlschlägt. Diese Klasse kann nicht vererbt werden.
	DecoderReplacementFallback	Stellt einen als Fallback bezeichneten Fehlerbehandlungsmechanismus für eine codierte Eingabebytefolge bereit, die nicht in ein Ausgabezeichen konvertiert werden kann. Der Fallback gibt eine benutzerdefinierte Ersatzzeichenfolge anstelle einer decodierten Eingabebytefolge aus. Diese Klasse kann nicht vererbt werden.
	DecoderReplacementFallbackBuffer	Stellt eine Ersatzausgabezeichenfolge dar, die ausgegeben wird, wenn die ursprüngliche Eingabebytefolge nicht decodiert werden kann. Diese Klasse kann nicht vererbt werden.
	Encoder	Konvertiert Zeichen in eine Bytefolge.
	EncoderExceptionFallback	Löst eine EncoderFallbackException aus, wenn ein Eingabezeichen nicht in eine codierte Ausgabebytefolge konvertiert werden kann. Diese Klasse kann nicht vererbt werden.
	EncoderExceptionFallbackBuffer	Löst eine EncoderFallbackException aus, wenn ein Eingabezeichen nicht in eine codierte Ausgabebytefolge konvertiert werden kann. Diese Klasse kann nicht vererbt werden.
	EncoderFallback	Stellt einen als Fallback bezeichneten Fehlerbehandlungsmechanismus für ein Eingabezeichen bereit, das nicht in eine codierte Ausgabebytefolge konvertiert werden kann.
	EncoderFallbackBuffer	Stellt einen Puffer bereit, der einem Fallbackhandler ermöglicht, eine alternative Zeichenfolge an einen Encoder zurückzugeben, wenn keine Eingabezeichen codiert werden können.
	EncoderFallbackException	Die Ausnahme, die ausgelöst wird, wenn ein Fallbackvorgang fehlschlägt. Diese Klasse kann nicht vererbt werden.
	EncoderReplacementFallback	Stellt einen als Fallback bezeichneten Fehlerbehandlungsmechanismus für ein Eingabezeichen bereit, das nicht in eine Ausgabebytefolge konvertiert werden kann. Beim Fallback wird statt des ursprünglichen Eingabezeichens eine vom Benutzer angegebene Ersatzzeichenfolge verwendet. Diese Klasse kann nicht vererbt werden.
	EncoderReplacementFallbackBuffer	Stellt eine Ersatzeingabezeichenfolge dar, die verwendet wird, wenn das ursprüngliche Eingabezeichen nicht codiert werden kann. Diese Klasse kann nicht vererbt werden.
	Encoding	Stellt eine Zeichencodierung dar.
	EncodingInfo	Stellt grundlegende Informationen über eine Codierung bereit.
	StringBuilder	Stellt eine veränderbare Zeichenfolge dar. Diese Klasse kann nicht vererbt werden.
	UnicodeEncoding	Stellt eine UTF-16-Codierung von Unicode-Zeichen dar.
	UTF32Encoding	Stellt eine UTF-32-Codierung von Unicode-Zeichen dar.
	UTF7Encoding	Stellt eine UTF-7-Codierung von Unicode-Zeichen dar.
	UTF8Encoding	Stellt eine UTF-8-Codierung von Unicode-Zeichen dar.

Enumerationen

---

	Enumeration	Beschreibung
	NormalizationForm	Definiert den Typ der auszuführenden Normalisierung.

Änderungsprotokoll

---

Datum	Versionsgeschichte	Grund
April 2011	Die Zusammenfassung wurde erweitert.	Kundenfeedback.