ApplicationLanguages.PrimaryLanguageOverride Proprietà

Definizione

Spazio dei nomi:

Windows.Globalization

Ottiene o imposta un override per la lingua preferita dell'app, espressa come tag di lingua BCP-47 . Questa impostazione è persistente.

public:
 static property Platform::String ^ PrimaryLanguageOverride { Platform::String ^ get(); void set(Platform::String ^ value); };

static winrt::hstring PrimaryLanguageOverride();

static void PrimaryLanguageOverride(winrt::hstring value);

public static string PrimaryLanguageOverride { get; set; }

var string = ApplicationLanguages.primaryLanguageOverride;
ApplicationLanguages.primaryLanguageOverride = string;

Public Shared Property PrimaryLanguageOverride As String

Valore della proprietà

String

Platform::String

winrt::hstring

Tag di lingua BCP-47 . L'app può impostarla per eseguire l'override della lingua superiore dell'elenco classificato dell'utente di lingue preferite (ApplicationLanguages.Language) e il relativo valore persisterà tra le sessioni dell'app. Deve essere un singolo tag di lingua; un elenco delimitato di tag di lingua avrà esito negativo.

Quando l'app ottiene il valore, PrimaryLanguageOverride restituisce un singolo tag di lingua (se l'app ha precedentemente impostato la proprietà) o una stringa vuota.

Commenti

Le app in genere vengono eseguite con le impostazioni della lingua determinate dal sistema confrontando le lingue supportate dall'app con le preferenze linguistiche dell'utente. È possibile ottenere le impostazioni per tale comportamento di sistema usando la proprietà ApplicationLanguages.Languages . La proprietà PrimaryLanguageOverride viene usata per eseguire l'override del comportamento impostando una lingua specifica come prima lingua nell'elenco Lingue.

L'impostazione PrimaryLanguageOverride viene mantenuta tra le sessioni. Non deve essere impostato ogni volta che l'app viene caricata. Deve essere impostato solo in base all'input utente presentato nell'interfaccia utente delle impostazioni. La proprietà può essere letta in qualsiasi momento. Se la proprietà non è mai stata impostata, restituisce una stringa vuota.

Quando si imposta la proprietà PrimaryLanguageOverride, questa viene immediatamente riflessa nella proprietà ApplicationLanguages.Languages . Tuttavia, questa modifica potrebbe non avere effetto immediatamente sulle risorse caricate nell'interfaccia utente dell'app. Per assicurarsi che l'app risponda a tali modifiche, è possibile ascoltare la proprietà QualifierValues in un contesto di risorsa predefinito e eseguire qualsiasi azione potrebbe essere necessaria per ricaricare le risorse. Questi requisiti possono variare a seconda del framework dell'interfaccia utente usato dall'app e potrebbe essere necessario riavviare l'app.

Vedi anche

• Languages
• Tag di lingua BCP-47