CultureInfo.GetCultureInfo Metoda

Definicja

Pobiera buforowane wystąpienie tylko do odczytu kultury.Retrieves a cached, read-only instance of a culture.

Przeciążenia

GetCultureInfo(String, Boolean)
GetCultureInfo(String, String)

Pobiera buforowane wystąpienie tylko do odczytu kultury.Retrieves a cached, read-only instance of a culture. Parametry określają kulturę, która jest inicjowana przy użyciu TextInfo i CompareInfo obiektów określonych przez inną kulturę.Parameters specify a culture that is initialized with the TextInfo and CompareInfo objects specified by another culture.

GetCultureInfo(Int32)

Pobiera buforowane wystąpienie tylko do odczytu kultury przy użyciu określonego identyfikatora kultury.Retrieves a cached, read-only instance of a culture by using the specified culture identifier.

GetCultureInfo(String)

Pobiera buforowane wystąpienie tylko do odczytu kultury przy użyciu określonej nazwy kultury.Retrieves a cached, read-only instance of a culture using the specified culture name.

GetCultureInfo(String, Boolean)

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
predefinedOnly
Boolean

Zwraca

CultureInfo

GetCultureInfo(String, String)

Pobiera buforowane wystąpienie tylko do odczytu kultury.Retrieves a cached, read-only instance of a culture. Parametry określają kulturę, która jest inicjowana przy użyciu TextInfo i CompareInfo obiektów określonych przez inną kulturę.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

Nazwa kultury.The name of a culture. w name nie jest rozróżniana wielkość liter.name is not case-sensitive.

altName
String

Nazwa kultury, która dostarcza TextInfo i CompareInfo obiektów używanych do inicjowania name.The name of a culture that supplies the TextInfo and CompareInfo objects used to initialize name. w altName nie jest rozróżniana wielkość liter.altName is not case-sensitive.

Zwraca

CultureInfo

Obiekt CultureInfo tylko do odczytu.A read-only CultureInfo object.

Wyjątki

name lub altName ma wartość null.name or altName is null.

name lub altName określa kulturę, która nie jest obsługiwana.name or altName specifies a culture that is not supported. Więcej informacji można znaleźć w sekcji Uwagi dotyczące wywoływania.See the Notes to Callers section for more information.

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.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. Nazwy kultur są zgodne ze standardem zdefiniowanym przez BCP 47.Culture names follow the standard defined by BCP 47. Ponadto począwszy od systemu Windows 10, name może być dowolnym prawidłowym tagiem języka BCP-47.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

Metoda GetCultureInfo uzyskuje buforowany obiekt CultureInfo tylko do odczytu.The GetCultureInfo method obtains a cached, read-only CultureInfo object. Zapewnia lepszą wydajność niż odpowiednie wywołanie konstruktora CultureInfo.It offers better performance than a corresponding call to a CultureInfo constructor. Metoda jest używana do tworzenia kultury podobnej do określonej przez parametr name, ale z różnymi regułami sortowania i wielkości liter.The method is used to create a culture similar to that specified by the name parameter, but with different sorting and casing rules.

Jeśli name lub altName jest nazwą bieżącej kultury, zwracane obiekty nie odzwierciedlają żadnych zastąpień użytkownika.If name or altName is the name of the current culture, the returned objects do not reflect any user overrides. Jeśli name jest String.Empty, metoda zwraca niezmienną kulturę.If name is String.Empty, the method returns the invariant culture. Jest to równoznaczne z pobraniem wartości właściwości InvariantCulture.This is equivalent to retrieving the value of the InvariantCulture property. Jeśli altName jest String.Empty, metoda używa systemu pisania i reguł porównania określonych przez niezmienną kulturę.If altName is String.Empty, the method uses the writing system and comparison rules specified by the invariant culture.

Uwagi dotyczące wywoływania

.NET Framework 3.5.NET Framework 3.5 i wcześniejsze wersje zgłaszają ArgumentException, jeśli name lub altName nie jest prawidłową nazwą kultury.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. Począwszy od Program .NET Framework 4.NET Framework 4, ta metoda zgłasza CultureNotFoundException.Starting with the Program .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. Począwszy od aplikacji uruchamianych w Program .NET Framework 4.NET Framework 4 lub nowszych w systemie Windows 7 lub nowszym, metoda próbuje pobrać obiekt CultureInfo, którego identyfikator jest 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 wyjątek CultureNotFoundException.Starting with apps that run under the Program .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. Począwszy od aplikacji uruchamianych w Program .NET Framework 4.NET Framework 4 lub nowszych w systemie Windows 7 lub nowszym, metoda próbuje pobrać obiekt CultureInfo, którego identyfikator jest 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 wyjątek CultureNotFoundException.Starting with apps that run under the Program .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.

Zobacz też

GetCultureInfo(Int32)

Pobiera buforowane wystąpienie tylko do odczytu kultury przy użyciu określonego identyfikatora kultury.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

Identyfikator ustawień regionalnych (LCID).A locale identifier (LCID).

Zwraca

CultureInfo

Obiekt CultureInfo tylko do odczytu.A read-only CultureInfo object.

Wyjątki

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

culture określa kulturę, która nie jest obsługiwana.culture specifies a culture that is not supported. Aby uzyskać więcej informacji, zobacz sekcję Uwagi do obiektu wywołującego.See the Notes to Caller section for more information.

Uwagi

Zalecamy używanie przeciążenia ciągów tej metody (GetCultureInfo(String)), ponieważ zamiast identyfikatorów LCID należy używać nazw ustawień regionalnych.We recommend that you use the string overload of this method (GetCultureInfo(String)), because locale names should be used instead of LCIDs. W przypadku niestandardowych ustawień regionalnych wymagana jest nazwa ustawienia regionalnego.For custom locales, the locale name is required.

Jeśli culture jest identyfikatorem ustawień regionalnych bieżącej kultury, zwracany obiekt CultureInfo nie uwzględnia żadnych zastąpień użytkownika.If culture is the locale identifier of the current culture, the returned CultureInfo object does not reflect any user overrides.

Uwagi dotyczące wywoływania

.NET Framework 3.5.NET Framework 3.5 i wcześniejsze wersje zgłaszają ArgumentException, jeśli culture nie jest prawidłowym identyfikatorem kultury.The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if culture is not a valid culture identifier. Począwszy od Program .NET Framework 4.NET Framework 4, ta metoda zgłasza CultureNotFoundException.Starting with the Program .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. Począwszy od aplikacji uruchamianych w Program .NET Framework 4.NET Framework 4 lub nowszych w systemie Windows 7 lub nowszym, metoda próbuje pobrać obiekt CultureInfo, którego identyfikator jest culture z systemu operacyjnego; Jeśli system operacyjny nie obsługuje tej kultury, metoda zgłasza CultureNotFoundException.Starting with apps that run under the Program .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.

Zobacz też

GetCultureInfo(String)

Pobiera buforowane wystąpienie tylko do odczytu kultury przy użyciu określonej nazwy kultury.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

Nazwa kultury.The name of a culture. w name nie jest rozróżniana wielkość liter.name is not case-sensitive.

Zwraca

CultureInfo

Obiekt CultureInfo tylko do odczytu.A read-only CultureInfo object.

Wyjątki

name ma wartość null.name is null.

name określa kulturę, która nie jest obsługiwana.name specifies a culture that is not supported. Więcej informacji można znaleźć w sekcji Uwagi dotyczące wywoływania.See the Notes to Callers section for more information.

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.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. Nazwy kultur są zgodne ze standardem zdefiniowanym przez BCP 47.Culture names follow the standard defined by BCP 47. Ponadto począwszy od systemu Windows 10, name może być dowolnym prawidłowym tagiem języka BCP-47.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

Metoda GetCultureInfo pobiera buforowany obiekt CultureInfo tylko do odczytu.The GetCultureInfo method retrieves a cached, read-only CultureInfo object. Zapewnia lepszą wydajność niż odpowiednie wywołanie konstruktora CultureInfo.CultureInfo(String).It offers better performance than a corresponding call to the CultureInfo.CultureInfo(String) constructor.

Jeśli name jest nazwą bieżącej kultury, zwracany obiekt CultureInfo nie odzwierciedla żadnych zastąpień użytkownika.If name is the name of the current culture, the returned CultureInfo object does not reflect any user overrides. Dzięki temu Metoda jest odpowiednia dla aplikacji serwera lub narzędzi, które nie mają rzeczywistego konta użytkownika w systemie i które muszą ładować wiele kultur wydajnie.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.

Jeśli name jest String.Empty, metoda zwraca niezmienną kulturę.If name is String.Empty, the method returns the invariant culture. Jest to równoznaczne z pobraniem wartości właściwości InvariantCulture.This is equivalent to retrieving the value of the InvariantCulture property.

Uwagi dotyczące wywoływania

.NET Framework 3.5.NET Framework 3.5 i wcześniejsze wersje zgłaszają ArgumentException, jeśli name nie jest prawidłową nazwą kultury.The .NET Framework 3.5.NET Framework 3.5 and earlier versions throw an ArgumentException if name is not a valid culture name. Począwszy od Program .NET Framework 4.NET Framework 4, ta metoda zgłasza CultureNotFoundException.Starting with the Program .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. Począwszy od aplikacji uruchamianych w Program .NET Framework 4.NET Framework 4 lub nowszych w systemie Windows 7 lub nowszym, metoda próbuje pobrać obiekt CultureInfo, którego identyfikator jest 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łosi CultureNotFoundException.Starting with apps that run under the Program .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.

Zobacz też

Dotyczy