Language Classe

Definizione

Spazio dei nomi:

Windows.Globalization

Classe che fornisce informazioni correlate ai tag di lingua BCP-47 , ad esempio il nome della lingua e lo 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

Ereditarietà

Object Platform::Object IInspectable Language

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

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

Commenti

Se l'app passa tag di lingua usati in questa classe a qualsiasi funzione di supporto per il linguaggio nazionale , deve prima convertire i tag chiamando ResolveLocaleName.

Inizializzare questa classe con un tag di lingua BCP-47 . Ad esempio, per usare la lingua preferita dall'utente corrente migliore, passare il valore principale da Windows.System.UserProfile.GlobalizationPreferences:

I tag del linguaggio supportano le estensioni Unicode "ca-" e "nu-". Vedere Definizioni chiave/tipo Unicode. Si noti che queste estensioni possono influire sul calendario utilizzato dagli oggetti Calendar.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1803	17134	LayoutDirection
2004	19041	AbbreviatedName
2004	19041	GetMuiCompatibleLanguageListFromLanguageTags

Costruttori

Language(String)

Crea un oggetto Language .

Proprietà

AbbreviatedName	Ottiene l'abbreviazione di tre lettere per un tag di lingua BCP-47. Ad esempio, "en-US" viene convertito in "eng".
CurrentInputMethodLanguageTag	Ottiene il tag di lingua BCP-47 per il layout della tastiera attualmente abilitato o l'IME (Input Method Editor).
DisplayName	Ottiene una stringa localizzata adatta per la visualizzazione all'utente per l'identificazione della lingua.
LanguageTag	Ottiene il tag di lingua BCP-47 normalizzato per questa lingua.
LayoutDirection	Ottiene la direzione del layout del contenuto (per gli elementi di testo e dell'interfaccia utente) più appropriata per una lingua.
NativeName	Ottiene il nome della lingua nella lingua stessa.
Script	Ottiene il codice di script ISO 15924 di quattro lettere del linguaggio.

Metodi

GetExtensionSubtags(String)	Recupera un vettore di sottotag di estensione nel linguaggio corrente per l'estensione specificata identificata da singleton.
GetMuiCompatibleLanguageListFromLanguageTags(IIterable<String>)	Recupera un set di tag MUI (Multilingual User Interface) derivati da uno o più tag di lingua BCP-47.
IsWellFormed(String)	Determina se un tag di lingua BCP-47 è ben formato.
TrySetInputMethodLanguageTag(String)	Tenta di impostare il tag di lingua BCP-47 normalizzato di questa lingua.

Vedi anche

• Esempio di OCR (Windows 10)
• Esempio di preferenze di globalizzazione (Windows 10)