System.Text Espace de noms

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. 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 codés en 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 une séquence d'octets en 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 au lieu 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.

EncodingExtensions

Fournit des méthodes d’extension pour les types d’encodage, tels que Encoding, Encoderet Decoder.Provides extension methods for the encoding types, such as Encoding, Encoder, and Decoder.

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 à effectuer une conversion entre des encodages ou des pages de codes différents et un encodage Unicode.The encoding classes are primarily intended to convert between different encodings or code pages and a Unicode encoding. Encoding.Unicode L’encodage (UTF-16) est utilisé en interne par .NET, et l' Encoding.UTF8 encodage est souvent utilisé pour stocker des données de caractères afin de garantir la portabilité entre les machines et les cultures.Encoding.Unicode (UTF-16) encoding is used internally by .NET, 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 comment les caractères qui ne peuvent pas être encodés dans une séquence d’octets, ou les octets qui ne peuvent pas être décodés en caractères, sont gérés.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 l’une des 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 d’un throwonerror indicateur disponible dans certains constructeurs de classe ou à l’aide des EncoderExceptionFallback DecoderExceptionFallback classes et.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 vous inquiétez de l’intégrité du flux de données, la levée d’une exception est recommandée.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 les EncoderFallback DecoderFallback classes et pour remplacer en mode silencieux un caractère par «  ? » ou par 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).

  • Solution de secours la mieux adaptée.Best-fit fallback. Cette option mappe un caractère d’un encodage à un caractère d’un autre encodage.This option maps a character in one encoding to a character in another encoding. L’option de secours la mieux adaptée est souvent déconseillée, car elle peut entraîner une perte de données et une confusion, et est plus lente que les remplacements de caractères «  ? » simples.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 le comportement par défaut.However, for ANSI code pages the best-fit behavior is the default.

La 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 de la suppression de 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 Guide pratique pour utiliser des classes d’encodage de caractères dans .net .For more information about System.Text, see How to use character encoding classes in .NET .