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 pomocą TextInfo obiektów i CompareInfo określonych przez inną kulturę.
GetCultureInfo(Int32)	Pobiera buforowane, tylko do odczytu wystąpienie kultury przy użyciu określonego identyfikatora kultury.
GetCultureInfo(String)	Pobiera buforowane, tylko do odczytu wystąpienie kultury 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 jest uwzględniana wielkość liter.

predefinedOnly

Boolean

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

Zwraca

CultureInfo

Wystąpienie kultury tylko do odczytu.

Uwagi

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

Ustawienie predefinedOnly w celu true zapewnienia utworzenia kultury jest tworzone 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 pomocą TextInfo 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 kultury są zgodne ze standardem zdefiniowanym przez protokół 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 jest to String.Empty, metoda zwraca niezmienną kulturę. Jest to równoważne pobieraniu wartości InvariantCulture właściwości. Jeśli altName jest String.Emptyto , metoda używa systemu pisania i reguł porównania określonych przez niezmienną kulturę.

Uwagi dotyczące wywoływania

.NET Framework 3.5 i starsze wersje zgłaszają wartość ArgumentException , 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 działających 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 jest zgłaszana wartość , jeśli aplikacja jest uruchomiona w środowisku, CultureNotFoundException 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, tylko do odczytu wystąpienie kultury 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 rozmówców.

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 3.5 i starsze wersje zgłaszają identyfikator ArgumentException kultury, 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 działających w .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 CultureNotFoundExceptionbłąd .

Na platformie .NET 6 i nowszych wersjach jest zgłaszana wartość , jeśli aplikacja jest uruchomiona w środowisku, CultureNotFoundException 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, tylko do odczytu wystąpienie kultury 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 kultury są zgodne ze standardem zdefiniowanym przez protokół 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 jest to String.Empty, metoda zwraca niezmienną kulturę. Jest to równoważne pobieraniu wartości InvariantCulture właściwości.

Uwagi dotyczące wywoływania

.NET Framework 3.5 i starsze wersje zgłaszają wartość ArgumentException , 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 CultureNotFoundExceptionbłąd .

Na platformie .NET 6 i nowszych wersjach jest zgłaszana wartość , jeśli aplikacja jest uruchomiona w środowisku, CultureNotFoundException 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