CultureInfo.GetCultureInfo Metodo

Definizione

Spazio dei nomi:

System.Globalization

Assembly:

System.Runtime.dll

Recupera un'istanza di sola lettura e memorizzata nella cache di determinate impostazioni cultura.

Overload

GetCultureInfo(String, Boolean)	Recupera un'istanza di sola lettura e memorizzata nella cache di determinate impostazioni cultura.
GetCultureInfo(String, String)	Recupera un'istanza di sola lettura e memorizzata nella cache di determinate impostazioni cultura. I parametri specificano le impostazioni cultura inizializzate con gli oggetti TextInfo e CompareInfo specificati da altre impostazioni cultura.
GetCultureInfo(Int32)	Recupera un'istanza di sola lettura e memorizzata nella cache di determinate impostazioni cultura utilizzando l'identificatore delle impostazioni cultura specificato.
GetCultureInfo(String)	Recupera un'istanza di sola lettura e inserita nella cache di determinate impostazioni cultura utilizzando il nome delle impostazioni cultura specificato.

GetCultureInfo(String, Boolean)

Origine:

CultureInfo.cs

Recupera un'istanza di sola lettura e memorizzata nella cache di determinate 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.CultureInfo

Public Shared Function GetCultureInfo (name As String, predefinedOnly As Boolean) As CultureInfo

Parametri

name

String

Nome di impostazioni cultura. Non fa distinzione tra maiuscole e minuscole.

predefinedOnly

Boolean

true se viene richiesto di creare un'istanza di impostazioni cultura note nella piattaforma. false se è accettabile recuperare le impostazioni cultura create anche se la piattaforma non include dati per le stesse.

Restituisce

CultureInfo

Istanza di sola lettura di determinate 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 proverà a costruire impostazioni cultura con dati di altre impostazioni cultura o alcuni valori costanti.

L'impostazione predefinedOnly di su true garantirà la creazione di impostazioni cultura solo se la piattaforma dispone di dati reali per tali impostazioni cultura.

GetCultureInfo(String, String)

Origine:

CultureInfo.cs

Recupera un'istanza di sola lettura e memorizzata nella cache di determinate impostazioni cultura. I parametri specificano le impostazioni cultura inizializzate con gli oggetti TextInfo 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.CultureInfo

Public Shared Function GetCultureInfo (name As String, altName As String) As CultureInfo

Parametri

name

String

Nome di impostazioni cultura. Per name non viene effettuata la distinzione tra maiuscole e minuscole.

altName

String

Nome delle impostazioni cultura che forniscono gli oggetti TextInfo e CompareInfo utilizzati per inizializzare name. Per altName non viene effettuata la distinzione tra maiuscole e minuscole.

Restituisce

CultureInfo

Oggetto CultureInfo di sola lettura.

Eccezioni

ArgumentNullException

name o altName è null.

CultureNotFoundException

name o altName specifica impostazioni cultura non supportate. Per altre informazioni, vedere la sezione Note per i 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 impostazioni cultura 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 utilizza le regole di confronto e di sistema di scrittura 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 versione successiva in Windows 7 o versione successiva, 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 viene specificata una cultura diversa dalle impostazioni cultura invarianti.

Vedi anche

• Name
• ClearCachedData()

GetCultureInfo(Int32)

Origine:

CultureInfo.cs

Recupera un'istanza di sola lettura e memorizzata nella cache di determinate 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.CultureInfo

Public Shared Function GetCultureInfo (culture As Integer) As CultureInfo

Parametri

culture

Int32

Identificatore delle impostazioni locali (LCID).

Restituisce

CultureInfo

Oggetto CultureInfo di sola lettura.

Eccezioni

ArgumentOutOfRangeException

culture è minore di zero.

CultureNotFoundException

culture specifica impostazioni cultura non supportate. Per altre informazioni, vedere la sezione Note per i chiamanti.

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 alcun override dell'utente.

Note per i chiamanti

.NET Framework 3.5 e versioni precedenti generano un'eccezione ArgumentException se culture non è un identificatore 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 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 viene specificata una cultura diversa dalle impostazioni cultura invarianti.

Vedi anche

• LCID
• ClearCachedData()

GetCultureInfo(String)

Origine:

CultureInfo.cs

Recupera un'istanza di sola lettura e inserita nella cache di determinate impostazioni cultura utilizzando 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.CultureInfo

Public Shared Function GetCultureInfo (name As String) As CultureInfo

Parametri

name

String

Nome di impostazioni cultura. Per name non viene effettuata la distinzione tra maiuscole e minuscole.

Restituisce

CultureInfo

Oggetto CultureInfo di sola lettura.

Eccezioni

ArgumentNullException

name è null.

CultureNotFoundException

name specifica impostazioni cultura non supportate. Per altre informazioni, vedere la sezione Note per i 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 impostazioni cultura 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 alcun 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 versione successiva in Windows 7 o versione successiva, 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 viene specificata una cultura diversa dalle impostazioni cultura invarianti.

Vedi anche

• Name