CultureInfo.GetCultureInfo Metoda

Definice

Načte instanci jazykové verze uloženou v mezipaměti, jen pro čtení.

Přetížení

GetCultureInfo(String, Boolean)

Načte instanci jazykové verze uloženou v mezipaměti, jen pro čtení.

GetCultureInfo(String, String)

Načte instanci jazykové verze uloženou v mezipaměti, jen pro čtení. Parametry určují jazykovou verzi, která se inicializuje pomocí TextInfo objektů a CompareInfo určených jinou jazykovou verzí.

GetCultureInfo(Int32)

Načte instanci jazykové verze uloženou v mezipaměti jen pro čtení pomocí identifikátoru zadané jazykové verze.

GetCultureInfo(String)

Načte instanci jazykové verze uloženou v mezipaměti jen pro čtení pomocí zadaného názvu jazykové verze.

GetCultureInfo(String, Boolean)

Načte instanci jazykové verze uloženou v mezipaměti, jen pro čtení.

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

Parametry

name
String

Název jazykové verze. Nerozlišuje malá a velká písmena.

predefinedOnly
Boolean

true pokud žádáte o vytvoření instance jazykové verze, kterou platforma zná. false pokud je v pořádku získat vymyšněnou jazykovou verzi, i když platforma pro ni nepřenáší data.

Návraty

CultureInfo

Instance jazykové verze jen pro čtení.

Poznámky

Když se ve výchozím nastavení pokusíte vytvořit jakoukoli jazykovou verzi a základní platforma (NLS nebo ICU systému Windows) neobsahuje konkrétní data pro tuto jazykovou verzi, pokusí se platforma vytvořit jazykovou verzi s daty z jiných jazykových verzí nebo některých konstantních hodnot.

Nastavení predefinedOnly na zajistí true vytvoření jazykové verze pouze v případě, že platforma obsahuje skutečná data pro danou jazykovou verzi.

Platí pro

GetCultureInfo(String, String)

Načte instanci jazykové verze uloženou v mezipaměti, jen pro čtení. Parametry určují jazykovou verzi, která se inicializuje pomocí TextInfo objektů a CompareInfo určených jinou jazykovou verzí.

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

Parametry

name
String

Název jazykové verze. name nerozlišuje velká a malá písmena.

altName
String

Název jazykové verze, která poskytuje TextInfo objekty a CompareInfo použité k inicializaci name. altName nerozlišuje velká a malá písmena.

Návraty

CultureInfo

Objekt jen pro CultureInfo čtení.

Výjimky

name nebo altName má hodnotu null.

name nebo altName určuje jazykovou verzi, která není podporována. Další informace najdete v části Poznámky pro volající.

Poznámky

Seznam předdefinovaných názvů jazykových verzí v systémech Windows najdete ve sloupci Značka jazyka v seznamu názvů jazyků a oblastí podporovaných systémem Windows. Názvy jazykových verzí se řídí standardem definovaným v BCP 47. Kromě toho může být počínaje Windows 10 name libovolná platná značka jazyka BCP-47.

Metoda GetCultureInfo získá objekt uložený v mezipaměti jen CultureInfo pro čtení. Nabízí lepší výkon než odpovídající volání konstruktoru CultureInfo . Metoda se používá k vytvoření jazykové verze podobné té, která je určena parametrem name , ale s různými pravidly řazení a malých a malých a malých.

Pokud name je nebo altName název aktuální jazykové verze, vrácené objekty neodráží žádné přepsání uživatele. Pokud name je String.Empty, vrátí metoda invariantní jazykovou verzi. To je ekvivalentní k načtení hodnoty InvariantCulture vlastnosti. Pokud altName je String.Empty, metoda používá systém zápisu a pravidla porovnání určená invariantní jazykovou verzí.

Poznámky pro volající

.NET Framework 3.5 a starší verze vyvolají ArgumentException název jazykové verze, pokud name nebo altName není platný název jazykové verze. Počínaje rozhraním .NET Framework 4 tato metoda vyvolá .CultureNotFoundException Počínaje aplikacemi, které běží v rozhraní .NET Framework 4 nebo novějším v systému Windows 7 nebo novějším, se metoda pokusí načíst CultureInfo objekt, jehož identifikátor je name z operačního systému. Pokud operační systém tuto jazykovou verzi nepodporuje a pokud name není názvem doplňkové nebo náhradní jazykové verze, metoda vyvolá CultureNotFoundException výjimku.

V .NET 6 a novějších verzích se vyvolá, pokud je aplikace spuštěná v prostředí, CultureNotFoundException ve kterém je povolený režim invariantní globalizace, například některé kontejnery Dockeru a je zadaná jiná jazyková verze než neutrální jazyková verze.

Viz také

Platí pro

GetCultureInfo(Int32)

Načte instanci jazykové verze uloženou v mezipaměti jen pro čtení pomocí identifikátoru zadané jazykové verze.

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

Parametry

culture
Int32

Identifikátor národního prostředí (LCID).

Návraty

CultureInfo

Objekt jen pro CultureInfo čtení.

Výjimky

Hodnota culture je menší než nula.

culture určuje jazykovou verzi, která není podporována. Další informace najdete v části Poznámky pro volajícího.

Poznámky

Doporučujeme použít řetězcové přetížení této metody (GetCultureInfo(String)), protože místo LCID by se měly používat názvy národních prostředí. Pro vlastní národní prostředí se vyžaduje název národního prostředí.

Pokud culture je identifikátor národního prostředí aktuální jazykové verze, vrácený CultureInfo objekt neodráží žádná uživatelská přepsání.

Poznámky pro volající

Rozhraní .NET Framework 3.5 a starší verze vyvolat ArgumentExceptionculture identifikátor jazykové verze není platný. Počínaje rozhraním .NET Framework 4 tato metoda vyvolá .CultureNotFoundException Počínaje aplikacemi, které běží v rozhraní .NET Framework 4 nebo novějším v systému Windows 7 nebo novějším, se metoda pokusí načíst CultureInfo objekt, jehož identifikátor je culture z operačního systému. Pokud operační systém tuto jazykovou verzi nepodporuje, metoda vyvolá CultureNotFoundException.

V .NET 6 a novějších verzích se vyvolá, pokud je aplikace spuštěná v prostředí, CultureNotFoundException ve kterém je povolený režim invariantní globalizace, například některé kontejnery Dockeru a je zadaná jiná jazyková verze než neutrální jazyková verze.

Viz také

Platí pro

GetCultureInfo(String)

Načte instanci jazykové verze uloženou v mezipaměti jen pro čtení pomocí zadaného názvu jazykové verze.

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

Parametry

name
String

Název jazykové verze. name nerozlišuje velká a malá písmena.

Návraty

CultureInfo

Objekt jen pro CultureInfo čtení.

Výjimky

name má hodnotu null.

name určuje jazykovou verzi, která není podporována. Další informace najdete v části Poznámky pro volající.

Poznámky

Seznam předdefinovaných názvů jazykových verzí v systémech Windows najdete ve sloupci Značka jazyka v seznamu názvů jazyků a oblastí podporovaných systémem Windows. Názvy jazykových verzí se řídí standardem definovaným v BCP 47. Kromě toho může být počínaje Windows 10 name libovolná platná značka jazyka BCP-47.

Metoda GetCultureInfo načte objekt uložený v mezipaměti jen CultureInfo pro čtení. Nabízí lepší výkon než odpovídající volání konstruktoru CultureInfo.CultureInfo(String) .

Pokud name je název aktuální jazykové verze, vrácený CultureInfo objekt neodráží žádná uživatelská přepsání. Díky tomu je metoda vhodná pro serverové aplikace nebo nástroje, které nemají v systému skutečný uživatelský účet a potřebují efektivně načítat více jazykových verzí.

Pokud name je String.Empty, vrátí metoda invariantní jazykovou verzi. To je ekvivalentní k načtení hodnoty InvariantCulture vlastnosti.

Poznámky pro volající

Rozhraní .NET Framework 3.5 a starší verze vyvolá chybu ArgumentException if name není platný název jazykové verze. Počínaje rozhraním .NET Framework 4 tato metoda vyvolá .CultureNotFoundException Počínaje aplikacemi, které běží v rozhraní .NET Framework 4 nebo novějším v systému Windows 7 nebo novějším, se metoda pokusí načíst CultureInfo objekt, jehož identifikátor je name z operačního systému. Pokud operační systém tuto jazykovou verzi nepodporuje a pokud name není názvem doplňkové nebo náhradní jazykové verze, metoda vyvolá CultureNotFoundException.

V .NET 6 a novějších verzích se vyvolá, pokud je aplikace spuštěná v prostředí, CultureNotFoundException ve kterém je povolený režim invariantní globalizace, například některé kontejnery Dockeru a je zadaná jiná jazyková verze než neutrální jazyková verze.

Viz také

Platí pro