CultureInfo.GetCultureInfo Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Recupera un'istanza memorizzata nella cache di sola lettura di impostazioni cultura.
Overload
| Nome | Descrizione |
|---|---|
| GetCultureInfo(String, Boolean) |
Recupera un'istanza memorizzata nella cache di sola lettura di impostazioni cultura. |
| GetCultureInfo(String, String) |
Recupera un'istanza memorizzata nella cache di sola lettura di impostazioni cultura. I parametri specificano impostazioni cultura inizializzate con gli TextInfo oggetti e CompareInfo specificati da altre impostazioni cultura. |
| GetCultureInfo(Int32) |
Recupera un'istanza memorizzata nella cache di sola lettura di impostazioni cultura utilizzando l'identificatore delle impostazioni cultura specificato. |
| GetCultureInfo(String) |
Recupera un'istanza memorizzata nella cache di sola lettura di impostazioni cultura usando il nome delle impostazioni cultura specificato. |
GetCultureInfo(String, Boolean)
- Origine:
- CultureInfo.cs
- Origine:
- CultureInfo.cs
- Origine:
- CultureInfo.cs
- Origine:
- CultureInfo.cs
- Origine:
- CultureInfo.cs
Recupera un'istanza memorizzata nella cache di sola lettura di impostazioni cultura.
public:
static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name, bool predefinedOnly);public static System.Globalization.CultureInfo GetCultureInfo(string name, bool predefinedOnly);static member GetCultureInfo : string * bool -> System.Globalization.CultureInfoPublic Shared Function GetCultureInfo (name As String, predefinedOnly As Boolean) As CultureInfoParametri
- name
- String
Nome di impostazioni cultura. Non fa distinzione tra maiuscole e minuscole.
- predefinedOnly
- Boolean
true se si richiede di creare un'istanza di impostazioni cultura note dalla piattaforma.
false se è ok recuperare una cultura costituita anche se la piattaforma non contiene dati per esso.
Valori restituiti
Istanza di sola lettura di impostazioni cultura.
Commenti
Per impostazione predefinita, quando si tenta di creare impostazioni cultura e la piattaforma sottostante (Windows NLS o ICU) non contiene dati specifici per queste impostazioni cultura, la piattaforma tenterà di creare impostazioni cultura con dati provenienti da altre impostazioni cultura o alcuni valori costanti.
L'impostazione su true garantisce la creazione di predefinedOnly impostazioni cultura solo se la piattaforma dispone di dati reali per tali impostazioni cultura.
Si applica a
GetCultureInfo(String, String)
- Origine:
- CultureInfo.cs
- Origine:
- CultureInfo.cs
- Origine:
- CultureInfo.cs
- Origine:
- CultureInfo.cs
- Origine:
- CultureInfo.cs
Recupera un'istanza memorizzata nella cache di sola lettura di impostazioni cultura. I parametri specificano impostazioni cultura inizializzate con gli TextInfo oggetti e CompareInfo specificati da altre impostazioni cultura.
public:
static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name, System::String ^ altName);public static System.Globalization.CultureInfo GetCultureInfo(string name, string altName);static member GetCultureInfo : string * string -> System.Globalization.CultureInfoPublic Shared Function GetCultureInfo (name As String, altName As String) As CultureInfoParametri
- name
- String
Nome di impostazioni cultura.
name non fa distinzione tra maiuscole e minuscole.
- altName
- String
Nome di impostazioni cultura che fornisce gli TextInfo oggetti e CompareInfo utilizzati per inizializzare name.
altName non fa distinzione tra maiuscole e minuscole.
Valori restituiti
Oggetto di sola lettura CultureInfo .
Eccezioni
name o altName è null.
name o altName specifica impostazioni cultura non supportate. Per altre informazioni, vedere la sezione Note ai chiamanti.
Commenti
Per un elenco dei nomi delle impostazioni cultura predefiniti nei sistemi Windows, vedere la colonna Tag linguanell'elenco dei nomi di lingua/area geografica supportati da Windows. I nomi delle culture seguono lo standard definito da BCP 47. Inoltre, a partire da Windows 10, name può essere qualsiasi tag di lingua BCP-47 valido.
Il GetCultureInfo metodo ottiene un oggetto memorizzato nella cache di sola lettura CultureInfo . Offre prestazioni migliori rispetto a una chiamata corrispondente a un CultureInfo costruttore. Il metodo viene usato per creare impostazioni cultura simili a quella specificata dal name parametro , ma con regole di ordinamento e di maiuscole e minuscole diverse.
Se name o altName è il nome delle impostazioni cultura correnti, gli oggetti restituiti non riflettono alcun override dell'utente. Se name è String.Empty, il metodo restituisce le impostazioni cultura invarianti. Equivale a recuperare il valore della InvariantCulture proprietà . Se altName è String.Empty, il metodo usa il sistema di scrittura e le regole di confronto specificate dalle impostazioni cultura invarianti.
Note per i chiamanti
.NET Framework 3.5 e versioni precedenti generano un'eccezione ArgumentException se name o altName non è un nome di impostazioni cultura valido. A partire da .NET Framework 4, questo metodo genera un'eccezione CultureNotFoundException. A partire dalle app eseguite in .NET Framework 4 o versioni successive in Windows 7 o versioni successive, il metodo tenta di recuperare un CultureInfo oggetto il cui identificatore proviene name dal sistema operativo; se il sistema operativo non supporta tali impostazioni cultura e se name non è il nome di impostazioni cultura supplementari o sostitutive, il metodo genera un'eccezione CultureNotFoundException .
In .NET 6 e versioni successive viene generata un'eccezione CultureNotFoundException se l'app è in esecuzione in un ambiente in cui è abilitata la modalità invariante di globalizzazione, ad esempio alcuni contenitori Docker e impostazioni cultura diverse dalle impostazioni cultura invarianti.
Vedi anche
Si applica a
GetCultureInfo(Int32)
- Origine:
- CultureInfo.cs
- Origine:
- CultureInfo.cs
- Origine:
- CultureInfo.cs
- Origine:
- CultureInfo.cs
- Origine:
- CultureInfo.cs
Recupera un'istanza memorizzata nella cache di sola lettura di impostazioni cultura utilizzando l'identificatore delle impostazioni cultura specificato.
public:
static System::Globalization::CultureInfo ^ GetCultureInfo(int culture);public static System.Globalization.CultureInfo GetCultureInfo(int culture);static member GetCultureInfo : int -> System.Globalization.CultureInfoPublic Shared Function GetCultureInfo (culture As Integer) As CultureInfoParametri
- culture
- Int32
Identificatore delle impostazioni locali (LCID).
Valori restituiti
Oggetto di sola lettura CultureInfo .
Eccezioni
culture è minore di zero.
culture specifica impostazioni cultura non supportate. Per altre informazioni, vedere la sezione Note al chiamante.
Commenti
È consigliabile usare l'overload di stringa di questo metodo (GetCultureInfo(String)), perché i nomi delle impostazioni locali devono essere usati invece di LCID. Per le impostazioni locali personalizzate, è necessario il nome delle impostazioni locali.
Se culture è l'identificatore delle impostazioni locali delle impostazioni cultura correnti, l'oggetto restituito CultureInfo non riflette alcuna override dell'utente.
Annotazioni
Gli LCID sono deprecati e gli implementatori sono fortemente invitati a usare versioni più recenti delle API che supportano invece i nomi delle impostazioni locali BCP 47. Ogni LCID può essere rappresentato da un nome di impostazioni locali BCP 47, ma il contrario non è true. L'intervallo LCID è limitato e non è in grado di identificare in modo univoco tutte le possibili combinazioni di lingua e area geografica.
Note per i chiamanti
.NET Framework 3.5 e versioni precedenti generano un'eccezione ArgumentException se culture non è un identificatore delle impostazioni cultura valido. A partire da .NET Framework 4, questo metodo genera un'eccezione CultureNotFoundException. A partire dalle app eseguite in .NET Framework 4 o versioni successive in Windows 7 o versioni successive, il metodo tenta di recuperare un CultureInfo oggetto il cui identificatore proviene culture dal sistema operativo; se il sistema operativo non supporta tale cultura, il metodo genera un'eccezione CultureNotFoundException.
In .NET 6 e versioni successive viene generata un'eccezione CultureNotFoundException se l'app è in esecuzione in un ambiente in cui è abilitata la modalità invariante di globalizzazione, ad esempio alcuni contenitori Docker e impostazioni cultura diverse dalle impostazioni cultura invarianti.
Vedi anche
Si applica a
GetCultureInfo(String)
- Origine:
- CultureInfo.cs
- Origine:
- CultureInfo.cs
- Origine:
- CultureInfo.cs
- Origine:
- CultureInfo.cs
- Origine:
- CultureInfo.cs
Recupera un'istanza memorizzata nella cache di sola lettura di impostazioni cultura usando il nome delle impostazioni cultura specificato.
public:
static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name);public static System.Globalization.CultureInfo GetCultureInfo(string name);static member GetCultureInfo : string -> System.Globalization.CultureInfoPublic Shared Function GetCultureInfo (name As String) As CultureInfoParametri
- name
- String
Nome di impostazioni cultura.
name non fa distinzione tra maiuscole e minuscole.
Valori restituiti
Oggetto di sola lettura CultureInfo .
Eccezioni
name è null.
name specifica impostazioni cultura non supportate. Per altre informazioni, vedere la sezione Note ai chiamanti.
Commenti
Per un elenco dei nomi delle impostazioni cultura predefiniti nei sistemi Windows, vedere la colonna Tag linguanell'elenco dei nomi di lingua/area geografica supportati da Windows. I nomi delle culture seguono lo standard definito da BCP 47. Inoltre, a partire da Windows 10, name può essere qualsiasi tag di lingua BCP-47 valido.
Il GetCultureInfo metodo recupera un oggetto memorizzato nella cache di sola lettura CultureInfo . Offre prestazioni migliori rispetto a una chiamata corrispondente al CultureInfo.CultureInfo(String) costruttore.
Se name è il nome delle impostazioni cultura correnti, l'oggetto restituito CultureInfo non riflette alcuna override dell'utente. Questo rende il metodo adatto per applicazioni server o strumenti che non dispongono di un account utente reale nel sistema e che devono caricare più impostazioni cultura in modo efficiente.
Se name è String.Empty, il metodo restituisce le impostazioni cultura invarianti. Equivale a recuperare il valore della InvariantCulture proprietà .
Note per i chiamanti
.NET Framework 3.5 e versioni precedenti generano un'eccezione ArgumentException se name non è un nome di impostazioni cultura valido. A partire da .NET Framework 4, questo metodo genera un'eccezione CultureNotFoundException. A partire dalle app eseguite in .NET Framework 4 o versioni successive in Windows 7 o versioni successive, il metodo tenta di recuperare un CultureInfo oggetto il cui identificatore proviene name dal sistema operativo; se il sistema operativo non supporta tali impostazioni cultura e se name non è il nome di impostazioni cultura supplementari o sostitutive, il metodo genera un'eccezione CultureNotFoundException.
In .NET 6 e versioni successive viene generata un'eccezione CultureNotFoundException se l'app è in esecuzione in un ambiente in cui è abilitata la modalità invariante di globalizzazione, ad esempio alcuni contenitori Docker e impostazioni cultura diverse dalle impostazioni cultura invarianti.
