Partage via


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.

Classes

Ascii

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.

ASCIIEncoding

Représente un encodage de caractères ASCII de caractères Unicode.

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.

CompositeFormat

Représente une chaîne de format composite analysée.

Decoder

Convertit une séquence d'octets codés en jeu de caractères.

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. Le secours lève une exception au lieu de décoder la séquence d’octets en entrée. Cette classe ne peut pas être héritée.

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é. Cette classe ne peut pas être héritée.

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.

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.

DecoderFallbackException

Exception levée en cas d'échec de l'opération du décodeur de secours. Cette classe ne peut pas être héritée.

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. 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. Cette classe ne peut pas être héritée.

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. Cette classe ne peut pas être héritée.

Encoder

Convertit un jeu de caractères en une séquence d'octets.

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. 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. Cette classe ne peut pas être héritée.

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. Cette classe ne peut pas être héritée.

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.

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.

EncoderFallbackException

Exception levée en cas d'échec de l'opération de l'encodeur de secours. Cette classe ne peut pas être héritée.

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. Le secours utilise une chaîne de remplacement définie par l'utilisateur au lieu du caractère d'entrée d'origine. Cette classe ne peut pas être héritée.

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é. Cette classe ne peut pas être héritée.

Encoding

Représente un encodage de caractères.

EncodingExtensions

Fournit des méthodes d’extension pour les types d’encodage, tels que Encoding, Encoderet Decoder.

EncodingInfo

Fournit des informations de base sur le codage.

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.

RedactionStringBuilderExtensions

Méthodes utilitaires de rédaction.

StringBuilder

Représente une chaîne de caractères mutable. Cette classe ne peut pas être héritée.

UnicodeEncoding

Représente un encodage UTF-16 de caractères Unicode.

UTF32Encoding

Représente un encodage UTF-32 de caractères Unicode.

UTF7Encoding

Représente un encodage UTF-7 de caractères Unicode.

UTF8Encoding

Représente un encodage UTF-8 de caractères Unicode.

Structures

Rune

Représente une valeur scalaire Unicode ([ U+0000..U+D7FF ], inclus ou [ U+E000..U+10FFFF ], inclus).

SpanLineEnumerator

Énumère les lignes d’un ReadOnlySpan<T>.

SpanRuneEnumerator

Fournit un énumérateur pour les valeurs Rune représentées par une étendue contenant du texte UTF-16.

StringBuilder.AppendInterpolatedStringHandler

Fournit un gestionnaire utilisé par le compilateur de langage pour ajouter des chaînes interpolées dans StringBuilder des instances.

StringBuilder.ChunkEnumerator

Prend en charge une itération simple sur les segments d’une instance StringBuilder.

StringRuneEnumerator

Fournit un énumérateur pour les valeurs Rune représentées par une chaîne.

Énumérations

NormalizationForm

Définit le type de normalisation à effectuer.

Remarques

Les classes d’encodage sont principalement destinées à effectuer une conversion entre différents encodages ou pages de codes et un encodage Unicode. Encoding.Unicode L’encodage (UTF-16) est utilisé en interne par .NET, et Encoding.UTF8 l’encodage est souvent utilisé pour stocker les données de caractères afin de garantir la portabilité entre les machines et les cultures.

Les classes dérivées de vous permettent de Encoding choisir une stratégie de secours, qui détermine la façon dont les caractères qui ne peuvent pas être encodés en une séquence d’octets, ou les octets qui ne peuvent pas être décodés en caractères, sont gérés. Vous pouvez choisir l’une des options suivantes :

  • Exception de secours. 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 classes et DecoderExceptionFallback . Si vous êtes préoccupé par l’intégrité du flux de données, il est recommandé de lever une exception.

  • Remplacement de secours. Vous pouvez utiliser les EncoderFallback classes et DecoderFallback pour modifier silencieusement un caractère en « ? » ou en caractère de remplacement Unicode (U+FFFD).

  • Meilleure solution de secours. Cette option mappe un caractère dans un encodage à un caractère dans un autre encodage. Le meilleur ajustement de secours n’est souvent pas recommandé, car il peut entraîner une perte de données et une confusion, et est plus lent que les simples remplacements de caractères « ? ». Toutefois, pour les pages de codes ANSI, le comportement le plus adapté est le comportement par défaut.

La StringBuilder classe est conçue pour les opérations qui effectuent des manipulations étendues sur une chaîne unique. 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.

Pour plus d’informations sur System.Text, consultez Guide pratique pour utiliser des classes d’encodage de caractères dans .NET .