CultureInfo.GetCultureInfo Yöntem

Tanım

Ad Alanı:

System.Globalization

Bütünleştirilmiş Kod:

System.Runtime.dll

Bir kültürün önbelleğe alınmış, salt okunur bir örneğini alır.

Aşırı Yüklemeler

GetCultureInfo(String, Boolean)	Bir kültürün önbelleğe alınmış, salt okunur bir örneğini alır.
GetCultureInfo(String, String)	Bir kültürün önbelleğe alınmış, salt okunur bir örneğini alır. Parametreler, başka bir kültür tarafından belirtilen ve CompareInfo nesneleriyle TextInfo başlatılan bir kültür belirtir.
GetCultureInfo(Int32)	Belirtilen kültür tanımlayıcısını kullanarak bir kültürün önbelleğe alınmış, salt okunur bir örneğini alır.
GetCultureInfo(String)	Belirtilen kültür adını kullanarak bir kültürün önbelleğe alınmış, salt okunur bir örneğini alır.

GetCultureInfo(String, Boolean)

Kaynak:

CultureInfo.cs

Bir kültürün önbelleğe alınmış, salt okunur bir örneğini alır.

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

Parametreler

name

String

Bir kültürün adı. Büyük/küçük harfe duyarlı değildir.

predefinedOnly

Boolean

true platform tarafından bilinen bir kültürün örneğini oluşturmak istiyorsa. false platform bu kültür için veri taşımasa bile bir uydurma kültüre yeniden davranmanın bir sakıncası yoksa.

Döndürülenler

CultureInfo

Bir kültürün salt okunur örneği.

Açıklamalar

Varsayılan olarak, herhangi bir kültür oluşturmaya çalışırken ve temel alınan platform (Windows NLS veya ICU) bu kültür için belirli verileri taşımazsa, platform başka kültürlerden veya bazı sabit değerlerden gelen verilerle bir kültür oluşturmayı dener.

ayarı predefinedOnlytrue , yalnızca platformun bu kültür için gerçek verilere sahip olması durumunda bir kültürün oluşturulmasını sağlar.

GetCultureInfo(String, String)

Kaynak:

CultureInfo.cs

Bir kültürün önbelleğe alınmış, salt okunur bir örneğini alır. Parametreler, başka bir kültür tarafından belirtilen ve CompareInfo nesneleriyle TextInfo başlatılan bir kültür belirtir.

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

Parametreler

name

String

Bir kültürün adı. name büyük/küçük harfe duyarlı değildir.

altName

String

başlatmak nameiçin kullanılan ve CompareInfo nesnelerini sağlayan bir kültürün TextInfo adı. altName büyük/küçük harfe duyarlı değildir.

Döndürülenler

CultureInfo

Salt CultureInfo okunur bir nesne.

Özel durumlar

ArgumentNullException

name veya altName null.

CultureNotFoundException

name veya altName desteklenmeyen bir kültür belirtir. Daha fazla bilgi için Arayanlara Notlar bölümüne bakın.

Açıklamalar

Windows sistemlerinde önceden tanımlanmış kültür adlarının listesi için Windows tarafından desteklenen dil/bölge adları listesindeki Diletiketi sütununa bakın. Kültür adları BCP 47 tarafından tanımlanan standarda uyar. Ayrıca, Windows 10'dan başlayarak herhangi name bir geçerli BCP-47 dil etiketi olabilir.

GetCultureInfo yöntemi önbelleğe alınmış, salt CultureInfo okunur bir nesne alır. Oluşturucuya karşılık gelen çağrıdan daha iyi performans CultureInfo sunar. yöntemi, parametresi tarafından name belirtilene benzer ancak farklı sıralama ve büyük/küçük harf kurallarıyla bir kültür oluşturmak için kullanılır.

veya altName geçerli kültürün adıysaname, döndürülen nesneler kullanıcı geçersiz kılmalarını yansıtmaz. ise nameString.Emptyyöntemi sabit kültürü döndürür. Bu, özelliğin değerini almaya eşdeğerdir InvariantCulture . ise altNameString.Emptyyöntemi, sabit kültür tarafından belirtilen yazma sistemini ve karşılaştırma kurallarını kullanır.

Arayanlara Notlar

.NET Framework 3.5 ve önceki sürümler geçerli bir ArgumentException kültür adıysa name veya altName değilse oluşturur. .NET Framework 4'den başlayarak, bu yöntem bir CultureNotFoundExceptionoluşturur. Windows 7 veya sonraki sürümlerde .NET Framework 4 veya sonraki bir sürümüyle çalışan uygulamalardan başlayarak, yöntem tanımlayıcısı name işletim sisteminden olan bir CultureInfo nesneyi almaya çalışır; işletim sistemi bu kültürü desteklemiyorsa ve ek veya değiştirme kültürünün adı değilsename, yöntem bir CultureNotFoundException özel durum oluşturur.

.NET 6 ve sonraki sürümlerde, CultureNotFoundException uygulama genelleştirme sabit modunun etkinleştirildiği bir ortamda çalışıyorsa , örneğin, bazı Docker kapsayıcıları ve sabit kültür dışında bir kültür belirtilir.

Ayrıca bkz.

• Name
• ClearCachedData()

GetCultureInfo(Int32)

Kaynak:

CultureInfo.cs

Belirtilen kültür tanımlayıcısını kullanarak bir kültürün önbelleğe alınmış, salt okunur bir örneğini alır.

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

Parametreler

culture

Int32

Yerel ayar tanımlayıcısı (LCID).

Döndürülenler

CultureInfo

Salt CultureInfo okunur bir nesne.

Özel durumlar

ArgumentOutOfRangeException

culture, sıfırdan küçüktür.

CultureNotFoundException

culture desteklenmeyen bir kültür belirtir. Daha fazla bilgi için Arayana Notlar bölümüne bakın.

Açıklamalar

LCID'ler yerine yerel ayar adları kullanılması gerektiğinden, bu yöntemin ()GetCultureInfo(String) dize aşırı yüklemesini kullanmanızı öneririz. Özel yerel ayarlar için yerel ayar adı gereklidir.

Geçerli kültürün yerel ayar tanımlayıcısı ise culture , döndürülen CultureInfo nesne kullanıcı geçersiz kılmalarını yansıtmaz.

Arayanlara Notlar

.NET Framework 3.5 ve önceki sürümleri geçerli bir kültür tanımlayıcısı değilse culture bir ArgumentException oluşturur. .NET Framework 4'den başlayarak, bu yöntem bir CultureNotFoundExceptionoluşturur. Windows 7 veya sonraki sürümlerinde .NET Framework 4 veya sonraki bir sürümü altında çalışan uygulamalardan başlayarak, yöntemi tanımlayıcısı culture işletim sisteminden olan bir CultureInfo nesneyi almaya çalışır; işletim sistemi bu kültürü desteklemiyorsa, yöntemi bir CultureNotFoundExceptionoluşturur.

.NET 6 ve sonraki sürümlerde, CultureNotFoundException uygulama genelleştirme sabit modunun etkinleştirildiği bir ortamda çalışıyorsa , örneğin, bazı Docker kapsayıcıları ve sabit kültür dışında bir kültür belirtilir.

Ayrıca bkz.

• LCID
• ClearCachedData()

GetCultureInfo(String)

Kaynak:

CultureInfo.cs

Belirtilen kültür adını kullanarak bir kültürün önbelleğe alınmış, salt okunur bir örneğini alır.

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

Parametreler

name

String

Bir kültürün adı. name büyük/küçük harfe duyarlı değildir.

Döndürülenler

CultureInfo

Salt CultureInfo okunur bir nesne.

Özel durumlar

ArgumentNullException

name null değeridir.

CultureNotFoundException

name desteklenmeyen bir kültür belirtir. Daha fazla bilgi için Arayanlara Notlar bölümüne bakın.

Açıklamalar

Windows sistemlerinde önceden tanımlanmış kültür adlarının listesi için Windows tarafından desteklenen dil/bölge adları listesindeki Diletiketi sütununa bakın. Kültür adları BCP 47 tarafından tanımlanan standarda uyar. Ayrıca, Windows 10'dan başlayarak herhangi name bir geçerli BCP-47 dil etiketi olabilir.

GetCultureInfo yöntemi önbelleğe alınmış, salt CultureInfo okunur bir nesneyi alır. Oluşturucuya CultureInfo.CultureInfo(String) karşılık gelen bir çağrıdan daha iyi performans sunar.

Geçerli kültürün adıysa name , döndürülen CultureInfo nesne kullanıcı geçersiz kılmalarını yansıtmaz. Bu yöntem, sistemde gerçek bir kullanıcı hesabı olmayan ve birden çok kültürü verimli bir şekilde yüklemesi gereken sunucu uygulamaları veya araçları için uygun hale getirir.

ise nameString.Emptyyöntemi sabit kültürü döndürür. Bu, özelliğin değerini almaya eşdeğerdir InvariantCulture .

Arayanlara Notlar

.NET Framework 3.5 ve önceki sürümler geçerli bir kültür adı değilse name bir ArgumentException oluşturur. .NET Framework 4'den başlayarak, bu yöntem bir CultureNotFoundExceptionoluşturur. Windows 7 veya sonraki sürümlerinde .NET Framework 4 veya sonraki bir sürümüyle çalışan uygulamalardan başlayarak, yöntem tanımlayıcısı name işletim sisteminden olan bir CultureInfo nesneyi almaya çalışır; işletim sistemi bu kültürü desteklemiyorsa ve ek veya değiştirme kültürünün adı değilsename, yöntemi bir CultureNotFoundExceptionoluşturur.

.NET 6 ve sonraki sürümlerde, CultureNotFoundException uygulama genelleştirme sabit modunun etkinleştirildiği bir ortamda çalışıyorsa , örneğin, bazı Docker kapsayıcıları ve sabit kültür dışında bir kültür belirtilir.

Ayrıca bkz.

• Name