ApplicationLanguages Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Globalization
Modifica

Specifica le preferenze relative alla lingua che l'app può usare e gestire.

public ref class ApplicationLanguages abstract 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)]
class ApplicationLanguages 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)]
public static class ApplicationLanguages
Public Class ApplicationLanguages
Ereditarietà
Object Platform::Object IInspectable ApplicationLanguages
Attributi
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)

Commenti

Le lingue a cui si fa riferimento in questa classe sono rappresentate dai tag di lingua BCP-47. Ognuno di questi è un identificatore di lingua e non un nome delle impostazioni locali, anche se i due possono essere gli stessi. Come tag linguistico, "en-US" significa inglese americano (o il dialetto dell'inglese parlato nella Stati Uniti). Non fa alcuna attestazione sulla posizione effettiva degli altoparlanti (anche se molti di essi risiedono negli Stati Uniti) e nessun'altra attestazione sulle convenzioni usate negli Stati Uniti, ad esempio il sistema di misurazione o la valuta.

Esempio:

Windows.Globalization.ApplicationLanguages.PrimaryLanguageOverride = "en-US"

Nota

Se l'app passa tag di lingua da questa classe a qualsiasi funzione di supporto linguistico nazionale, deve prima convertire i tag chiamando ResolveLocaleName.

I tag del linguaggio supportano le estensioni Unicode "ca-" e "nu-". Vedere Definizioni chiave/tipo Unicode. Si noti che queste estensioni possono influire sul sistema numerico o il calendario usati dagli oggetti di globalizzazione.

Le app UWP possono essere distribuite usando pacchetti di risorse. Quando vengono usati pacchetti di risorse linguistici, i pacchetti installati e registrati per un determinato utente sono determinati dalle lingue nel profilo linguistico dell'utente. Di conseguenza, non tutte le lingue incluse nel bundle di app inviato a Microsoft Store saranno necessariamente disponibili per l'uso in fase di esecuzione. La proprietà PrimaryLanguageOverride deve essere impostata solo su lingue disponibili per l'utente.

Le lingue disponibili per l'app da usare come oggetto ApplicationLanguages in fase di esecuzione sono limitate a tali lingue incluse nel manifesto del pacchetto dell'app principale e alle lingue corrispondenti ai pacchetti di risorse linguistici applicabili per l'utente (determinate dalle lingue corrispondenti nelle preferenze dell'utente) e che vengono installate e registrate per l'utente. La proprietà ApplicationLanguages.ManifestLanguages riflette i pacchetti di risorse linguistici disponibili per l'utente e restituisce un set appropriato di lingue che possono essere usate per impostare la proprietà PrimaryLanguageOverride .

La proprietà ApplicationLanguages.Languages restituirà un elenco molto simile alla proprietà ManifestLanguages . Può differire tra cui le varianti della lingua regionale non elencate in alcun manifesto del pacchetto; Ad esempio, "en-CA" (inglese (Canada)) può essere restituito dalla proprietà Language se l'utente ha "en-CA" nel proprio profilo e l'app supporta qualsiasi varietà regionale di inglese. Tali varianti di lingua regionale derivate dall'utente possono essere preferibili per impostare la proprietà PrimaryLanguageOverride poiché l'app fornirà quindi comportamenti di globalizzazione più appropriati per l'utente.

Se una lingua si trova nel pacchetto dell'app principale, ma non è una corrispondenza per qualsiasi lingua nella preferenza dell'utente, viene restituita dalla proprietà ManifestLanguages , ma non dalla proprietà Languages . Questi possono essere usati anche per impostare la proprietà PrimaryLanguageOverride . Tuttavia, poiché queste lingue non si riflettono nelle preferenze dell'utente, l'utente potrebbe non comprendere tali lingue. Tali impostazioni devono essere usate solo se scelte direttamente dall'utente.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1803 17134 GetLanguagesForUser

Proprietà

Languages

Ottiene un elenco classificato dei valori del linguaggio di runtime correnti preferiti dall'utente.
ManifestLanguages

Ottiene l'elenco dichiarato dell'app per le lingue supportate.
PrimaryLanguageOverride

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

Metodi

GetLanguagesForUser(User)

Recupera le preferenze di lingua dell'utente specificato. Questa API fa parte del supporto per le app multiutente (MUA).

Si applica a

Vedi anche