DataGridViewRow 类

参考

定义

命名空间:: System.Windows.Forms

程序集:: System.Windows.Forms.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，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 DataGridViewBand

Public Class DataGridViewRow
Inherits DataGridViewBand

继承: Object

DataGridViewElement

DataGridViewBand
DataGridViewRow

属性: TypeConverterAttribute

示例

下面的代码示例演示了此类型的用法。此示例是如何：操作 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	获取或设置一个指示行是否可见的值。

方法

AdjustRowHeaderBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	根据指定的条件修改输入行标头的边框样式。
Clone()	创建此行的精确副本。
CreateAccessibilityInstance()	为 DataGridViewRow 创建一个新的可访问对象。
CreateCells(DataGridView)	根据所提供的 DataGridView 模板清除现有单元格并设置它们的模板。
CreateCells(DataGridView, Object[])	清除现有单元格并设置其模板和值。
CreateCellsInstance()	根据此行构造新的单元格集合。
Dispose()	释放由 DataGridViewBand 使用的所有资源。 (继承自 DataGridViewBand)
Dispose(Boolean)	释放由 DataGridViewBand 占用的非托管资源，还可以另外再释放托管资源。 (继承自 DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)	围绕指定边界绘制聚焦框。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetContextMenuStrip(Int32)	获取行的快捷菜单。
GetErrorText(Int32)	获取指定索引处的行的错误文本。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean)	根据指定的条件计算指定行的理想高度。
GetState(Int32)	返回一个值，指示行的当前状态。
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnDataGridViewChanged()	当带区与其他 DataGridView 关联时调用。 (继承自 DataGridViewBand)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean)	绘制当前行。
PaintCells(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)	在当前行中绘制单元格。
PaintHeader(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)	绘制当前行的标头单元格。
RaiseCellClick(DataGridViewCellEventArgs)	引发 CellClick 事件。 (继承自 DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	引发 CellContentClick 事件。 (继承自 DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	引发 CellContentDoubleClick 事件。 (继承自 DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	引发 CellValueChanged 事件。 (继承自 DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	引发 DataError 事件。 (继承自 DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	引发 MouseWheel 事件。 (继承自 DataGridViewElement)
SetValues(Object[])	设置行的单元格的值。
ToString()	获取用于描述行的可读字符串。

适用于

DataGridViewRow 类

定义

示例

注解

继承者说明

构造函数

属性

方法

适用于

另请参阅

反馈

其他资源