CultureInfo.GetCultureInfo Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
- Źródło:
- CultureInfo.cs
- Ź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
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.
Dotyczy
GetCultureInfo(String, String)
- Źródło:
- CultureInfo.cs
- Źródło:
- CultureInfo.cs
- Ź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 name
obiektu . altName
nie uwzględnia wielkości liter.
Zwraca
Obiekt tylko do CultureInfo odczytu.
Wyjątki
name
lub altName
ma wartość null.
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ż
Dotyczy
GetCultureInfo(Int32)
- Źródło:
- CultureInfo.cs
- Źródło:
- CultureInfo.cs
- Ź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
Obiekt tylko do CultureInfo odczytu.
Wyjątki
Parametr culture
ma wartość niższą niż zero.
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ż
Dotyczy
GetCultureInfo(String)
- Źródło:
- CultureInfo.cs
- Źródło:
- CultureInfo.cs
- Ź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
Obiekt tylko do CultureInfo odczytu.
Wyjątki
name
ma wartość null.
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ż
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla