System.Text Namespace

L’espace de noms System.Text contient des classes représentant des encodages de caractères ASCII et Unicode, des classes de base abstraites pour la conversion de blocs de caractères vers et à partir des blocs d’octets et une classe d’assistance qui manipule et met en forme les objets String sans créer d’instances intermédiaires de String. 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.

Classes

ASCIIEncoding

Représente un encodage de caractères ASCII de caractères Unicode.Represents an ASCII character encoding of Unicode characters.

CodePagesEncodingProvider

Donne accès à un fournisseur d’encodage pour les pages de code qui sont uniquement disponibles dans la version Poste de travail de .NET Framework.Provides access to an encoding provider for code pages that otherwise are available only in the desktop .NET Framework.

Decoder

Convertit une séquence d'octets encodés en un jeu de caractères.Converts a sequence of encoded bytes into a set of characters.

DecoderExceptionFallback

Fournit un mécanisme de gestion d’erreurs, appelé secours, quand une séquence d’octets en entrée encodée ne peut pas être convertie en caractère d’entrée.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an input character. Le secours lève une exception au lieu de décoder la séquence d’octets en entrée.The fallback throws an exception instead of decoding the input byte sequence. Cette classe ne peut pas être héritée.This class cannot be inherited.

DecoderExceptionFallbackBuffer

Lève une exception DecoderFallbackException si une séquence d'octets codée en entrée ne peut pas être convertie en un caractère de sortie décodé.Throws DecoderFallbackException when an encoded input byte sequence cannot be converted to a decoded output character. Cette classe ne peut pas être héritée.This class cannot be inherited.

DecoderFallback

Fournit un mécanisme de gestion des erreurs, appelé secours, quand une séquence d'octets codée en entrée ne peut pas être convertie en un caractère de sortie.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an output character.

DecoderFallbackBuffer

Fournit une mémoire tampon qui permet à un gestionnaire de secours de retourner une autre chaîne à un décodeur lorsqu'il ne peut pas décoder la séquence d'octets d'entrée.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

Exception levée en cas d'échec de l'opération du décodeur de secours.The exception that is thrown when a decoder fallback operation fails. Cette classe ne peut pas être héritée.This class cannot be inherited.

DecoderReplacementFallback

Fournit un mécanisme de gestion des erreurs, appelé secours, quand une séquence d'octets codée en entrée ne peut pas être convertie en un caractère de sortie.Provides a failure-handling mechanism, called a fallback, for an encoded input byte sequence that cannot be converted to an output character. Le secours émet une chaîne de remplacement définie par l'utilisateur à la place d'une séquence d'octets décodée en entrée.The fallback emits a user-specified replacement string instead of a decoded input byte sequence. Cette classe ne peut pas être héritée.This class cannot be inherited.

DecoderReplacementFallbackBuffer

Représente la chaîne de sortie de substitution qui est émise lorsque la séquence d'octets en entrée ne peut pas être décodée.Represents a substitute output string that is emitted when the original input byte sequence cannot be decoded. Cette classe ne peut pas être héritée.This class cannot be inherited.

Encoder

Convertit un jeu de caractères en une séquence d'octets.Converts a set of characters into a sequence of bytes.

EncoderExceptionFallback

Fournit un mécanisme de gestion des erreurs, appelé secours, quand un caractère d’entrée ne peut pas être converti en sortie en une séquence d’octets.Provides a failure-handling mechanism, called a fallback, for an input character that cannot be converted to an output byte sequence. Le secours lève une exception si un caractère d’entrée ne peut pas être converti en séquence d’octets en sortie.The fallback throws an exception if an input character cannot be converted to an output byte sequence. Cette classe ne peut pas être héritée.This class cannot be inherited.

EncoderExceptionFallbackBuffer

Lève une exception EncoderFallbackException quand un caractère en entrée ne peut pas être converti en sortie en une séquence codée d'octets.Throws EncoderFallbackException when an input character cannot be converted to an encoded output byte sequence. Cette classe ne peut pas être héritée.This class cannot be inherited.

EncoderFallback

Fournit un mécanisme de gestion des erreurs, appelé secours, quand un caractère en entrée ne peut pas être converti en sortie en une séquence d'octets encodée.Provides a failure-handling mechanism, called a fallback, for an input character that cannot be converted to an encoded output byte sequence.

EncoderFallbackBuffer

Fournit une mémoire tampon qui permet à un gestionnaire de secours de retourner une autre chaîne à un encodeur lorsqu'il ne peut pas encoder un caractère d'entrée.Provides a buffer that allows a fallback handler to return an alternate string to an encoder when it cannot encode an input character.

EncoderFallbackException

Exception levée en cas d'échec de l'opération de l'encodeur de secours.The exception that is thrown when an encoder fallback operation fails. Cette classe ne peut pas être héritée.This class cannot be inherited.

EncoderReplacementFallback

Fournit un mécanisme de gestion des erreurs, appelé secours, quand un caractère d'entrée ne peut pas être converti en sortie en une séquence d'octets.Provides a failure handling mechanism, called a fallback, for an input character that cannot be converted to an output byte sequence. Le secours utilise une chaîne de remplacement définie par l'utilisateur au lieu du caractère d'entrée d'origine.The fallback uses a user-specified replacement string instead of the original input character. Cette classe ne peut pas être héritée.This class cannot be inherited.

EncoderReplacementFallbackBuffer

Représente une chaîne de substitution en entrée qui est utilisée lorsque le caractère d'origine en entrée ne peut pas être encodé.Represents a substitute input string that is used when the original input character cannot be encoded. Cette classe ne peut pas être héritée.This class cannot be inherited.

Encoding

Représente un encodage de caractères.Represents a character encoding.

EncodingInfo

Fournit des informations de base sur le codage.Provides basic information about an encoding.

EncodingProvider

Fournit la classe de base pour un fournisseur d'encodage, qui fournit des encodages qui ne sont pas disponibles sur une plateforme donnée.Provides the base class for an encoding provider, which supplies encodings that are unavailable on a particular platform.

StringBuilder

Représente une chaîne de caractères mutable.Represents a mutable string of characters. Cette classe ne peut pas être héritée.This class cannot be inherited.

UnicodeEncoding

Représente un encodage UTF-16 de caractères Unicode.Represents a UTF-16 encoding of Unicode characters.

UTF32Encoding

Représente un encodage UTF-32 de caractères Unicode.Represents a UTF-32 encoding of Unicode characters.

UTF7Encoding

Représente un encodage UTF-7 de caractères Unicode.Represents a UTF-7 encoding of Unicode characters.

UTF8Encoding

Représente un encodage UTF-8 de caractères Unicode.Represents a UTF-8 encoding of Unicode characters.

Structures

Rune

Représente une valeur scalaire Unicode ([ U+0000..U+D7FF ], inclus ou [ U+E000..U+10FFFF ], inclus).Represents a Unicode scalar value ([ U+0000..U+D7FF ], inclusive; or [ U+E000..U+10FFFF ], inclusive).

SpanRuneEnumerator

Fournit un énumérateur pour les valeurs Rune représentées par une étendue contenant du texte UTF-16.Provides an enumerator for the Rune values represented by a span containing UTF-16 text.

StringBuilder.ChunkEnumerator

Prend en charge une itération simple sur les segments d’une instance StringBuilder.Supports simple iteration over the chunks of a StringBuilder instance.

StringRuneEnumerator

Fournit un énumérateur pour les valeurs Rune représentées par une chaîne.Provides an enumerator for the Rune values represented by a string.

Énumérations

NormalizationForm

Définit le type de normalisation à effectuer.Defines the type of normalization to perform.

Remarques

Les classes d’encodage sont principalement destinées à convertir entre encodages différents ou des pages de codes et un encodage Unicode.The encoding classes are primarily intended to convert between different encodings or code pages and a Unicode encoding. Encoding.Unicode Encodage (UTF-16) est utilisée en interne par le .NET Framework, et Encoding.UTF8 encodage est souvent utilisé pour stocker les données de caractères pour garantir la portabilité sur différents ordinateurs et cultures.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.

Les classes dérivées de Encoding vous permettent de choisir une stratégie de secours qui détermine la façon dont les caractères qui ne peuvent pas être encodés dans une séquence d’octets, ou octets qui ne peut pas être décodées en caractères, sont gérées.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. Vous pouvez choisir parmi les options suivantes :You can choose one of the following:

  • Exception de secours.Exception fallback. Vous pouvez choisir de lever des exceptions sur les erreurs de données à l’aide un throwonerror indicateur qui est disponible dans certains constructeurs de classe ou en utilisant le EncoderExceptionFallback et DecoderExceptionFallback classes.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. Si vous êtes inquiet de l’intégrité du flux de données, est recommandé de lever une exception.If you are concerned about the integrity of the data stream, throwing on an exception is recommended.

  • Remplacement de secours.Replacement fallback. Vous pouvez utiliser la EncoderFallback et DecoderFallback classes pour modifier en mode silencieux un caractère à « ? » ou le caractère de remplacement Unicode (U + FFFD).You can use the EncoderFallback and DecoderFallback classes to silently change a character to "?" or to the Unicode replacement character (U+FFFD).

  • Secours la mieux adaptée.Best-fit fallback. Cette option met en correspondance un caractère dans un encodage à un caractère dans un autre encodage.This option maps a character in one encoding to a character in another encoding. Secours le mieux adapté est généralement pas recommandé car cela peut entraîner une perte de données et de la confusion et est plus lent que de simples « ? » remplacements de caractères.Best fit fallback is often not recommended because it can cause data loss and confusion, and is slower than simple "?" character replacements. Toutefois, pour les pages de codes ANSI, le comportement le mieux adapté est la valeur par défaut.However, for ANSI code pages the best-fit behavior is the default.

Le StringBuilder classe est conçue pour les opérations qui effectuent des manipulations étendues sur une chaîne unique.The StringBuilder class is designed for operations that perform extensive manipulations on a single string. Contrairement à la String (classe), la StringBuilder classe est mutable et offre de meilleures performances lors de la concaténation ou supprimer des chaînes.Unlike the String class, the StringBuilder class is mutable and provides better performance when concatenating or deleting strings.

Pour plus d’informations sur System.Text, consultez encodage de caractères dans le .NET Framework .For more information about System.Text, see Character Encoding in the .NET Framework .