DataGridView.RowTemplate Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DataGridView.cs

Возвращает или задает строку, представляющую шаблон для всех строк в элементе управления.

public:
 property System::Windows::Forms::DataGridViewRow ^ RowTemplate { System::Windows::Forms::DataGridViewRow ^ get(); void set(System::Windows::Forms::DataGridViewRow ^ value); };

[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.DataGridViewRow RowTemplate { get; set; }

[<System.ComponentModel.Browsable(true)>]
member this.RowTemplate : System.Windows.Forms.DataGridViewRow with get, set

Public Property RowTemplate As DataGridViewRow

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

DataGridViewRow

Представляет DataGridViewRow шаблон строки.

Атрибуты

BrowsableAttribute

Исключения

InvalidOperationException

Указанная строка при настройке этого свойства имеет свой DataGridView набор свойств.

Примеры

В следующем примере кода показано, как использовать шаблон строки для указания начальной высоты строки и минимальной высоты строки.

DataGridViewRow^ row = this->dataGridView1->RowTemplate;
row->DefaultCellStyle->BackColor = Color::Bisque;
row->Height = 35;
row->MinimumHeight = 20;

DataGridViewRow row = this.dataGridView1.RowTemplate;
row.DefaultCellStyle.BackColor = Color.Bisque;
row.Height = 35;
row.MinimumHeight = 20;

With Me.dataGridView1.RowTemplate
    .DefaultCellStyle.BackColor = Color.Bisque
    .Height = 35
    .MinimumHeight = 20
End With

Комментарии

Иногда требуется более широкий контроль над внешним видом DataGridView строк, чем то, что предоставляется различными DataGridView свойствами стиля ячеек. Свойство RowTemplate позволяет создавать и инициализировать DataGridViewRow для использования в качестве шаблона все строки, включая строку для новых записей, если AllowUserToAddRows это trueтак.

Это полезно при установке значений по умолчанию для свойств, таких как высота строки. Например, может потребоваться увеличить высоту строки по умолчанию, чтобы предоставить дополнительное место под обычным содержимым ячейки для отображения содержимого, охватывающего несколько столбцов.

Задание шаблона строки необходимо, если внешние данные отображаются с помощью пользовательских типов, производных от DataGridViewRow класса. С помощью несвязанных DataGridView элементов управления можно программно заполнить коллекцию Rows экземплярами пользовательского типа строки. Однако при отображении внешних данных строки создаются автоматически, но они основаны на шаблоне строки, который можно задать для экземпляра пользовательского типа строки.

Если это свойство не было задано при первом извлечении его значения, создается и возвращается новое DataGridViewRow свойство.

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

• Элемент управления DataGridView (Windows Forms)