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

Обновлен: Ноябрь 2007

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

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

• Задайте значение свойства Format элемента DataGridViewCellStyle. В следующем примере кода устанавливается формат определенных столбцов с помощью свойства DefaultCellStyle столбцов. Значения столбца UnitPrice отображаются в текущем формате валюты, принятом для данной страны, причем отрицательные значения заключаются в круглые скобки. Значения столбца ShipDate отображаются в текущем кратком формате даты, принятом для данной страны. Дополнительные сведения о значениях свойства Format см. в разделе Типы форматирования.

  Me.dataGridView1.Columns("UnitPrice").DefaultCellStyle.Format = "c"
  Me.dataGridView1.Columns("ShipDate").DefaultCellStyle.Format = "d"
  

  this.dataGridView1.Columns["UnitPrice"].DefaultCellStyle.Format = "c";
  this.dataGridView1.Columns["ShipDate"].DefaultCellStyle.Format = "d";
  

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

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

  Me.dataGridView1.DefaultCellStyle.NullValue = "no entry"
  

  this.dataGridView1.DefaultCellStyle.NullValue = "no entry";
  

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

• Присвойте свойству WrapMode элемента DataGridViewCellStyle одно из значений перечисления DataGridViewTriState. В следующем примере кода свойство DataGridView.DefaultCellStyle используется для задания режима переноса для всего элемента управления.

  Me.dataGridView1.DefaultCellStyle.WrapMode = DataGridViewTriState.True
  

  this.dataGridView1.DefaultCellStyle.WrapMode =
      DataGridViewTriState.True;
  

Указание способа выравнивания текста для ячеек элемента управления DataGridView

• Присвойте свойству Alignment элемента DataGridViewCellStyle одно из значений перечисления DataGridViewContentAlignment. В следующем примере кода устанавливается способ выравнивания для определенного столбца с помощью свойства DefaultCellStyle данного столбца.

  Me.dataGridView1.Columns("CustomerName").DefaultCellStyle _
      .Alignment = DataGridViewContentAlignment.MiddleRight
  

  this.dataGridView1.Columns["CustomerName"].DefaultCellStyle
      .Alignment = DataGridViewContentAlignment.MiddleRight;
  

Пример

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

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;
}

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

Для этих примеров требуются перечисленные ниже компоненты.

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

• Ссылки на сборки System, System.Drawing и System.Windows.Forms.

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

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

См. также

Задачи

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

Основные понятия

Стили ячеек элемента управления DataGridView в Windows Forms

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

Ссылки

DataGridView.DefaultCellStyle

DataGridViewBand.DefaultCellStyle

DataGridViewCellStyle

Другие ресурсы

Базовое форматирование и оформление элемента управления DataGridView в Windows Forms

Типы форматирования