ApplicationLanguages Clase

Definición

public ref class ApplicationLanguages abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ApplicationLanguages final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class ApplicationLanguages

Public Class ApplicationLanguages

Herencia

Object Platform::Object IInspectable ApplicationLanguages

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Comentarios

Los idiomas a los que se hace referencia en esta clase se representan mediante etiquetas de idioma BCP-47. Cada uno de ellos es un identificador de idioma y no un nombre de configuración regional, aunque los dos estructuralmente pueden ser los mismos. Como etiqueta de idioma, "en-US" significa inglés americano (o el dialecto del inglés hablado en el Estados Unidos). No hace ninguna reclamación sobre la ubicación real de los hablantes (aunque muchos de ellos residen en los Estados Unidos) y ninguna otra reclamación sobre las convenciones que se usan en estados Unidos, como el sistema de medición o la moneda.

Ejemplo:

Windows.Globalization.ApplicationLanguages.PrimaryLanguageOverride = "en-US"

Las etiquetas de lenguaje admiten las extensiones Unicode "ca-" y "nu-". (Consulte Definiciones de clave/tipo Unicode). Tenga en cuenta que estas extensiones pueden afectar al sistema numérico o al calendario utilizado por los objetos de globalización.

Las aplicaciones para UWP se pueden implementar mediante paquetes de recursos. Cuando se usan paquetes de recursos de idioma, los paquetes que se instalan y registran para un usuario determinado vienen determinados por los idiomas del perfil de idioma del usuario. Como resultado, no todos los idiomas incluidos en la agrupación de aplicaciones que se enviaron a Microsoft Store estarán disponibles necesariamente para su uso en tiempo de ejecución. La propiedad PrimaryLanguageOverride solo debe establecerse en idiomas disponibles para el usuario.

Los idiomas disponibles para que la aplicación se use como un objeto ApplicationLanguages en tiempo de ejecución se limitan a los idiomas incluidos en el manifiesto del paquete de aplicación principal y los idiomas correspondientes a los paquetes de recursos de idioma aplicables al usuario (determinados por los idiomas coincidentes en las preferencias del usuario) y que se instalan y registran para el usuario. La propiedad ApplicationLanguages.ManifestLanguages refleja los paquetes de recursos de idioma que están disponibles para el usuario y devuelve un conjunto adecuado de idiomas que se pueden usar para establecer la propiedad PrimaryLanguageOverride .

La propiedad ApplicationLanguages.Languages devolverá una lista muy similar a la propiedad ManifestLanguages . Puede diferir en incluir variaciones de idioma regionales no enumeradas en ningún manifiesto de paquete; Por ejemplo, la propiedad Languages puede devolver "en-CA" (Inglés (Canadá)) si el usuario tiene "en-CA" en su perfil y la aplicación admite cualquier variedad regional de inglés. Estas variaciones de idioma regional derivadas del usuario pueden ser preferibles para establecer la propiedad PrimaryLanguageOverride , ya que la aplicación proporcionará comportamientos de globalización más adecuados para el usuario.

Si un idioma está en el paquete de la aplicación principal, pero no coincide con ningún idioma en la preferencia del usuario, la propiedad ManifestLanguages la devuelve, pero no la propiedad Languages . También se pueden usar para establecer la propiedad PrimaryLanguageOverride . Sin embargo, dado que estos idiomas no se reflejan en las preferencias del usuario, es posible que el usuario no comprenda esos idiomas. Esta configuración solo se debe usar cuando el usuario lo elija directamente.

Historial de versiones

Propiedades

Métodos

Se aplica a

Consulte también

• Etiquetas de idioma BCP-47
• Definiciones de clave/tipo Unicode