Thread.CurrentCulture Propriété

Définition

Espace de noms:

System.Threading

Assemblys:

netstandard.dll, System.Threading.Thread.dll

Source:

Thread.cs

Obtient ou définit la culture du thread actuel.

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

Valeur de propriété

CultureInfo

Objet qui représente la culture du thread actuel.

Exceptions

ArgumentNullException

La propriété est définie sur null.

InvalidOperationException

.NET Core et .NET 5+ uniquement : la lecture ou l’écriture de la culture d’un thread à partir d’un autre thread n’est pas prise en charge.

Exemples

L’exemple suivant montre l’instruction de thread qui permet à l’interface utilisateur d’une application Windows Forms d’afficher dans la culture définie dans le Panneau de configuration. Un code supplémentaire est nécessaire.

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

Remarques

Objet CultureInfo retourné par cette propriété, ainsi que ses objets associés, déterminez le format par défaut pour les dates, les heures, les nombres, les valeurs monétaires, l’ordre de tri du texte, les conventions de casse et les comparaisons de chaînes. Consultez la CultureInfo classe pour en savoir plus sur les noms et les identificateurs de culture, les différences entre les cultures invariantes, neutres et spécifiques et la façon dont les informations de culture affectent les threads et les domaines d’application. Consultez la CultureInfo.CurrentCulture propriété pour savoir comment la culture par défaut d’un thread est déterminée et comment les utilisateurs définissent des informations de culture pour leurs ordinateurs.

Important

La CurrentCulture propriété ne fonctionne pas de manière fiable lorsqu’elle est utilisée avec un thread autre que le thread actuel. Dans .NET Framework, la lecture de la propriété est fiable, même si la définition d’un thread autre que le thread actuel n’est pas. Sur .NET Core, une InvalidOperationException exception est levée si un thread tente de lire ou d’écrire la CurrentCulture propriété sur un autre thread. Nous vous recommandons d’utiliser la CultureInfo.CurrentCulture propriété pour récupérer et définir la culture actuelle.

À compter du .NET Framework 4, vous pouvez définir la CurrentCulture propriété sur une culture neutre. Cela est dû au fait que le comportement de la CultureInfo classe a changé : lorsqu’elle représente une culture neutre, ses valeurs de propriété (en particulier, les propriétés , le Calendar, CompareInfoDateTimeFormat, NumberFormatet TextInfo les propriétés) reflètent désormais la culture spécifique associée à la culture neutre. Dans les versions antérieures du .NET Framework, la CurrentCulture propriété a levé une exception lorsqu’une NotSupportedException culture neutre a été affectée.