CultureInfo.GetCultureInfoByIetfLanguageTag(String) Metodo

Definizione

Spazio dei nomi:

System.Globalization

Assembly:

System.Runtime.dll

Source:

CultureInfo.cs

Deprecato. Recupera un oggetto CultureInfo di sola lettura con caratteristiche linguistiche identificate dal tag della lingua RFC 4646 specificato.

public:
 static System::Globalization::CultureInfo ^ GetCultureInfoByIetfLanguageTag(System::String ^ name);

public static System.Globalization.CultureInfo GetCultureInfoByIetfLanguageTag (string name);

static member GetCultureInfoByIetfLanguageTag : string -> System.Globalization.CultureInfo

Public Shared Function GetCultureInfoByIetfLanguageTag (name As String) As CultureInfo

Parametri

name

String

Nome di una lingua come specificato dallo standard RFC 4646.

Restituisce

CultureInfo

Oggetto CultureInfo di sola lettura.

Eccezioni

ArgumentNullException

name è null.

CultureNotFoundException

name non corrisponde a impostazioni cultura supportate.

Commenti

Nota

Questo metodo e la IetfLanguageTag proprietà sono deprecati. Anziché usare queste API, è consigliabile usare i CultureInfo costruttori, CultureInfo.GetCultureInfoe la Name proprietà . I tag e i nomi IETF sono identici.

Lo standard RFC 4646 gestito da Internet Engineering Task Force (IETF) definisce un tag di linguaggio IETF, che fornisce un mezzo uniforme per identificare una lingua. Il formato di un tag linguistico IETF è lo stesso del nome delle impostazioni cultura restituito dalla Name proprietà, ma non identifica in modo univoco le impostazioni cultura. Le diverse culture condividono lo stesso tag linguistico IETF se tali culture hanno caratteristiche linguistiche identiche. Le caratteristiche linguistiche di una cultura sono contenute nell'oggetto TextInfo associato a un CultureInfo oggetto.

Un tag di linguaggio IETF è costituito da un identificatore di linguaggio obbligatorio, un identificatore di script facoltativo e un identificatore di area facoltativo.

Le applicazioni devono usare le impostazioni cultura recuperate per controllare le attività specifiche del linguaggio, ad esempio la gestione di un controllo ortografico o grammaticale. Le applicazioni non devono usare le impostazioni cultura recuperate per controllare le attività specifiche delle impostazioni cultura, ad esempio l'ordinamento del testo o la formattazione di orari e date.

Per altre informazioni, vedere RFC 4646 - "Tag per l'identificazione dei linguaggi.

Note per i chiamanti

.NET Framework 3.5 e versioni precedenti generano un ArgumentException valore se name non corrisponde al nome di una cultura supportata. A partire da .NET Framework 4, questo metodo genera un CultureNotFoundExceptionoggetto .

Vedi anche

• TextInfo
• CultureAndRegionInfoBuilder
• ClearCachedData()