Aracılığıyla paylaş


CultureInfo Oluşturucular

Tanım

CultureInfo sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

CultureInfo(Int32)

Kültür tanımlayıcısı CultureInfo tarafından belirtilen kültüre göre sınıfının yeni bir örneğini başlatır.

CultureInfo(String)

Adıyla belirtilen kültüre göre sınıfının yeni bir örneğini CultureInfo başlatır.

CultureInfo(Int32, Boolean)

Kültür tanımlayıcısı CultureInfo tarafından belirtilen kültüre ve Windows'dan kullanıcı tarafından seçilen kültür ayarlarının kullanılıp kullanılmayacağını belirten bir değere göre sınıfının yeni bir örneğini başlatır.

CultureInfo(String, Boolean)

Adıyla belirtilen kültüre ve Windows'dan kullanıcı tarafından seçilen kültür ayarlarının kullanılıp kullanılmayacağını belirten bir değere göre sınıfının yeni bir örneğini CultureInfo başlatır.

CultureInfo(Int32)

Kaynak:
CultureInfo.cs
Kaynak:
CultureInfo.cs
Kaynak:
CultureInfo.cs

Kültür tanımlayıcısı CultureInfo tarafından belirtilen kültüre göre sınıfının yeni bir örneğini başlatır.

public:
 CultureInfo(int culture);
public CultureInfo (int culture);
new System.Globalization.CultureInfo : int -> System.Globalization.CultureInfo
Public Sub New (culture As Integer)

Parametreler

culture
Int32

Önceden tanımlanmış CultureInfo tanımlayıcı, LCID var olan CultureInfo bir nesnenin özelliği veya Yalnızca Windows kültür tanımlayıcısı.

Özel durumlar

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

culture geçerli bir kültür tanımlayıcısı değil. Daha fazla bilgi için Arayanlara Notlar bölümüne bakın.

Açıklamalar

Windows sisteminde kullanılabilen kültürler için önceden tanımlanmış kültür tanımlayıcıları, Windows tarafından desteklenen dil/bölge adları listesindekiDil etiketi sütununda listelenir. Kültür adları BCP 47 tarafından tanımlanan standarda uyar.

Çoğu culture durumda, parametresi ilgili Ulusal Dil Desteği (NLS) yerel ayar tanımlayıcısına eşlenir. parametresinin culture değeri, yeni CultureInfoözelliğinin LCID değeri olur.

Yerel ayar adları LCID'ler için tercih edildiğinden yerel ayar adı oluşturucuyu CultureInfo.CultureInfoçağırmanızı öneririz. Özel yerel ayarlar için bir yerel ayar adı gereklidir.

Kullanıcı, Denetim Masası'nın bölgesel ve dil seçenekleri bölümü aracılığıyla geçerli Windows kültürüyle ilişkili bazı değerleri geçersiz kılmayı seçebilir. Örneğin, kullanıcı tarihi farklı bir biçimde görüntülemeyi veya kültür için varsayılandan farklı bir para birimi kullanmayı seçebilir. Belirtilen kültür tanımlayıcısı geçerli Windows kültürünün kültür tanımlayıcısı ile eşleşiyorsa, bu oluşturucu özelliği tarafından döndürülen örneğin özellikleri DateTimeFormatInfo için kullanıcı ayarları ve özelliği tarafından DateTimeFormat döndürülen NumberFormat örneğin özellikleri NumberFormatInfo de dahil olmak üzere bu geçersiz kılmaları kullanan bir CultureInfo oluşturur. Kullanıcı ayarları ile ilişkili kültürle CultureInfo uyumsuzsa (örneğin, seçilen takvim bunlardan OptionalCalendarsbiri değilse) yöntemlerin sonuçları ve özelliklerin değerleri tanımlanmamıştır.

Belirtilen kültür tanımlayıcısı geçerli Windows kültürünün tanımlayıcısı ile eşleşmiyorsa, bu oluşturucu belirtilen kültür için varsayılan değerleri kullanan bir CultureInfo oluşturur.

UseUserOverride özelliği her zaman olarak trueayarlanır.

Örneğin, Geçerli Windows kültürü Arapça (Suudi Arabistan) olduğunu ve kullanıcının Hicri olan takvimi Gregoryen olarak değiştirdiğini varsayalım.

Euro kullanan kültürler için.NET Framework ve Windows XP varsayılan para birimini Euro olarak ayarlar. Ancak, Windows'un eski sürümleri bunu yapmaz. Bu nedenle, Windows'un eski bir sürümünün kullanıcısı Denetim Masası'nın bölgesel ve dil seçenekleri bölümü aracılığıyla para birimi ayarını değiştirmediyse, para birimi yanlış olabilir. Para birimi için .NET Framework varsayılan ayarını kullanmak için, uygulamanın bir useUserOverride parametre kabul eden bir CultureInfo oluşturucu aşırı yüklemesi kullanması ve bunu olarak falseayarlaması gerekir.

Not

Geriye dönük uyumluluk için, 0x0004 veya 0x7c04 parametresi kullanılarak culture inşa edilen bir Name kültür sırasıyla veya zh-CHTözelliğine zh-CHS sahip olur. Bunun yerine, eski adları kullanmak için bir nedeniniz yoksa, veya geçerli standart kültür adlarını zh-Hanszh-Hantkullanarak kültürü oluşturmayı tercih etmelisiniz.

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 oluşturucu bir CultureNotFoundExceptionoluşturur. Windows 7 veya sonraki sürümlerde .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ö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.

Şunlara uygulanır

CultureInfo(String)

Kaynak:
CultureInfo.cs
Kaynak:
CultureInfo.cs
Kaynak:
CultureInfo.cs

Adıyla belirtilen kültüre göre sınıfının yeni bir örneğini CultureInfo başlatır.

public:
 CultureInfo(System::String ^ name);
public CultureInfo (string name);
new System.Globalization.CultureInfo : string -> System.Globalization.CultureInfo
Public Sub New (name As String)

Parametreler

name
String

Varolan CultureInfobir veya yalnızca Windows kültür adının Name önceden tanımlanmış CultureInfo adı. name büyük/küçük harfe duyarlı değildir.

Özel durumlar

name null değeridir.

name geçerli bir kültür adı değil. Daha fazla bilgi için Arayanlara Notlar bölümüne bakın.

Örnekler

Aşağıdaki örnek geçerli kültürü alır. Fransız (Fransa) kültüründen başka bir şeyse, oluşturucuyu CultureInfo(String) çağırarak Fransız (Fransa) kültürünü temsil eden bir CultureInfo nesnenin örneğini oluşturur ve onu geçerli kültür yapar. Aksi takdirde, Fransız (Lüksemburg) kültürünü temsil eden bir CultureInfo nesne örneği oluşturur ve onu geçerli kültür yapar.

using System;
using System.Globalization;

public class ChangeEx1
{
    public static void Main()
    {
        CultureInfo current = CultureInfo.CurrentCulture;
        Console.WriteLine("The current culture is {0}", current.Name);
        CultureInfo newCulture;
        if (current.Name.Equals("fr-FR"))
            newCulture = new CultureInfo("fr-LU");
        else
            newCulture = new CultureInfo("fr-FR");

        CultureInfo.CurrentCulture = newCulture;
        Console.WriteLine("The current culture is now {0}",
                          CultureInfo.CurrentCulture.Name);
    }
}
// The example displays output like the following:
//     The current culture is en-US
//     The current culture is now fr-FR
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim current As CultureInfo = CultureInfo.CurrentCulture
      Console.WriteLine("The current culture is {0}", current.Name)
      Dim newCulture As CultureInfo
      If current.Name.Equals("fr-FR") Then
         newCulture = New CultureInfo("fr-LU")
      Else
         newCulture = new CultureInfo("fr-FR")
      End If

      CultureInfo.CurrentCulture = newCulture
      Console.WriteLine("The current culture is now {0}",
                        CultureInfo.CurrentCulture.Name)
   End Sub
End Module
' The example displays output like the following:
'     The current culture is en-US
'     The current culture is now fr-FR

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.

ise nameString.Empty, oluşturucu sabit kültürün bir örneğini oluşturur; bu, özelliğin InvariantCulture değerini almaya eşdeğerdir.

Kullanıcı, Denetim Masası'nın bölgesel ve dil seçenekleri bölümü aracılığıyla geçerli Windows kültürüyle ilişkili bazı değerleri geçersiz kılmayı seçebilir. Örneğin, kullanıcı tarihi farklı bir biçimde görüntülemeyi veya kültür için varsayılandan farklı bir para birimi kullanmayı seçebilir. ile name ilişkili kültür tanımlayıcısı geçerli Windows kültürünün kültür tanımlayıcısıyla eşleşiyorsa, bu oluşturucu özelliği tarafından döndürülen örneğin özellikleri için kullanıcı ayarları ve özelliği tarafından DateTimeFormatNumberFormat döndürülen örneğin özellikleri DateTimeFormatInfoNumberFormatInfo de dahil olmak üzere bu geçersiz kılmaları kullanan bir CultureInfo nesne oluşturur. Kullanıcı ayarları ile CultureInfoilişkili kültürle uyumsuzsa, örneğin, seçilen takvim öğesinden OptionalCalendarsbiri değilse, yöntemlerin sonuçları ve özelliklerin değerleri tanımlanmamıştır.

İlişkili name kültür tanımlayıcısı geçerli Windows kültürünün kültür tanımlayıcısıyla eşleşmiyorsa, bu oluşturucu belirtilen kültür için varsayılan değerleri kullanan bir CultureInfo nesne oluşturur.

UseUserOverride özelliği her zaman olarak trueayarlanır.

Örneğin, Arapça (Suudi Arabistan) uygulamasının geçerli Windows kültürü olduğunu ve kullanıcının takvimi Hicri yerine Gregoryen olarak değiştirdiğini varsayalım:

LCID Yeninin CultureInfo özelliği, belirtilen adla ilişkilendirilmiş kültür tanımlayıcısına ayarlanır.

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 oluşturucu 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.

Şunlara uygulanır

CultureInfo(Int32, Boolean)

Kaynak:
CultureInfo.cs
Kaynak:
CultureInfo.cs
Kaynak:
CultureInfo.cs

Kültür tanımlayıcısı CultureInfo tarafından belirtilen kültüre ve Windows'tan kullanıcı tarafından seçilen kültür ayarlarının kullanılıp kullanılmayacağını belirten bir değere göre sınıfının yeni bir örneğini başlatır.

public:
 CultureInfo(int culture, bool useUserOverride);
public CultureInfo (int culture, bool useUserOverride);
new System.Globalization.CultureInfo : int * bool -> System.Globalization.CultureInfo
Public Sub New (culture As Integer, useUserOverride As Boolean)

Parametreler

culture
Int32

Önceden tanımlanmış CultureInfo tanımlayıcı, LCID var olan CultureInfo bir nesnenin özelliği veya Yalnızca Windows kültür tanımlayıcısı.

useUserOverride
Boolean

true kullanıcı tarafından seçilen kültür ayarlarını kullanmak için (yalnızca Windows); false varsayılan kültür ayarlarını kullanmak için.

Özel durumlar

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

culture geçerli bir kültür tanımlayıcısı değil. Daha fazla bilgi için Arayanlara Notlar bölümüne bakın.

Açıklamalar

Windows sistemlerinde kullanılabilen önceden tanımlanmış kültür tanımlayıcıları, Windows tarafından desteklenen dil/bölge adları listesindekiDil etiketi sütununda listelenir. Kültür adları BCP 47 tarafından tanımlanan standarda uyar.

Çoğu culture durumda, parametresi ilgili Ulusal Dil Desteği (NLS) yerel ayar tanımlayıcısına eşlenir. parametresinin culture değeri, yeni CultureInfoözelliğinin LCID değeri olur.

Yerel ayar adları LCID'ler için tercih edildiğinden yerel ayar adı oluşturucuyu CultureInfo.CultureInfoçağırmanızı öneririz. Özel yerel ayarlar için bir yerel ayar adı gereklidir.

Kullanıcı, Denetim Masası'nın bölgesel ve dil seçenekleri bölümü aracılığıyla geçerli Windows kültürüyle ilişkili bazı değerleri geçersiz kılmayı seçebilir. Örneğin, kullanıcı tarihi farklı bir biçimde görüntülemeyi veya kültür için varsayılandan farklı bir para birimi kullanmayı seçebilir.

Uygulamalar genellikle kullanıcı geçersiz kılmalarına izin vermemelidir. Geçersiz kılmalara izin verilmemesi, veri kararlılığını garanti etmez. Daha fazla bilgi için kültür verilerinin kararlı olarak değerlendirilmemesi (Sabit dışında) blog girdisine bakın.

UseUserOverride özelliği olarak ayarlanırsa true ve belirtilen kültür tanımlayıcısı geçerli Windows kültürünün tanımlayıcısı ile eşleşiyorsa, bu oluşturucu özelliği tarafından döndürülen örneğin özellikleri DateTimeFormatInfo için kullanıcı ayarları ve özelliği tarafından DateTimeFormatNumberFormat döndürülen örneğin özellikleri NumberFormatInfo de dahil olmak üzere bu geçersiz kılmaları kullanan bir CultureInfo oluşturur. Kullanıcı ayarları ile CultureInfoilişkili kültürle uyumsuzsa, örneğin, seçilen takvim öğesinden OptionalCalendarsbiri değilse, yöntemlerin sonuçları ve özelliklerin değerleri tanımlanmamıştır.

Aksi takdirde, bu oluşturucu belirtilen kültür için varsayılan değerleri kullanan bir CultureInfo oluşturur.

parametresinin useUserOverride değeri özelliğin UseUserOverride değeri olur.

Örneğin, Arapça (Suudi Arabistan) uygulamasının geçerli Windows kültürü olduğunu ve kullanıcının takvimi Hicri yerine Gregoryen olarak değiştirdiğini varsayalım.

Euro kullanan kültürler için .NET Framework ve Windows XP varsayılan para birimini Euro olarak ayarlar. Ancak, Windows'un eski sürümleri bunu yapmaz. Bu nedenle, Windows'un eski bir sürümünün kullanıcısı Denetim Masası'nın bölgesel ve dil seçenekleri bölümü aracılığıyla para birimi ayarını değiştirmediyse, para birimi yanlış olabilir. Para birimi için .NET Framework varsayılan ayarını kullanmak için uygulamanın parametresini olarak falseayarlaması useUserOverride gerekir.

Not

Geriye dönük uyumluluk için, 0x0004 veya 0x7c04 parametresi kullanılarak inşa edilen bir cultureName kültür sırasıyla zh-CHS veya zh-CHT özelliğine sahip olur. Bunun yerine, eski adları kullanmak için bir nedeniniz yoksa, kültürü veya zh-Hant'ın geçerli standart kültür adlarını zh-Hans kullanarak oluşturmayı tercih etmelisiniz.

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 oluşturucu bir CultureNotFoundExceptionoluşturur. Windows 7 veya sonraki sürümlerde .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ö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.

Şunlara uygulanır

CultureInfo(String, Boolean)

Kaynak:
CultureInfo.cs
Kaynak:
CultureInfo.cs
Kaynak:
CultureInfo.cs

Adla belirtilen kültüre ve Windows'dan kullanıcı tarafından seçilen kültür ayarlarının kullanılıp kullanılmayacağını belirten bir değere göre sınıfının yeni bir örneğini CultureInfo başlatır.

public:
 CultureInfo(System::String ^ name, bool useUserOverride);
public CultureInfo (string name, bool useUserOverride);
new System.Globalization.CultureInfo : string * bool -> System.Globalization.CultureInfo
Public Sub New (name As String, useUserOverride As Boolean)

Parametreler

name
String

Varolan CultureInfobir veya yalnızca Windows kültür adının Name önceden tanımlanmış CultureInfo adı. name büyük/küçük harfe duyarlı değildir.

useUserOverride
Boolean

true kullanıcı tarafından seçilen kültür ayarlarını kullanmak için (yalnızca Windows); false varsayılan kültür ayarlarını kullanmak için.

Özel durumlar

name null değeridir.

name geçerli bir kültür adı değil. Daha fazla bilgi için Arayanlara Notlar bölümüne bakın.

Açıklamalar

Ö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 standardı izler. Ayrıca, Windows 10'dan başlayarak herhangi name bir geçerli BCP-47 dil etiketi olabilir.

ise nameString.Empty, oluşturucu sabit kültürün bir örneğini oluşturur; bu, özelliğin InvariantCulture değerini almaya eşdeğerdir.

Kullanıcı, Denetim Masası'nın bölgesel ve dil seçenekleri bölümü aracılığıyla geçerli Windows kültürüyle ilişkili bazı değerleri geçersiz kılmayı seçebilir. Örneğin, kullanıcı tarihi farklı bir biçimde görüntülemeyi veya kültür için varsayılandan farklı bir para birimi kullanmayı seçebilir.

Uygulamalar genellikle kullanıcı geçersiz kılmalarına izin vermemelidir. Geçersiz kılmalara izin verilmemesi, veri kararlılığını garanti etmez. Daha fazla bilgi için Kültür verileri kararlı olarak değerlendirilmemelidir (Sabit hariç) blog girdisine bakın.

UseUserOverride özelliği olarak ayarlanırsa true ve belirtilen kültür adıyla ilişkilendirilmiş kültür tanımlayıcısı geçerli Windows kültürünün kültür tanımlayıcısıyla eşleşiyorsa, bu oluşturucu, özelliği tarafından döndürülen örneğin özellikleri için kullanıcı ayarları ve özellik tarafından DateTimeFormatNumberFormat döndürülen örneğin özellikleri DateTimeFormatInfoNumberFormatInfo de dahil olmak üzere bu geçersiz kılmaları kullanan bir CultureInfo oluşturur. Kullanıcı ayarları ile CultureInfoilişkili kültürle uyumsuzsa, örneğin, seçilen takvim öğesinden OptionalCalendarsbiri değilse, yöntemlerin sonuçları ve özelliklerin değerleri tanımlanmamıştır.

Aksi takdirde, bu oluşturucu belirtilen kültür için varsayılan değerleri kullanan bir CultureInfo oluşturur.

parametresinin useUserOverride değeri özelliğin UseUserOverride değeri olur.

Örneğin, Arapça 'nın (Suudi Arabistan) Windows'un geçerli kültürü olduğunu ve kullanıcının takvimi Hicri'den Gregoryen olarak değiştirdiğini varsayalım.

LCID Yeni CultureInfo özelliği, belirtilen adla ilişkili kültür tanımlayıcısına ayarlanır.

Euro kullanan kültürler için .NET Framework ve Windows XP varsayılan para birimini Euro olarak ayarlar. Ancak, Windows'un eski sürümleri bunu yapmaz. Bu nedenle, Windows'un eski bir sürümünün kullanıcısı Denetim Masası'nın bölgesel ve dil seçenekleri bölümü aracılığıyla para birimi ayarını değiştirmediyse, para birimi yanlış olabilir. Para birimi için .NET Framework varsayılan ayarını kullanmak için uygulamanın parametresini olarak falseayarlaması useUserOverride gerekir.

Arayanlara Notlar

.NET Framework 3.5 ve önceki sürümler geçerli bir kültür adı değilse bir ArgumentExceptionname oluşturur. .NET Framework 4'den başlayarak, bu oluşturucu bir CultureNotFoundExceptionoluşturur. Windows 7 veya sonraki sürümlerde .NET Framework 4 veya sonraki bir sürümün altında çalışan uygulamalardan başlayarak, yöntemi 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 belirtilmişse) oluşturulur.

Ayrıca bkz.

Şunlara uygulanır