DataTable.Locale Property

Definition

Gets or sets the locale information used to compare strings within the table.

public System.Globalization.CultureInfo Locale { get; set; }
[System.Data.DataSysDescription("DataTableLocaleDescr")]
public System.Globalization.CultureInfo Locale { get; set; }

Property Value

A CultureInfo that contains data about the user's machine locale. The default is the DataSet object's CultureInfo (returned by the Locale property) to which the DataTable belongs; if the table doesn't belong to a DataSet, the default is the current system CultureInfo.

Attributes

Examples

The following example sets the CultureInfo through the Locale and prints the ISO language name.

private void ChangeCultureInfo(DataTable table)
{
    // Print the LCID  of the present CultureInfo.
    Console.WriteLine(table.Locale.LCID);

    // Create a new CultureInfo for the United Kingdom.
    CultureInfo myCultureInfo = new CultureInfo("en-gb");
    table.Locale = myCultureInfo;

    // Print the new LCID.
    Console.WriteLine(table.Locale.LCID);
}

Remarks

A CultureInfo represents the software preferences of a particular culture or community.

When used for string comparisons, the CultureInfo affects sorting, comparisons, and filtering.

Note

In columns that contain expressions, the InvariantCulture is used. The CurrentCulture is ignored.

Applies to

Product Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

See also