CultureInfo.GetCultureInfo Metoda

Definice

Načte neuloženou instanci jazykové verze, která je jen pro čtení.Retrieves a cached, read-only instance of a culture.

Přetížení

GetCultureInfo(Int32)

Načte do mezipaměti instanci, která je jen pro čtení, pomocí zadaného identifikátoru jazykové verze.Retrieves a cached, read-only instance of a culture by using the specified culture identifier.

GetCultureInfo(String)

Načte do mezipaměti instanci, která je jen pro čtení, pomocí zadaného názvu jazykové verze.Retrieves a cached, read-only instance of a culture using the specified culture name.

GetCultureInfo(String, String)

Načte neuloženou instanci jazykové verze, která je jen pro čtení.Retrieves a cached, read-only instance of a culture. Parametry určují jazykovou verzi, která je inicializována pomocí TextInfo a CompareInfo objektů určených jinou jazykovou verzí.Parameters specify a culture that is initialized with the TextInfo and CompareInfo objects specified by another culture.

GetCultureInfo(Int32)

Načte do mezipaměti instanci, která je jen pro čtení, pomocí zadaného identifikátoru jazykové verze.Retrieves a cached, read-only instance of a culture by using the specified culture identifier.

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).A locale identifier (LCID).

Návraty

Objekt CultureInfo jen pro čtení.A read-only CultureInfo object.

Výjimky

culture je menší než nula.culture is less than zero.

culture určuje jazykovou verzi, která není podporována.culture specifies a culture that is not supported. Další informace najdete v části poznámky k volajícímu.See the Notes to Caller section for more information.

Poznámky

Doporučujeme použít přetížení řetězce této metody (GetCultureInfo(String)), protože místo LCID by měly být použity názvy národních prostředí.We recommend that you use the string overload of this method (GetCultureInfo(String)), because locale names should be used instead of LCIDs. Pro vlastní národní prostředí se vyžaduje název národního prostředí.For custom locales, the locale name is required.

Pokud culture je identifikátor národního prostředí aktuální jazykové verze, vrácený objekt CultureInfo neodráží žádná přepsání uživatele.If culture is the locale identifier of the current culture, the returned CultureInfo object does not reflect any user overrides.

Poznámky pro volající

.NET Framework 3.5.NET Framework 3.5 a starší verze vyvolají ArgumentException, pokud culture není platný identifikátor jazykové verze.The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if culture is not a valid culture identifier. Počínaje .NET Framework 4.NET Framework 4Tato metoda vyvolá CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. Počínaje aplikacemi, které běží v .NET Framework 4.NET Framework 4 nebo novějším ve Windows 7 nebo novějším, se metoda pokusí načíst objekt CultureInfo, jehož identifikátor je culture z operačního systému. Pokud operační systém tuto jazykovou verzi nepodporuje, vyvolá metoda CultureNotFoundException.Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is culture from the operating system; if the operating system does not support that culture, the method throws a CultureNotFoundException.

Viz také

GetCultureInfo(String)

Načte do mezipaměti instanci, která je jen pro čtení, pomocí zadaného názvu jazykové verze.Retrieves a cached, read-only instance of a culture using the specified culture name.

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.The name of a culture. name nerozlišuje velká a malá písmena.name is not case-sensitive.

Návraty

Objekt CultureInfo jen pro čtení.A read-only CultureInfo object.

Výjimky

name je null.name is null.

name určuje jazykovou verzi, která není podporována.name specifies a culture that is not supported. Další informace najdete v části poznámky k volajícím.See the Notes to Callers section for more information.

Poznámky

Seznam předdefinovaných názvů jazykové verze v systémech Windows naleznete ve sloupci značka jazyka v seznamu názvů jazyků nebo oblastí podporovaných systémem Windows.For a list of predefined culture names on Windows systems, see the Language tag column in the list of language/region names supported by Windows. Názvy jazykové verze se řídí standardem definovaným v BCP 47.Culture names follow the standard defined by BCP 47. Kromě toho, počínaje Windows 10, name může být jakákoli platná značka jazyka BCP-47.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

Metoda GetCultureInfo načte do mezipaměti objekt CultureInfo jen pro čtení.The GetCultureInfo method retrieves a cached, read-only CultureInfo object. Nabízí lepší výkon než odpovídající volání konstruktoru CultureInfo.CultureInfo(String).It offers better performance than a corresponding call to the CultureInfo.CultureInfo(String) constructor.

Pokud je name název aktuální jazykové verze, vrácený objekt CultureInfo neodráží žádná přepsání uživatele.If name is the name of the current culture, the returned CultureInfo object does not reflect any user overrides. Díky tomu je metoda vhodná pro serverové aplikace nebo nástroje, které nemají skutečný uživatelský účet v systému a které potřebují efektivně načítat více kultur.This makes the method suitable for server applications or tools that do not have a real user account on the system and that need to load multiple cultures efficiently.

Pokud je name String.Empty, metoda vrátí invariantní jazykovou verzi.If name is String.Empty, the method returns the invariant culture. To je ekvivalentní k načtení hodnoty vlastnosti InvariantCulture.This is equivalent to retrieving the value of the InvariantCulture property.

Poznámky pro volající

.NET Framework 3.5.NET Framework 3.5 a starší verze vyvolají ArgumentException, pokud name není platný název jazykové verze.The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if name is not a valid culture name. Počínaje .NET Framework 4.NET Framework 4Tato metoda vyvolá CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. Počínaje aplikacemi, které běží v .NET Framework 4.NET Framework 4 nebo novějším ve Windows 7 nebo novějším, se metoda pokusí načíst objekt CultureInfo, 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ázev doplňkové nebo nahrazující jazykové verze, metoda vyvolá CultureNotFoundException.Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is name from the operating system; if the operating system does not support that culture, and if name is not the name of a supplementary or replacement culture, the method throws a CultureNotFoundException.

Viz také

GetCultureInfo(String, String)

Načte neuloženou instanci jazykové verze, která je jen pro čtení.Retrieves a cached, read-only instance of a culture. Parametry určují jazykovou verzi, která je inicializována pomocí TextInfo a CompareInfo objektů určených jinou jazykovou verzí.Parameters specify a culture that is initialized with the TextInfo and CompareInfo objects specified by another culture.

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.The name of a culture. name nerozlišuje velká a malá písmena.name is not case-sensitive.

altName
String

Název jazykové verze, která poskytuje TextInfo a objekty CompareInfo používané k inicializaci name.The name of a culture that supplies the TextInfo and CompareInfo objects used to initialize name. altName nerozlišuje velká a malá písmena.altName is not case-sensitive.

Návraty

Objekt CultureInfo jen pro čtení.A read-only CultureInfo object.

Výjimky

name nebo altName je null.name or altName is null.

name nebo altName určuje jazykovou verzi, která není podporována.name or altName specifies a culture that is not supported. Další informace najdete v části poznámky k volajícím.See the Notes to Callers section for more information.

Poznámky

Seznam předdefinovaných názvů jazykové verze v systémech Windows naleznete ve sloupci značka jazyka v seznamu názvů jazyků nebo oblastí podporovaných systémem Windows.For a list of predefined culture names on Windows systems, see the Language tag column in the list of language/region names supported by Windows. Názvy jazykové verze se řídí standardem definovaným v BCP 47.Culture names follow the standard defined by BCP 47. Kromě toho, počínaje Windows 10, name může být jakákoli platná značka jazyka BCP-47.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

Metoda GetCultureInfo získá do mezipaměti objekt CultureInfo jen pro čtení.The GetCultureInfo method obtains a cached, read-only CultureInfo object. Nabízí lepší výkon než odpovídající volání konstruktoru CultureInfo.It offers better performance than a corresponding call to a CultureInfo constructor. Metoda se používá k vytvoření jazykové verze, která je podobná parametru name, který je určen parametrem, ale s různými pravidly řazení a používání velkých a malých písmen.The method is used to create a culture similar to that specified by the name parameter, but with different sorting and casing rules.

Pokud je name nebo altName název aktuální jazykové verze, vrácené objekty nereflektují žádné přepisy uživatele.If name or altName is the name of the current culture, the returned objects do not reflect any user overrides. Pokud je name String.Empty, metoda vrátí invariantní jazykovou verzi.If name is String.Empty, the method returns the invariant culture. To je ekvivalentní k načtení hodnoty vlastnosti InvariantCulture.This is equivalent to retrieving the value of the InvariantCulture property. Pokud je altName String.Empty, metoda používá systém zápisu a pravidla porovnávání určená neutrální jazykovou verzí.If altName is String.Empty, the method uses the writing system and comparison rules specified by the invariant culture.

Poznámky pro volající

.NET Framework 3.5.NET Framework 3.5 a starší verze vyvolají ArgumentException, pokud name nebo altName není platný název jazykové verze.The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if name or altName is not a valid culture name. Počínaje .NET Framework 4.NET Framework 4Tato metoda vyvolá CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. Počínaje aplikacemi, které běží v .NET Framework 4.NET Framework 4 nebo novějším ve Windows 7 nebo novějším, se metoda pokusí načíst objekt CultureInfo, 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ázev doplňkové nebo nahrazující jazykové verze, vyvolá metoda výjimku CultureNotFoundException.Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is name from the operating system; if the operating system does not support that culture, and if name is not the name of a supplementary or replacement culture, the method throws a CultureNotFoundException exception. Počínaje aplikacemi, které běží v .NET Framework 4.NET Framework 4 nebo novějším ve Windows 7 nebo novějším, se metoda pokusí načíst objekt CultureInfo, 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ázev doplňkové nebo nahrazující jazykové verze, vyvolá metoda výjimku CultureNotFoundException.Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is name from the operating system; if the operating system does not support that culture, and if name is not the name of a supplementary or replacement culture, the method throws a CultureNotFoundException exception.

Viz také

Platí pro