Language Clase

Definición

Espacio de nombres:

Windows.Globalization

Clase que proporciona información relacionada con las etiquetas de idioma BCP-47 , como el nombre del idioma y el script.

public ref class Language 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)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.ILanguageFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class Language 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)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Globalization.ILanguageFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class Language

function Language(languageTag)

Public NotInheritable Class Language

Herencia

Object Platform::Object IInspectable Language

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

// Get the top user-preferred language and its display name.
var topUserLanguage = Windows.System.UserProfile.GlobalizationPreferences.Languages[0];
var language = new Windows.Globalization.Language(topUserLanguage);
var displayName = language.DisplayName;

Comentarios

Si la aplicación pasa etiquetas de idioma usadas en esta clase a cualquier función de compatibilidad con lenguaje nacional , primero debe convertir las etiquetas mediante una llamada a ResolveLocaleName.

Inicialice esta clase con una etiqueta de idioma BCP-47 . Por ejemplo, para trabajar con el mejor idioma preferido por el usuario actual, pase el valor superior de Windows.System.UserProfile.GlobalizationPreferences:

Las etiquetas de idioma admiten las extensiones Unicode "ca-" y "nu-". (Consulte Definiciones de tipo y clave Unicode). Tenga en cuenta que estas extensiones pueden afectar al calendario utilizado por los objetos Calendar.

Historial de versiones

Versión de Windows	Versión del SDK	Valor agregado
1803	17134	LayoutDirection
2004	19041	AbbreviatedName
2004	19041	GetMuiCompatibleLanguageListFromLanguageTags

Constructores

Language(String)

Crea un objeto Language .

Propiedades

AbbreviatedName	Obtiene la abreviatura de tres letras de una etiqueta de idioma BCP-47. Por ejemplo, "en-US" se convierte en "eng".
CurrentInputMethodLanguageTag	Obtiene la etiqueta de idioma BCP-47 para el diseño de teclado habilitado actualmente o el Editor de métodos de entrada (IME).
DisplayName	Obtiene una cadena localizada que es adecuada para mostrar al usuario para identificar el idioma.
LanguageTag	Obtiene la etiqueta de idioma BCP-47 normalizada para este idioma.
LayoutDirection	Obtiene la dirección del diseño de contenido (para los elementos de texto y de interfaz de usuario) más adecuada para un idioma.
NativeName	Obtiene el nombre del idioma en el propio idioma.
Script	Obtiene el código de script ISO 15924 de cuatro letras del lenguaje.

Métodos

GetExtensionSubtags(String)	Recupera un vector de subetiquetas de extensión en el lenguaje actual para la extensión especificada identificada por singleton.
GetMuiCompatibleLanguageListFromLanguageTags(IIterable<String>)	Recupera un conjunto de etiquetas de interfaz de usuario multilingüe (MUI) derivadas de una o varias etiquetas de idioma BCP-47.
IsWellFormed(String)	Determina si una etiqueta de idioma BCP-47 tiene un formato correcto.
TrySetInputMethodLanguageTag(String)	Intenta establecer la etiqueta de idioma BCP-47 normalizada de este idioma.

Consulte también

• Ejemplo de OCR (Windows 10)
• Ejemplo de preferencias de globalización (Windows 10)