System.Text Espace de noms
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Contient des classes qui représentent des encodages de caractères ASCII et Unicode ; classes de base abstraites pour convertir des blocs de caractères vers et à partir de blocs d’octets ; et une classe d’assistance qui manipule et met en forme String des objets sans créer d’instances intermédiaires de String.
Classes
| Nom | Description |
|---|---|
| ASCIIEncoding |
Représente un encodage de caractères ASCII de caractères Unicode. |
| CodePagesEncodingProvider |
Fournit l’accès à un fournisseur d’encodage pour les pages de code qui ne sont disponibles que dans le .NET Framework de bureau. |
| Decoder |
Convertit une séquence d’octets encodés en un ensemble de caractères. |
| DecoderExceptionFallback |
Fournit un mécanisme de gestion des défaillances, appelé secours, pour une séquence d’octets d’entrée encodée qui 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 d’entrée. Cette classe ne peut pas être héritée. |
| DecoderExceptionFallbackBuffer |
Lève lorsqu’une séquence d’octets DecoderFallbackException d’entrée encodée ne peut pas être convertie en caractère de sortie décodé. Cette classe ne peut pas être héritée. |
| DecoderFallback |
Fournit un mécanisme de gestion des défaillances, appelé secours, pour une séquence d’octets d’entrée encodée qui ne peut pas être convertie en 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 d’entrée. |
| DecoderFallbackException |
Exception levée lorsqu’une opération de secours de décodeur échoue. Cette classe ne peut pas être héritée. |
| DecoderReplacementFallback |
Fournit un mécanisme de gestion des défaillances, appelé secours, pour une séquence d’octets d’entrée encodée qui ne peut pas être convertie en caractère de sortie. Le secours émet une chaîne de remplacement spécifiée par l’utilisateur au lieu d’une séquence d’octets d’entrée décodée. Cette classe ne peut pas être héritée. |
| DecoderReplacementFallbackBuffer |
Représente une chaîne de sortie de remplacement émise lorsque la séquence d’octets d’entrée d’origine 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 défaillances, appelé secours, pour un caractère d’entrée qui ne peut pas être converti en séquence d’octets de sortie. Le secours lève une exception si un caractère d’entrée ne peut pas être converti en séquence d’octets de sortie. Cette classe ne peut pas être héritée. |
| EncoderExceptionFallbackBuffer |
Lève EncoderFallbackException lorsqu’un caractère d’entrée ne peut pas être converti en séquence d’octets de sortie encodé. Cette classe ne peut pas être héritée. |
| EncoderFallback |
Fournit un mécanisme de gestion des défaillances, appelé secours, pour un caractère d’entrée qui ne peut pas être converti en séquence d’octets de sortie 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 lorsqu’une opération de secours d’encodeur échoue. Cette classe ne peut pas être héritée. |
| EncoderReplacementFallback |
Fournit un mécanisme de gestion des défaillances, appelé secours, pour un caractère d’entrée qui ne peut pas être converti en séquence d’octets de sortie. La secours utilise une chaîne de remplacement spécifiée 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 d’entrée de remplacement utilisée lorsque le caractère d’entrée d’origine ne peut pas être encodé. Cette classe ne peut pas être héritée. |
| Encoding |
Représente un encodage de caractères. |
| EncodingInfo |
Fournit des informations de base sur un encodage. |
| EncodingProvider |
Fournit la classe de base d’un fournisseur d’encodage, qui fournit des encodages non disponibles sur une plateforme particulière. |
| StringBuilder |
Représente une chaîne mutable de caractères. 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. |
Énumérations
| Nom | Description |
|---|---|
| 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 code et un encodage Unicode. Encoding.Unicode (UTF-16) l’encodage est utilisé en interne par .NET, et 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.
Les classes dérivées de vous permettent de Encoding choisir une stratégie de secours, qui détermine comment les caractères qui ne peuvent pas être codés dans une séquence d’octets ou d’octets qui ne peuvent pas être décodés en caractères sont gérés. Vous pouvez choisir l’une des options suivantes :
Secours de l’exception. Vous pouvez choisir de lever des exceptions sur les erreurs de données à l’aide d’un
throwonerrorindicateur disponible dans certains constructeurs de classes ou à l’aide des classes et DecoderExceptionFallback des EncoderExceptionFallback classes. Si vous êtes préoccupé par l’intégrité du flux de données, la levée d’une exception est recommandée.Secours de remplacement. Vous pouvez utiliser les classes et DecoderFallback les EncoderFallback classes pour remplacer silencieusement un caractère par « ? » ou par le caractère de remplacement Unicode (U+FFFD).
Meilleure solution de secours. Cette option mappe un caractère d’un encodage à un caractère d’un autre encodage. La meilleure solution de secours n’est souvent pas recommandée, car elle peut entraîner une perte de données et une confusion, et est plus lente que les remplacements simples de caractères « ? ». Toutefois, pour les pages de codes ANSI, le comportement le mieux adapté est la valeur par défaut.
La StringBuilder classe est conçue pour les opérations qui effectuent des manipulations étendues sur une seule chaîne. 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 How to use character encoding classes in .NET .