Encoding.Default Propriété

Définition

Espace de noms:

System.Text

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

Encoding.cs

Obtient l’encodage par défaut pour cette implémentation .NET.

public:
 static property System::Text::Encoding ^ Default { System::Text::Encoding ^ get(); };

public static System.Text.Encoding Default { get; }

static member Default : System.Text.Encoding

Public Shared ReadOnly Property Default As Encoding

Valeur de propriété

Encoding

Encodage par défaut pour cette implémentation .NET.

Remarques

Le comportement de la Default propriété varie entre différentes implémentations .NET :

• Dans .NET Framework : retourne l’encodage qui correspond à la page de codes active du système. Il s’agit du même encodage retourné par GetEncoding(Int32) lorsqu’il est appelé avec un codepage argument de 0.

• Dans .NET Core et versions ultérieures : retourne toujours un UTF8Encoding objet. Ce comportement a été modifié pour encourager l’utilisation d’encodages Unicode pour une meilleure compatibilité multiplateforme et une meilleure intégrité des données.

Pour obtenir les résultats les plus cohérents entre différentes plateformes et implémentations .NET, envisagez d’utiliser un encodage Unicode spécifique tel que UTF-8 directement au lieu de compter sur l’encodage par défaut. Vous pouvez obtenir l’encodage UTF-8 en appelant Encoding.UTF8 ou Encoding.GetEncoding(String) avec « utf-8 ».

Avertissement

Différents ordinateurs peuvent utiliser des encodages différents comme encodage par défaut, et l’encodage par défaut peut changer sur un seul ordinateur. Si vous utilisez l’encodage Encoding.Default pour encoder et décoder les données diffusées entre les ordinateurs ou récupérées à des moments différents sur le même ordinateur, elles peuvent traduire ces données de manière incorrecte. En outre, l'encodage retourné par la propriété Default utilise la solution de secours la plus appropriée pour mapper des caractères non pris en charge aux caractères pris en charge par la page de code. Pour ces raisons, l’utilisation de l’encodage par défaut n’est pas recommandée. Pour vous assurer que les octets encodés sont décodés correctement, vous devez utiliser un encodage Unicode, tel que UTF8Encoding ou UnicodeEncoding. Vous pouvez également utiliser un protocole de niveau supérieur pour vous assurer que le même format est utilisé pour l’encodage et le décodage.

La Default propriété retourne toujours le UTF8Encoding. UTF-8 est pris en charge sur tous les systèmes d’exploitation (Windows, Linux et macOS) sur lesquels s’exécutent les applications .NET.