Share via


ApplicationLanguages.PrimaryLanguageOverride Propiedad

Definición

Obtiene o establece una invalidación para el idioma preferido de la aplicación, expresada como una etiqueta de idioma BCP-47 . Esta configuración se conserva.

public:
 static property Platform::String ^ PrimaryLanguageOverride { Platform::String ^ get(); void set(Platform::String ^ value); };
static winrt::hstring PrimaryLanguageOverride();

static void PrimaryLanguageOverride(winrt::hstring value);
public static string PrimaryLanguageOverride { get; set; }
var string = ApplicationLanguages.primaryLanguageOverride;
ApplicationLanguages.primaryLanguageOverride = string;
Public Shared Property PrimaryLanguageOverride As String

Valor de propiedad

String

Platform::String

winrt::hstring

Etiqueta de idioma BCP-47 . La aplicación puede establecerla para invalidar el idioma superior de la lista clasificada del usuario de idiomas preferidos (ApplicationLanguages.Languages) y su valor se conservará entre sesiones de la aplicación. Debe ser una sola etiqueta de idioma; Se producirá un error en una lista delimitada de etiquetas de idioma.

Cuando la aplicación obtiene el valor, PrimaryLanguageOverride devuelve una sola etiqueta de idioma (si la aplicación ha establecido previamente la propiedad) o una cadena vacía.

Comentarios

Las aplicaciones normalmente se ejecutan con la configuración de idioma determinada por el sistema comparando los idiomas admitidos por la aplicación con las preferencias de idioma del usuario. La configuración de ese comportamiento del sistema se puede obtener mediante la propiedad ApplicationLanguages.Languages . La propiedad PrimaryLanguageOverride se usa para invalidar ese comportamiento estableciendo un idioma específico como primer idioma de la lista Idiomas.

La configuración PrimaryLanguageOverride se conserva entre sesiones. No se debe establecer cada vez que se carga la aplicación. Solo se debe establecer en función de la entrada del usuario presentada en la interfaz de usuario de configuración. La propiedad se puede leer en cualquier momento. Si la propiedad nunca se ha establecido, devuelve una cadena vacía.

Al establecer PrimaryLanguageOverride, esto se refleja inmediatamente en la propiedad ApplicationLanguages.Languages . Sin embargo, este cambio puede no surtir efecto inmediatamente en los recursos cargados en la interfaz de usuario de la aplicación. Para asegurarse de que la aplicación responde a estos cambios, puede escuchar la propiedad QualifierValues en un contexto de recurso predeterminado y realizar cualquier acción necesaria para volver a cargar los recursos. Esos requisitos pueden variar en función del marco de interfaz de usuario usado por la aplicación y puede ser necesario reiniciar la aplicación.

Se aplica a

Consulte también