Language Classe

Definição

Namespace:

Windows.Globalization

Uma classe que fornece informações relacionadas a marcas de idioma BCP-47 , como o nome do idioma e o 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

Herança

Object Platform::Object IInspectable Language

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

// 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;

Comentários

Se seu aplicativo passar marcas de idioma usadas nessa classe para qualquer função de Suporte a Idioma Nacional , ele deverá primeiro converter as marcas chamando ResolveLocaleName.

Inicialize essa classe com uma marca de idioma BCP-47 . Por exemplo, para trabalhar com o melhor idioma preferencial do usuário atual, passe o valor superior de Windows.System.UserProfile.GlobalizationPreferences:

As marcas de idioma dão suporte às extensões Unicode "ca-" e "nu-". (Consulte Definições de chave/tipo Unicode.) Observe que essas extensões podem afetar o calendário usado pelos objetos Calendar.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1803	17134	LayoutDirection
2004	19041	AbbreviatedName
2004	19041	GetMuiCompatibleLanguageListFromLanguageTags

Construtores

Language(String)

Cria um objeto Language .

Propriedades

AbbreviatedName	Obtém a abreviação de três letras para uma marca de idioma BCP-47. Por exemplo, "en-US" é convertido em "eng".
CurrentInputMethodLanguageTag	Obtém a marca de idioma BCP-47 para o layout de teclado atualmente habilitado ou o IME (Editor de Método de Entrada).
DisplayName	Obtém uma cadeia de caracteres localizada que é adequada para exibição ao usuário para identificar o idioma.
LanguageTag	Obtém a marca de idioma BCP-47 normalizada para esse idioma.
LayoutDirection	Obtém a direção do layout do conteúdo (para elementos de texto e interface do usuário) mais apropriada para um idioma.
NativeName	Obtém o nome do idioma no próprio idioma.
Script	Obtém o código de script ISO 15924 de quatro letras do idioma.

Métodos

GetExtensionSubtags(String)	Recupera um vetor de submarcas de extensão no idioma atual para a extensão determinada identificada por singleton.
GetMuiCompatibleLanguageListFromLanguageTags(IIterable<String>)	Recupera um conjunto de marcas MUI (Interface do Usuário Multilíngue) derivadas de uma ou mais marcas de idioma BCP-47.
IsWellFormed(String)	Determina se uma marca de idioma BCP-47 está bem formada.
TrySetInputMethodLanguageTag(String)	Tenta definir a marca de idioma BCP-47 normalizada deste idioma.

Confira também

• Exemplo de OCR (Windows 10)
• Exemplo de preferências de globalização (Windows 10)