Практическое руководство. Форматирование данных элемента управления DataGridView в Windows Forms

Статья
10/18/2023

В следующих процедурах демонстрируется базовое форматирование значений ячеек с помощью свойства DefaultCellStyle элемента управления DataGridView и определенных столбцов в элементе управления. Дополнительные сведения о расширенном форматировании данных см. в разделе Практическое руководство. Настройка форматирования данных в элементе управления Windows Forms DataGridView.

Форматирование значений валюты и даты

Задайте свойство Format элемента DataGridViewCellStyle. В следующем примере кода задается формат для определенных столбцов с помощью свойства DefaultCellStyle столбцов. Значения в столбце UnitPrice отображаются в текущем формате валюты, зависящем от языка и региональных параметров, с отрицательными значениями, окруженными круглыми скобками. Значения в столбце ShipDate отображаются в текущем коротком формате даты, зависящем от языка и региональных параметров. Дополнительные сведения о значениях Format см. в разделе Типы форматирования.
```
this.dataGridView1.Columns["UnitPrice"].DefaultCellStyle.Format = "c";
this.dataGridView1.Columns["ShipDate"].DefaultCellStyle.Format = "d";
```
```
Me.dataGridView1.Columns("UnitPrice").DefaultCellStyle.Format = "c"
Me.dataGridView1.Columns("ShipDate").DefaultCellStyle.Format = "d"
```

Настройка отображения значений базы данных NULL

Задайте свойство NullValue элемента DataGridViewCellStyle. В следующем примере кода свойство DataGridView.DefaultCellStyle используется для отображения сообщения "no entry" (нет данных) во всех ячейках, содержащих значения, равные DBNull.Value.
```
this.dataGridView1.DefaultCellStyle.NullValue = "no entry";
```
```
Me.dataGridView1.DefaultCellStyle.NullValue = "no entry"
```

Включение перехода на новую строку в текстовых ячейках

Присвойте свойству WrapMode DataGridViewCellStyle одно из значений перечисления DataGridViewTriState. В примере кода ниже свойство DataGridView.DefaultCellStyle используется для задания режима переноса для всего элемента управления.
```
this.dataGridView1.DefaultCellStyle.WrapMode =
    DataGridViewTriState.True;
```
```
Me.dataGridView1.DefaultCellStyle.WrapMode = DataGridViewTriState.True
```

Указание выравнивания текста в ячейках DataGridView

Присвойте свойству Alignment DataGridViewCellStyle одно из значений перечисления DataGridViewContentAlignment. В следующем примере кода задается выравнивание для определенного столбца с помощью свойства DefaultCellStyle столбца.
```
this.dataGridView1.Columns["CustomerName"].DefaultCellStyle
    .Alignment = DataGridViewContentAlignment.MiddleRight;
```
```
Me.dataGridView1.Columns("CustomerName").DefaultCellStyle _
    .Alignment = DataGridViewContentAlignment.MiddleRight
```

Пример

private void SetFormatting()
{
    this.dataGridView1.Columns["UnitPrice"].DefaultCellStyle.Format = "c";
    this.dataGridView1.Columns["ShipDate"].DefaultCellStyle.Format = "d";
    this.dataGridView1.Columns["CustomerName"].DefaultCellStyle
        .Alignment = DataGridViewContentAlignment.MiddleRight;
    this.dataGridView1.DefaultCellStyle.NullValue = "no entry";
    this.dataGridView1.DefaultCellStyle.WrapMode =
        DataGridViewTriState.True;
}

Private Sub SetFormatting()
    With Me.dataGridView1
        .Columns("UnitPrice").DefaultCellStyle.Format = "c"
        .Columns("ShipDate").DefaultCellStyle.Format = "d"
        .Columns("CustomerName").DefaultCellStyle.Alignment = _
            DataGridViewContentAlignment.MiddleRight
        .DefaultCellStyle.NullValue = "no entry"
        .DefaultCellStyle.WrapMode = DataGridViewTriState.True
    End With
End Sub

Компиляция кода

Для этих примеров требуются:

Элемент управления DataGridView с именем dataGridView1, содержащий столбец с именем UnitPrice, столбец с именем ShipDate и столбец с именем CustomerName.
ссылки на сборки System, System.Drawing и System.Windows.Forms.

Отказоустойчивость

Для максимальной масштабируемости объекты DataGridViewCellStyle следует распределить по нескольким строкам, столбцам или ячейкам с одинаковыми стилями, чтобы не задавать свойства стилей для каждого элемента в отдельности. Дополнительные сведения см. в рекомендациях по масштабированию элемента управления DataGridView в Windows Forms.