CultureInfo.GetCultureInfo Metoda

Definicja

Przestrzeń nazw:

System.Globalization

Zestaw:

System.Runtime.dll

Pobiera buforowane, tylko do odczytu wystąpienie kultury.

Przeciążenia

GetCultureInfo(String, Boolean)	Pobiera buforowane, tylko do odczytu wystąpienie kultury.
GetCultureInfo(String, String)	Pobiera buforowane, tylko do odczytu wystąpienie kultury. Parametry określają kulturę zainicjowaną za TextInfo pomocą obiektów i CompareInfo określonych przez inną kulturę.
GetCultureInfo(Int32)	Pobiera buforowane wystąpienie kultury tylko do odczytu przy użyciu określonego identyfikatora kultury.
GetCultureInfo(String)	Pobiera buforowane wystąpienie kultury tylko do odczytu przy użyciu określonej nazwy kultury.

GetCultureInfo(String, Boolean)

Źródło:

CultureInfo.cs

Pobiera buforowane, tylko do odczytu wystąpienie kultury.

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

Nazwa kultury. Nie uwzględnia wielkości liter.

predefinedOnly

Boolean

true w przypadku żądania utworzenia wystąpienia kultury znanej przez platformę. false jeśli dobrze jest odzyskać kulturę składaną, nawet jeśli platforma nie będzie nosić dla niej danych.

Zwraca

CultureInfo

Wystąpienie kultury tylko do odczytu.

Uwagi

Domyślnie podczas próby utworzenia dowolnej kultury i podstawowej platformy (Windows NLS lub ICU) nie są przenoszone określone dane dla tej kultury, platforma spróbuje skonstruować kulturę z danymi z innych kultur lub niektórych wartości stałych.

Ustawienie predefinedOnly na true wartość spowoduje utworzenie kultury tylko wtedy, gdy platforma ma rzeczywiste dane dla tej kultury.

GetCultureInfo(String, String)

Źródło:

CultureInfo.cs

Pobiera buforowane, tylko do odczytu wystąpienie kultury. Parametry określają kulturę zainicjowaną za TextInfo pomocą obiektów i CompareInfo określonych przez inną kulturę.

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

Nazwa kultury. name nie uwzględnia wielkości liter.

altName

String

Nazwa kultury dostarczającej TextInfo obiekty i CompareInfo używane do inicjowania nameobiektu . altName nie uwzględnia wielkości liter.

Zwraca

CultureInfo

Obiekt tylko do CultureInfo odczytu.

Wyjątki

ArgumentNullException

name lub altName ma wartość null.

CultureNotFoundException

name lub altName określa kulturę, która nie jest obsługiwana. Aby uzyskać więcej informacji, zobacz sekcję Uwagi do osób wywołujących.

Uwagi

Aby uzyskać listę wstępnie zdefiniowanych nazw kultur w systemach Windows, zobacz kolumnę Tag języka na liście nazw języków/regionów obsługiwanych przez system Windows. Nazwy kultur są zgodne ze standardem zdefiniowanym przez BCP 47. Ponadto, począwszy od Windows 10, name może być dowolnym prawidłowym tagiem języka BCP-47.

Metoda GetCultureInfo uzyskuje buforowany obiekt tylko do CultureInfo odczytu. Zapewnia lepszą wydajność niż odpowiednie wywołanie konstruktora CultureInfo . Metoda służy do tworzenia kultury podobnej do określonej przez name parametr , ale z różnymi regułami sortowania i wielkości liter.

Jeśli name lub altName jest nazwą bieżącej kultury, zwrócone obiekty nie odzwierciedlają żadnych przesłonięć użytkownika. Jeśli name parametr ma String.Emptywartość , metoda zwraca niezmienną kulturę. Jest to odpowiednik pobierania wartości InvariantCulture właściwości. Jeśli altName parametr ma String.Emptywartość , metoda używa systemu pisania i reguł porównania określonych przez niezmienną kulturę.

Uwagi dotyczące wywoływania

.NET Framework wersji 3.5 i starszych zgłaszają ArgumentException wartość , jeśli name lub altName nie jest prawidłową nazwą kultury. Począwszy od .NET Framework 4, ta metoda zgłasza błąd CultureNotFoundException. Począwszy od aplikacji uruchamianych w systemie .NET Framework 4 lub nowszym w systemie Windows 7 lub nowszym, metoda próbuje pobrać CultureInfo obiekt, którego identyfikator pochodzi name z systemu operacyjnego; jeśli system operacyjny nie obsługuje tej kultury, a jeśli name nie jest nazwą kultury dodatkowej lub zastępczej, metoda zgłasza CultureNotFoundException wyjątek.

Na platformie .NET 6 i nowszych wersjach CultureNotFoundException jest zgłaszana wartość , jeśli aplikacja jest uruchomiona w środowisku, w którym włączono tryb niezmienny globalizacji, na przykład niektóre kontenery platformy Docker i kulturę inną niż określona jest niezmienna kultura.

Zobacz też

• Name
• ClearCachedData()

GetCultureInfo(Int32)

Źródło:

CultureInfo.cs

Pobiera buforowane wystąpienie kultury tylko do odczytu przy użyciu określonego identyfikatora kultury.

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

Identyfikator ustawień regionalnych (LCID).

Zwraca

CultureInfo

Obiekt tylko do CultureInfo odczytu.

Wyjątki

ArgumentOutOfRangeException

Parametr culture ma wartość niższą niż zero.

CultureNotFoundException

culture określa kulturę, która nie jest obsługiwana. Aby uzyskać więcej informacji, zobacz sekcję Uwagi do elementu wywołującego.

Uwagi

Zalecamy użycie przeciążenia ciągu tej metody (GetCultureInfo(String)), ponieważ nazwy ustawień regionalnych powinny być używane zamiast identyfikatorów LCID. W przypadku ustawień regionalnych niestandardowych wymagana jest nazwa ustawień regionalnych.

Jeśli culture jest identyfikatorem ustawień regionalnych bieżącej kultury, zwrócony CultureInfo obiekt nie odzwierciedla żadnych przesłonięć użytkownika.

Uwagi dotyczące wywoływania

.NET Framework wersji 3.5 i starszych zgłaszają ArgumentException wartość , jeśli culture nie jest prawidłowym identyfikatorem kultury. Począwszy od .NET Framework 4, ta metoda zgłasza błąd CultureNotFoundException. Począwszy od aplikacji uruchamianych w systemie .NET Framework 4 lub nowszym w systemie Windows 7 lub nowszym, metoda próbuje pobrać CultureInfo obiekt, którego identyfikator pochodzi culture z systemu operacyjnego; jeśli system operacyjny nie obsługuje tej kultury, metoda zgłasza błąd CultureNotFoundException.

Na platformie .NET 6 i nowszych wersjach CultureNotFoundException jest zgłaszana wartość , jeśli aplikacja jest uruchomiona w środowisku, w którym włączono tryb niezmienny globalizacji, na przykład niektóre kontenery platformy Docker i kulturę inną niż określona jest niezmienna kultura.

Zobacz też

• LCID
• ClearCachedData()

GetCultureInfo(String)

Źródło:

CultureInfo.cs

Pobiera buforowane wystąpienie kultury tylko do odczytu przy użyciu określonej nazwy kultury.

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

Nazwa kultury. name nie uwzględnia wielkości liter.

Zwraca

CultureInfo

Obiekt tylko do CultureInfo odczytu.

Wyjątki

ArgumentNullException

name ma wartość null.

CultureNotFoundException

name określa kulturę, która nie jest obsługiwana. Aby uzyskać więcej informacji, zobacz sekcję Uwagi do osób wywołujących.

Uwagi

Aby uzyskać listę wstępnie zdefiniowanych nazw kultur w systemach Windows, zobacz kolumnę Tag języka na liście nazw języków/regionów obsługiwanych przez system Windows. Nazwy kultur są zgodne ze standardem zdefiniowanym przez BCP 47. Ponadto, począwszy od Windows 10, name może być dowolnym prawidłowym tagiem języka BCP-47.

Metoda GetCultureInfo pobiera buforowany obiekt tylko do CultureInfo odczytu. Zapewnia lepszą wydajność niż odpowiednie wywołanie konstruktora CultureInfo.CultureInfo(String) .

Jeśli name jest nazwą bieżącej kultury, zwrócony CultureInfo obiekt nie odzwierciedla żadnych przesłonięć użytkownika. Dzięki temu metoda jest odpowiednia dla aplikacji serwerowych lub narzędzi, które nie mają rzeczywistego konta użytkownika w systemie i które muszą wydajnie ładować wiele kultur.

Jeśli name parametr ma String.Emptywartość , metoda zwraca niezmienną kulturę. Jest to odpowiednik pobierania wartości InvariantCulture właściwości.

Uwagi dotyczące wywoływania

.NET Framework wersji 3.5 i starszych zgłaszają ArgumentException wartość , jeśli name nie jest prawidłową nazwą kultury. Począwszy od .NET Framework 4, ta metoda zgłasza błąd CultureNotFoundException. Począwszy od aplikacji uruchamianych w systemie .NET Framework 4 lub nowszym w systemie Windows 7 lub nowszym, metoda próbuje pobrać CultureInfo obiekt, którego identyfikator pochodzi name z systemu operacyjnego; jeśli system operacyjny nie obsługuje tej kultury, a jeśli name nie jest nazwą kultury dodatkowej lub zastępczej, metoda zgłasza wartość CultureNotFoundException.

Na platformie .NET 6 i nowszych wersjach CultureNotFoundException jest zgłaszana wartość , jeśli aplikacja jest uruchomiona w środowisku, w którym włączono tryb niezmienny globalizacji, na przykład niektóre kontenery platformy Docker i kulturę inną niż określona jest niezmienna kultura.

Zobacz też

• Name