DataGridView.RowTemplate 属性

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

获取或设置一行，该行表示控件中所有行的模板。

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 窗体）