共用方式為


DataGridViewRow 類別

定義

表示 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
繼承
屬性

範例

下列程式代碼範例說明此類型的用法。 此範例是如何:操作 DataGridView 控件中 Windows Forms 數據列中較大範例的一部分。

// 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 列。 您可以透過控件的 RowsSelectedRows 集合擷取數據列。

DataGridViewColumn不同於 ,實際上DataGridViewRow包含該數據列中所有儲存格的集合。 您可以透過 Cells 屬性存取這個集合。

類別 DataGridViewRow 可用來存取個別儲存格元素,以及調整數據列使用者介面的外觀和行為, (UI) ,例如高度和儲存格樣式。 一般而言,您會想要控件中的所有數據列或大部分數據列共用相同的特性。 若要設定 控制項中所有數據列的儲存格樣式,請設定 屬性所 DataGridView.RowsDefaultCellStyle 傳回之物件的屬性。 若要設定替代數據列的樣式,請使用 DataGridView.AlternatingRowsDefaultCellStyle 屬性。 如需單元格樣式的詳細資訊,請參閱 DataGridView 控件中的儲存格樣式 Windows Forms。 您也可以使用 DataGridView.RowTemplate 屬性來定義數據列,該數據列將做為加入控件之所有數據列的基礎。

控件 DataGridView 會盡可能跨多個數據列共享 DataGridViewRow 物件,以避免效能降低。 除非您使用大量數據並遇到效能問題,否則您通常可以忽略數據列共用。 共用數據列是以 -1 的屬性值表示 Index 。 類別的某些 DataGridViewRow 成員無法與共用數據列搭配使用,但您可以透過 DataGridViewRowCollection.Item[] 屬性存取數據列來取消共享數據列。 數據列也可以以其他方式解除共用。 若要在不共享數據列的情況下存取數據列,請使用 DataGridViewRowCollection.SharedRow 方法。 使用大量數據時,您應該注意數據列的共用方式和未共用的方式,以避免效能降低。 如需詳細資訊,請參閱 縮放 Windows Form DataGridView 控制項的最佳做法

給繼承者的注意事項

當您衍生自 DataGridViewRow 並新增屬性至衍生類別時,請務必覆寫 Clone() 方法,以在複製作業期間複製新屬性。 您也應該呼叫基類 Clone() 的 方法,以便基類的屬性複製到新的儲存格。

建構函式

DataGridViewRow()

在不使用樣板下,初始化 DataGridViewRow 類別的新執行個體。

屬性

AccessibilityObject

取得指定給 DataGridViewRow.DataGridViewRowAccessibleObjectDataGridViewRow

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 所使用的 Unmanaged 資源,並選擇性地釋放 Managed 資源。

(繼承來源 DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)

在指定的界限四周繪製焦點矩形 (Focus Rectangle)。

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()

取得描述資料列之人們可讀取的 (Human-Readable) 字串。

適用於

另請參閱