Condividi tramite


Locale.ToLanguageTag Metodo

Definizione

Restituisce un tag di lingua IETF BCP 47 ben formato che rappresenta queste impostazioni locali.

[Android.Runtime.Register("toLanguageTag", "()Ljava/lang/String;", "")]
public string ToLanguageTag ();
[<Android.Runtime.Register("toLanguageTag", "()Ljava/lang/String;", "")>]
member this.ToLanguageTag : unit -> string

Restituisce

un tag di lingua BCP47 che rappresenta le impostazioni locali

Attributi

Commenti

Restituisce un tag di lingua IETF BCP 47 ben formato che rappresenta queste impostazioni locali.

Se ha Locale una lingua, un paese o una variante che non soddisfa i requisiti di sintassi dei tag di lingua IETF BCP 47, questo metodo gestisce questi campi come descritto di seguito:

<b>Language:</b> Se la lingua è vuota o non è ben formata (ad esempio "a" o "e2"), verrà emessa come "und" (Undmined).

<b>Country:</b> Se il paese non è ben formato (ad esempio "12" o "USA"), verrà omesso.

<b>Variant:</b> Se la variante <b>è< ben> formata, ogni sotto segmento (delimitato da '-' o '_') viene generato come sottotag. In caso contrario: <ul>

<li>se tutti i segmenti secondari corrispondono [0-9a-zA-Z]{1,8} (ad esempio "WIN" o "Oracle_JDK_Standard_Edition"), il primo sottotipo non formato e tutti gli elementi seguenti verranno aggiunti al sottotag di utilizzo privato. Il primo sottotag aggiunto sarà "lvariant", seguito dai sotto segmenti in ordine, separati da trattino. Ad esempio, "x-lvariant-WIN", "Oracle-x-lvariant-JDK-Standard-Edition".

<li>se qualsiasi segmento secondario non corrisponde [0-9a-zA-Z]{1,8}a , la variante verrà troncata e il sotto segmento problematico e tutti i segmenti secondari seguenti verranno omessi. Se il resto non è vuoto, verrà generato come sottotag di utilizzo privato come indicato in precedenza (anche se il resto risulta essere ben formato). Ad esempio, "Solaris_isjustthecoolestthing" viene generato come "x-lvariant-Solaris", non come "solaris".</li></ul>

<b>Conversioni speciali:</b> Java supporta alcune rappresentazioni delle impostazioni locali precedenti, inclusi i codici del linguaggio ISO deprecati, per la compatibilità. Questo metodo esegue le conversioni seguenti: <ul>

<i codici>di lingua ISO deprecati "iw", "ji" e "in" vengono convertiti rispettivamente in "he", "yi" e "id".

<li>Locale con lingua "no", paese "NO" e variante "NY", che rappresenta il norvegese Nynorsk (Norvegia), viene convertito in un tag di lingua "nn-NO".</li></ul>

<b Nota:</b>> Sebbene il tag di lingua creato da questo metodo sia ben formato (soddisfa i requisiti di sintassi definiti dalla specifica IETF BCP 47), non è necessariamente un tag di lingua BCP 47 valido. ad esempio:

new Locale("xx", "YY").toLanguageTag();

restituirà "xx-YY", ma il sottotag linguistico "xx" e il sottotag dell'area "YY" non sono validi perché non sono registrati nel Registro sottotag lingua IANA.

Aggiunta nella versione 1.7.

Documentazione java per java.util.Locale.toLanguageTag().

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.

Si applica a