Thread.CurrentCulture Properti

Definisi

Ruang nama:

System.Threading

Rakitan:

netstandard.dll, System.Threading.Thread.dll

Sumber:

Thread.cs

Mendapatkan atau mengatur budaya untuk utas saat ini.

public:
 property System::Globalization::CultureInfo ^ CurrentCulture { System::Globalization::CultureInfo ^ get(); void set(System::Globalization::CultureInfo ^ value); };

public System.Globalization.CultureInfo CurrentCulture { get; set; }

member this.CurrentCulture : System.Globalization.CultureInfo with get, set

Public Property CurrentCulture As CultureInfo

Nilai Properti

CultureInfo

Objek yang mewakili budaya untuk utas saat ini.

Pengecualian

ArgumentNullException

Properti diatur ke null.

InvalidOperationException

.NET Core dan .NET 5+ saja: Membaca atau menulis budaya utas dari utas lain tidak didukung.

Contoh

Contoh berikut menunjukkan pernyataan utas yang memungkinkan antarmuka pengguna aplikasi Windows Forms ditampilkan dalam budaya yang diatur di Panel Kontrol. Kode tambahan diperlukan.

using System;
using System.Threading;
using System.Windows.Forms;

class UICulture : Form
{
    public UICulture()
    {
        // Set the user interface to display in the
        // same culture as that set in Control Panel.
        Thread.CurrentThread.CurrentUICulture = 
            Thread.CurrentThread.CurrentCulture;

        // Add additional code.
    }

    static void Main()
    {
        Application.Run(new UICulture());
    }
}

open System.Threading
open System.Windows.Forms

type UICulture() =
    inherit Form()

    do
        // Set the user interface to display in the
        // same culture as that set in Control Panel.
        Thread.CurrentThread.CurrentUICulture <- Thread.CurrentThread.CurrentCulture

// Add additional code.

new UICulture() |> Application.Run

Imports System.Threading
Imports System.Windows.Forms

Public Class UICulture : Inherits Form
    Sub New()

        ' Set the user interface to display in the
        ' same culture as that set in Control Panel.
        Thread.CurrentThread.CurrentUICulture = _
            Thread.CurrentThread.CurrentCulture

        ' Add additional code.
    End Sub

    Shared Sub Main()
        Application.Run(New UICulture())
    End Sub
End Class

Keterangan

Objek CultureInfo yang dikembalikan oleh properti ini, bersama dengan objek terkait, menentukan format default untuk tanggal, waktu, angka, nilai mata uang, urutan pengurutan teks, konvensi casing, dan perbandingan string. CultureInfo Lihat kelas untuk mempelajari tentang nama dan pengidentifikasi budaya, perbedaan antara budaya invarian, netral, dan spesifik, dan cara informasi budaya memengaruhi utas dan domain aplikasi. CultureInfo.CurrentCulture Lihat properti untuk mempelajari bagaimana budaya default utas ditentukan, dan bagaimana pengguna mengatur informasi budaya untuk komputer mereka.

Penting

Properti CurrentCulture tidak berfungsi dengan andal saat digunakan dengan utas apa pun selain utas saat ini. Dalam .NET Framework, membaca properti dapat diandalkan, meskipun mengaturnya untuk utas selain utas saat ini tidak. Pada .NET Core, dilemparkan InvalidOperationException jika utas mencoba membaca atau menulis CurrentCulture properti pada utas yang berbeda. Kami menyarankan agar Anda menggunakan CultureInfo.CurrentCulture properti untuk mengambil dan mengatur budaya saat ini.

Dimulai dengan .NET Framework 4, Anda dapat mengatur properti ke CurrentCulture budaya netral. Ini karena perilaku CultureInfo kelas telah berubah: Ketika mewakili budaya netral, nilai propertinya (khususnya, Calendarproperti , , CompareInfo, DateTimeFormatNumberFormat, dan TextInfo ) sekarang mencerminkan budaya spesifik yang terkait dengan budaya netral. Dalam versi .NET Framework sebelumnya, CurrentCulture properti melemparkan NotSupportedException pengecualian ketika budaya netral ditetapkan.