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

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.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 所使用的 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) 字串。

適用於

DataGridViewRow 類別

定義

範例

備註

給繼承者的注意事項

建構函式

屬性

方法

適用於

另請參閱

意見反應

其他資源