System.Text Namespace

Der System.Text-Namespace enthält Klassen, die ASCII- und Unicode-Zeichen darstellen, abstrakte Basisklassen zum Konvertieren von Zeichenblöcken in und aus Byteblöcken und eine Hilfsklasse, die String-Objekte bearbeitet und formatiert, ohne Zwischeninstanzen von String zu erstellen. The System.Text namespace contains classes that represent ASCII and Unicode character encodings; abstract base classes for converting blocks of characters to and from blocks of bytes; and a helper class that manipulates and formats String objects without creating intermediate instances of String.

Klassen

ASCIIEncoding

Stellt eine ASCII-Zeichencodierung von Unicode-Zeichen dar.Represents an ASCII character encoding of Unicode characters.

CodePagesEncodingProvider

Bietet Zugriff auf einen Codierungsanbieter für Codepages, die andernfalls nur im .NET-Framework für Desktop verfügbar sind.Provides access to an encoding provider for code pages that otherwise are available only in the desktop .NET Framework.

Decoder

Konvertiert eine Folge codierter Bytes in Zeichen.Converts a sequence of encoded bytes into a set of characters.

DecoderExceptionFallback

Stellt einen als Fallback bezeichneten Fehlerbehandlungsmechanismus für eine codierte Eingabebytefolge bereit, die nicht in ein Eingabezeichen konvertiert werden kann.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an input character. Der Fallback löst eine Ausnahme aus, statt die Eingabebytefolge zu decodieren.The fallback throws an exception instead of decoding the input byte sequence. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

DecoderExceptionFallbackBuffer

Löst DecoderFallbackException aus, wenn eine codierte Eingabebytefolge nicht in ein decodiertes Ausgabezeichen konvertiert werden kann.Throws DecoderFallbackException when an encoded input byte sequence cannot be converted to a decoded output character. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

DecoderFallback

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

DecoderFallbackBuffer

Stellt einen Puffer bereit, der einem Fallbackhandler ermöglicht, eine alternative Zeichenfolge an einen Decoder zurückzugeben, wenn keine Eingabebytesequenz decodiert werden kann.Provides a buffer that allows a fallback handler to return an alternate string to a decoder when it cannot decode an input byte sequence.

DecoderFallbackException

Die Ausnahme, die ausgelöst wird, wenn ein Decoderfallback fehlschlägt.The exception that is thrown when a decoder fallback operation fails. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

DecoderReplacementFallback

Stellt einen als Fallback bezeichneten Fehlerbehandlungsmechanismus für eine codierte Eingabebytefolge bereit, die nicht in ein Ausgabezeichen konvertiert werden kann.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an output character. Der Fallback gibt eine benutzerdefinierte Ersatzzeichenfolge anstelle einer decodierten Eingabebytefolge aus.The fallback emits a user-specified replacement string instead of a decoded input byte sequence. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

DecoderReplacementFallbackBuffer

Stellt eine Ersatzausgabezeichenfolge dar, die ausgegeben wird, wenn die ursprüngliche Eingabebytefolge nicht decodiert werden kann.Represents a substitute output string that is emitted when the original input byte sequence cannot be decoded. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

Encoder

Konvertiert Zeichen in eine Bytefolge.Converts a set of characters into a sequence of bytes.

EncoderExceptionFallback

Stellt einen als Fallback bezeichneten Fehlerbehandlungsmechanismus für ein Eingabezeichen bereit, das nicht in eine Ausgabebytefolge konvertiert werden kann.Provides a failure-handling mechanism, called a fallback, for an input character that cannot be converted to an output byte sequence. Der Fallback löst eine Ausnahme aus, wenn ein Eingabezeichen nicht in eine Ausgabebytefolge konvertiert werden kann.The fallback throws an exception if an input character cannot be converted to an output byte sequence. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

EncoderExceptionFallbackBuffer

Löst eine EncoderFallbackException aus, wenn ein Eingabezeichen nicht in eine codierte Ausgabebytefolge konvertiert werden kann.Throws EncoderFallbackException when an input character cannot be converted to an encoded output byte sequence. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

EncoderFallback

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.

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.Provides a buffer that allows a fallback handler to return an alternate string to an encoder when it cannot encode an input character.

EncoderFallbackException

Die Ausnahme, die ausgelöst wird, wenn ein Fallbackvorgang fehlschlägt.The exception that is thrown when an encoder fallback operation fails. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

EncoderReplacementFallback

Stellt einen als Fallback bezeichneten Fehlerbehandlungsmechanismus für ein Eingabezeichen bereit, das nicht in eine Ausgabebytefolge konvertiert werden kann.Provides a failure handling mechanism, called a fallback, for an input character that cannot be converted to an output byte sequence. Beim Fallback wird statt des ursprünglichen Eingabezeichens eine vom Benutzer angegebene Ersatzzeichenfolge verwendet.The fallback uses a user-specified replacement string instead of the original input character. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

EncoderReplacementFallbackBuffer

Stellt eine Ersatzeingabezeichenfolge dar, die verwendet wird, wenn das ursprüngliche Eingabezeichen nicht codiert werden kann.Represents a substitute input string that is used when the original input character cannot be encoded. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

Encoding

Stellt eine Zeichencodierung dar.Represents a character encoding.

EncodingInfo

Stellt grundlegende Informationen über eine Codierung bereit.Provides basic information about an encoding.

EncodingProvider

Stellt die Basisklasse für einen Codierungsanbieter bereit, der Codierungen liefert, die auf einer bestimmten Plattform nicht verfügbar sind.Provides the base class for an encoding provider, which supplies encodings that are unavailable on a particular platform.

StringBuilder

Stellt eine veränderbare Zeichenfolge dar.Represents a mutable string of characters. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

UnicodeEncoding

Stellt eine UTF-16-Codierung von Unicode-Zeichen dar.Represents a UTF-16 encoding of Unicode characters.

UTF32Encoding

Stellt eine UTF-32-Codierung von Unicode-Zeichen dar.Represents a UTF-32 encoding of Unicode characters.

UTF7Encoding

Stellt eine UTF-7-Codierung von Unicode-Zeichen dar.Represents a UTF-7 encoding of Unicode characters.

UTF8Encoding

Stellt eine UTF-8-Codierung von Unicode-Zeichen dar.Represents a UTF-8 encoding of Unicode characters.

Strukturen

Rune

Stellt einen Unicode-Skalarwert dar ( [ U+0000..U+D7FF ], einschließlich; oder [ U+E000..U+10FFFF ], einschließlich).Represents a Unicode scalar value ([ U+0000..U+D7FF ], inclusive; or [ U+E000..U+10FFFF ], inclusive).

SpanRuneEnumerator

Stellt einen Enumerator für die Rune-Werte bereit, die durch einen Bereich dargestellt werden, der UTF-16-Text enthältProvides an enumerator for the Rune values represented by a span containing UTF-16 text.

StringBuilder.ChunkEnumerator

Unterstützt die einfache Iteration vor dem Block einer StringBuilder-Klasse.Supports simple iteration over the chunks of a StringBuilder instance.

StringRuneEnumerator

Stellt einen Enumerator für die Rune-Werte bereit, die durch eine Zeichenfolge dargestellt werden.Provides an enumerator for the Rune values represented by a string.

Enumerationen

NormalizationForm

Definiert den Typ der auszuführenden Normalisierung.Defines the type of normalization to perform.

Hinweise

Die Codierungsklassen dienen in erster Linie zum Konvertieren zwischen verschiedenen Codierungen oder Codepages und eine Unicode-Codierung.The encoding classes are primarily intended to convert between different encodings or code pages and a Unicode encoding. Encoding.Unicode Codierung (UTF-16) wird von .NET Framework intern verwendet und Encoding.UTF8 Codierung wird häufig zum Speichern von Zeichendaten auf mehreren Computern und Kulturen Portabilität sicherzustellen.Encoding.Unicode (UTF-16) encoding is used internally by the .NET Framework, and Encoding.UTF8 encoding is often used for storing character data to ensure portability across machines and cultures.

Von abgeleiteten Klassen Encoding ermöglichen es Ihnen, auswählen eine Fallbackstrategie, bestimmt, wie Zeichen, die nicht in eine Bytefolge codiert werden können, oder Bytes, die in Zeichen decodiert werden können nicht verarbeitet werden.The classes derived from Encoding enable you to choose a fallback strategy, which determines how characters that cannot be encoded into a sequence of bytes, or bytes that cannot be decoded into characters, are handled. Sie können eine der folgenden:You can choose one of the following:

  • Ausnahmefallback.Exception fallback. Sie können auswählen, Auslösen von Ausnahmen auf Datenfehler entweder mithilfe eine throwonerror Flag, das in einigen Klassenkonstruktoren oder mithilfe von verfügbar ist die EncoderExceptionFallback und DecoderExceptionFallback Klassen.You can choose to throw exceptions on data errors either by using a throwonerror flag that is available in some class constructors or by using the EncoderExceptionFallback and DecoderExceptionFallback classes. Wenn Sie über die Integrität des Datenstroms Bedenken haben, wird empfohlen, eine Ausnahme auszulösen.If you are concerned about the integrity of the data stream, throwing on an exception is recommended.

  • Ersatzfallback.Replacement fallback. Können Sie die EncoderFallback und DecoderFallback Klassen so ändern Sie ein Zeichen, das im Hintergrund "?" oder das Unicode-Ersatzzeichen (U + FFFD).You can use the EncoderFallback and DecoderFallback classes to silently change a character to "?" or to the Unicode replacement character (U+FFFD).

  • Fallback mit ähnlichen Zeichen.Best-fit fallback. Diese Option ordnet ein Zeichen in einer Codierung in ein Zeichen in einer anderen Codierung.This option maps a character in one encoding to a character in another encoding. Beste mit ähnlichen Zeichen Fallback wird häufig nicht empfohlen, da dies zu Datenverlust und Verwirrung führen kann, und ist langsamer als die einfachen "?"-Zeichen Ersetzungen.Best fit fallback is often not recommended because it can cause data loss and confusion, and is slower than simple "?" character replacements. Allerdings trifft für ANSI-Codepages Fallback mit ähnlichen Zeichen die Standardeinstellung.However, for ANSI code pages the best-fit behavior is the default.

Die StringBuilder Klasse dient für Vorgänge, die umfangreiche Manipulationen für eine einzelne Zeichenfolge ausführen.The StringBuilder class is designed for operations that perform extensive manipulations on a single string. Im Gegensatz zu den String -Klasse, die StringBuilder Klasse ist änderbar und bietet eine bessere Leistung beim Verketten oder Löschen von Zeichenfolgen.Unlike the String class, the StringBuilder class is mutable and provides better performance when concatenating or deleting strings.

Weitere Informationen zu System.Text, finden Sie unter Zeichencodierung in .NET Framework .For more information about System.Text, see Character Encoding in the .NET Framework .