Partilhar via


Language Classe

Definição

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

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.

Aplica-se a

Confira também