CultureInfo.GetCultureInfo Metoda

Definice

Obor názvů:

System.Globalization

Sestavení:

System.Runtime.dll

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á je inicializována 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í zadaného identifikátoru 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)

Zdroj:

CultureInfo.cs

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 se v něm velká a malá písmena.

predefinedOnly

Boolean

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

Návraty

CultureInfo

Instance jazykové verze jen pro čtení.

Poznámky

Ve výchozím nastavení se při pokusu o vytvoření jakékoli jazykové verze a podkladová platforma (Windows NLS nebo ICU) 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 true zajistí vytvoření jazykové verze pouze v případě, že platforma má pro danou jazykovou verzi skutečná data.

GetCultureInfo(String, String)

Zdroj:

CultureInfo.cs

Načte instanci jazykové verze uloženou v mezipaměti jen pro čtení. Parametry určují jazykovou verzi, která je inicializována 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 CultureInfo pro čtení.

Výjimky

ArgumentNullException

name nebo altName je null.

CultureNotFoundException

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 BCP 47. Kromě toho, počínaje Windows 10, name může být jakákoli platná značka jazyka BCP-47.

Metoda GetCultureInfo získá objekt jen pro čtení CultureInfo uložený v mezipaměti. 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 písmen.

Pokud name nebo altName je 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 odpovídá 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í

Rozhraní .NET Framework 3.5 a starší verze vyvolají ArgumentException název jazykové verze, zda name je nebo altName není platným názvem 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 ve 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 nepodporuje danou jazykovou verzi a pokud name není název 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ý globalizační invariantní režim, například některé kontejnery Dockeru a je zadána jiná jazyková verze než invariantní jazyková verze.

Viz také

• Name
• ClearCachedData()

GetCultureInfo(Int32)

Zdroj:

CultureInfo.cs

Načte instanci jazykové verze uloženou v mezipaměti jen pro čtení pomocí zadaného identifikátoru 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 CultureInfo pro čtení.

Výjimky

ArgumentOutOfRangeException

Hodnota culture je menší než nula.

CultureNotFoundException

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

Poznámky

Doporučujeme použít přetížení řetězců 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é přepsání uživatele.

Poznámky pro volající

Rozhraní .NET Framework 3.5 a starší verze vyvolá chybu ArgumentException , pokud culture není platným identifikátorem 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 ve 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 nepodporuje danou CultureNotFoundExceptionjazykovou verzi, metoda vyvolá .

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ý globalizační invariantní režim, například některé kontejnery Dockeru a je zadána jiná jazyková verze než invariantní jazyková verze.

Viz také

• LCID
• ClearCachedData()

GetCultureInfo(String)

Zdroj:

CultureInfo.cs

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 CultureInfo pro čtení.

Výjimky

ArgumentNullException

name je null.

CultureNotFoundException

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 BCP 47. Kromě toho, počínaje Windows 10, name může být jakákoli 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é přepsání uživatele. 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číst více jazykových verzí.

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

Poznámky pro volající

Rozhraní .NET Framework 3.5 a starší verze způsobí ArgumentException , že name pokud 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 ve 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 nepodporuje danou jazykovou verzi a pokud name není název 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ý globalizační invariantní režim, například některé kontejnery Dockeru a je zadána jiná jazyková verze než invariantní jazyková verze.

Viz také

• Name