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 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 |
取得或設定值，指出資料列是否可見。 |
