DataGridView.ColumnCount Свойство

Определение

Получает или задает число столбцов, отображаемых в объекте DataGridView.

[System.ComponentModel.Browsable(false)]
public int ColumnCount { get; set; }

Значение свойства

Число столбцов, отображаемых в объекте DataGridView.

Атрибуты

Исключения

Указанное значение при настройке этого свойства меньше 0.

При задании этого свойства было указано значение для свойства DataSource.

Примеры

В следующем примере кода показано, как задать ColumnHeadersDefaultCellStyleсвойства , AutoSizeRowsMode, ColumnHeadersBorderStyle, CellBorderStyleGridColor, BackgroundColor, RowHeadersVisible, SelectionMode, ColumnCountи MultiSelect . Кроме того, в примере кода показано, как задать DataGridViewColumn.Name свойства и DataGridViewColumn.DefaultCellStyle . Чтобы запустить этот пример, вставьте код в форму, содержащую DataGridView объект с именем dataGridView1, а затем вызовите SetUpDataGridView метод из конструктора или Load обработчика событий формы. Убедитесь, что все события связаны с их обработчиками событий.

private void SetUpDataGridView()
{
    this.Controls.Add(dataGridView1);
    dataGridView1.ColumnCount = 5;
    DataGridViewCellStyle style = 
        dataGridView1.ColumnHeadersDefaultCellStyle;
    style.BackColor = Color.Navy;
    style.ForeColor = Color.White;
    style.Font = new Font(dataGridView1.Font, FontStyle.Bold);

    dataGridView1.EditMode = DataGridViewEditMode.EditOnEnter;
    dataGridView1.Name = "dataGridView1";
    dataGridView1.Location = new Point(8, 8);
    dataGridView1.Size = new Size(500, 300);
    dataGridView1.AutoSizeRowsMode = 
        DataGridViewAutoSizeRowsMode.DisplayedCellsExceptHeaders;
    dataGridView1.ColumnHeadersBorderStyle = 
        DataGridViewHeaderBorderStyle.Raised;
    dataGridView1.CellBorderStyle = DataGridViewCellBorderStyle.Single;
    dataGridView1.GridColor = SystemColors.ActiveBorder;
    dataGridView1.RowHeadersVisible = false;

    dataGridView1.Columns[0].Name = "Release Date";
    dataGridView1.Columns[1].Name = "Track";
    dataGridView1.Columns[1].DefaultCellStyle.Alignment = 
        DataGridViewContentAlignment.MiddleCenter;
    dataGridView1.Columns[2].Name = "Title";
    dataGridView1.Columns[3].Name = "Artist";
    dataGridView1.Columns[4].Name = "Album";

    // Make the font italic for row four.
    dataGridView1.Columns[4].DefaultCellStyle.Font = new Font(DataGridView.DefaultFont, FontStyle.Italic);

    dataGridView1.SelectionMode = DataGridViewSelectionMode.FullRowSelect;
    dataGridView1.MultiSelect = false;

    dataGridView1.BackgroundColor = Color.Honeydew;

    dataGridView1.Dock = DockStyle.Fill;

    dataGridView1.CellFormatting += new DataGridViewCellFormattingEventHandler(dataGridView1_CellFormatting);
    dataGridView1.CellParsing += new DataGridViewCellParsingEventHandler(dataGridView1_CellParsing);
    addNewRowButton.Click += new EventHandler(addNewRowButton_Click);
    deleteRowButton.Click += new EventHandler(deleteRowButton_Click);
    ledgerStyleButton.Click += new EventHandler(ledgerStyleButton_Click);
    dataGridView1.CellValidating += new DataGridViewCellValidatingEventHandler(dataGridView1_CellValidating);
}

Комментарии

ColumnCount Установка для свойства значения 0 приведет к удалению DataGridViewвсех столбцов из .

Если ColumnCount значение сбрасывается до значения меньше текущего, столбцы будут удалены из конца Columns коллекции. Если ColumnCount задано значение больше текущего, столбцы будут добавлены в конец Columns коллекции.

Это свойство можно использовать вместе со свойством RowCount , чтобы создать простой DataGridView объект для отображения и редактирования текста.

Дополнительные сведения об обработке событий см. в разделе Обработка и вызов событий.

Применяется к

Продукт Версии
.NET Framework 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
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

См. также раздел