Encoding.Default Propiedad

Definición

Obtiene la codificación predeterminada para esta implementación de .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

Valor de propiedad

Codificación predeterminada para esta implementación de .NET.

Comentarios

El comportamiento de la Default propiedad varía entre diferentes implementaciones de .NET:

  • En .NET Framework: devuelve la codificación que corresponde a la página de códigos activa del sistema. Esta es la misma codificación devuelta por GetEncoding(Int32) cuando se llama a con un codepage argumento de 0.

  • En .NET Core y versiones posteriores: siempre devuelve un UTF8Encoding objeto . Este comportamiento se cambió para fomentar el uso de codificaciones Unicode para mejorar la compatibilidad multiplataforma y la integridad de los datos.

Para obtener los resultados más coherentes en distintas plataformas e implementaciones de .NET, considere la posibilidad de usar una codificación Unicode específica, como UTF-8 directamente en lugar de confiar en la codificación predeterminada. Puede obtener la codificación UTF-8 llamando a Encoding.UTF8 o Encoding.GetEncoding(String) con "utf-8".

Warning

Los distintos equipos pueden usar diferentes codificaciones como valor predeterminado y la codificación predeterminada puede cambiar en un solo equipo. Si usa la Encoding.Default codificación para codificar y descodificar datos transmitidos entre equipos o recuperados en momentos diferentes en el mismo equipo, puede traducir esos datos incorrectamente. Además, la codificación que devuelve la propiedad Default utiliza la sustitución mejor ajustada para asignar caracteres no admitidos a caracteres admitidos por la página de códigos correspondiente. Por estos motivos, no se recomienda usar la codificación predeterminada. Para asegurarse de que los bytes codificados están descodificados correctamente, debe usar una codificación Unicode, como UTF8Encoding o UnicodeEncoding. También puede usar un protocolo de nivel superior para asegurarse de que se usa el mismo formato para codificar y descodificar.

La Default propiedad siempre devuelve .UTF8Encoding UTF-8 se admite en todos los sistemas operativos (Windows, Linux y macOS) en los que se ejecutan .NET aplicaciones.

Se aplica a