DataGridViewRow 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示 DataGridView 控件中的行。
public ref class DataGridViewRow : System::Windows::Forms::DataGridViewBand[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))]
public class DataGridViewRow : System.Windows.Forms.DataGridViewBand[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))>]
type DataGridViewRow = class
inherit DataGridViewBandPublic Class DataGridViewRow
Inherits DataGridViewBand- 继承
- 属性
示例
下面的代码示例演示了此类型的用法。 此示例是如何：操作 dataGridView 控件中的行Windows 窗体中提供的更大示例的一部分。
// Set row labels.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
int rowNumber = 1;
System::Collections::IEnumerator^ myEnum = safe_cast<System::Collections::IEnumerable^>(dataGridView->Rows)->GetEnumerator();
while ( myEnum->MoveNext() )
{
DataGridViewRow^ row = safe_cast<DataGridViewRow^>(myEnum->Current);
if ( row->IsNewRow )
continue;
row->HeaderCell->Value = String::Format( L"Row {0}", rowNumber );
rowNumber = rowNumber + 1;
}
dataGridView->AutoResizeRowHeadersWidth( DataGridViewRowHeadersWidthSizeMode::AutoSizeToAllHeaders );
}
// Set row labels.
private void Button6_Click(object sender, System.EventArgs e)
{
int rowNumber = 1;
foreach (DataGridViewRow row in dataGridView.Rows)
{
if (row.IsNewRow) continue;
row.HeaderCell.Value = "Row " + rowNumber;
rowNumber = rowNumber + 1;
}
dataGridView.AutoResizeRowHeadersWidth(
DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders);
}
' Set row labels.
Private Sub Button6_Click(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button6.Click
Dim rowNumber As Integer = 1
For Each row As DataGridViewRow In dataGridView.Rows
If row.IsNewRow Then Continue For
row.HeaderCell.Value = "Row " & rowNumber
rowNumber = rowNumber + 1
Next
dataGridView.AutoResizeRowHeadersWidth( _
DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders)
End Sub
注解
类 DataGridViewRow 表示 控件中的行 DataGridView 。 可以通过 控件的 和 SelectedRows 集合检索行Rows。
与 不同， DataGridViewColumn物理 DataGridViewRow 上包含该行中所有单元格的集合。 可以通过 属性访问此集合 Cells 。
类 DataGridViewRow 用于访问单个单元格元素，以及调整行用户界面的外观和行为 (UI) ，如高度和单元格样式。 通常，你会希望控件中的所有行或大多数行共享相同的特征。 若要设置控件中所有行的单元格样式，请设置 属性 DataGridView.RowsDefaultCellStyle 返回的 对象的属性。 若要设置交替行的样式，请使用 DataGridView.AlternatingRowsDefaultCellStyle 属性。 有关单元格样式的详细信息，请参阅 Windows 窗体 DataGridView 控件中的单元格样式。 还可以使用 DataGridView.RowTemplate 属性定义一个行，该行将用作添加到控件的所有行的基础。
控件 DataGridView 将尽可能跨多个数据行共享 DataGridViewRow 对象，以避免性能损失。 除非处理大量数据并遇到性能问题，否则通常可以忽略行共享。 共享行的 Index 属性值为 -1。 类的某些 DataGridViewRow 成员不能与共享行一起使用，但可以通过 属性访问 DataGridViewRowCollection.Item[] 行来取消共享。 行也可能以其他方式取消共享。 若要在不取消共享的情况下访问行，请使用 DataGridViewRowCollection.SharedRow 方法。 处理大量数据时，应注意如何共享和取消共享行，以避免性能损失。 有关详细信息，请参阅 缩放 Windows 窗体 DataGridView 控件的最佳做法。
继承者说明
从 DataGridViewRow 派生类并将新属性添加到派生类时，请务必重写 Clone() 方法，以在克隆操作期间复制新属性。 还应调用基类的 Clone() 方法，以便将基类的属性复制到新单元格。
构造函数
| DataGridViewRow() |
在不使用模板的情况下初始化 DataGridViewRow 类的新实例。 |
属性
| AccessibilityObject |
获取分配给 DataGridViewRow.DataGridViewRowAccessibleObject 的 DataGridViewRow。 |
| Cells |
获取用于填充行的单元格集合。 |
| ContextMenuStrip |
获取或设置行的快捷菜单。 |
| DataBoundItem |
获取用于填充行的数据绑定对象。 |
| DataGridView |
获取与此元素关联的 DataGridView 控件。 (继承自 DataGridViewElement) |
| DefaultCellStyle |
获取或设置行的默认样式，除非重写默认样式，否则将用它们来呈现行中的单元格。 |
| DefaultHeaderCellType |
获取或设置默认标题单元格的运行时类型。 (继承自 DataGridViewBand) |
| Displayed |
获取一个值，指示此行是否显示在屏幕上。 |
| DividerHeight |
获取或设置行分隔符的高度（以像素为单位）。 |
| ErrorText |
获取或设置行级别错误的错误消息文本。 |
| Frozen |
获取或设置一个指示行是否已被冻结的值。 |
| HasDefaultCellStyle |
获取指示是否已设置 DefaultCellStyle 属性的值。 (继承自 DataGridViewBand) |
| HeaderCell |
获取或设置行的标头单元格。 |
| HeaderCellCore |
获取或设置 DataGridViewBand 的标题单元格。 (继承自 DataGridViewBand) |
| Height |
获取或设置行的当前高度。 |
| Index |
获取带区在 DataGridView 控件中的相对位置。 (继承自 DataGridViewBand) |
| InheritedStyle |
获取行中生效的单元格样式。 |
| IsNewRow |
获取一个值，指示行是否为用于新纪录的行。 |
| IsRow |
获取一个值，该值指示带区是否表示一个行。 (继承自 DataGridViewBand) |
| MinimumHeight |
获取或设置行的最小高度。 |
| ReadOnly |
获取或设置一个值，指示行是否为只读。 |
| Resizable |
获取或设置一个值，该值指示用户是否可以调整行大小，或指示该行为继承自 AllowUserToResizeRows 属性。 |
| Selected |
获取或设置一个指示行是否已被选定的值。 |
| State |
获取行的当前状态。 |
| Tag |
获取或设置包含与带区关联的数据的对象。 (继承自 DataGridViewBand) |
| Visible |
获取或设置一个指示行是否可见的值。 |
