DataGridViewRow Třída

Definice

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

Dědičnost

Object

DataGridViewElement

DataGridViewBand

DataGridViewRow

Atributy

TypeConverterAttribute

Příklady

Následující příklad kódu ukazuje použití tohoto typu. Tento příklad je součástí většího příkladu, který je k dispozici v tématu Postupy: Manipulace s řádky v ovládacím prvku model Windows Forms DataGridView.

// 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

Poznámky

Třída DataGridViewRow představuje řádek v ovládacím DataGridView prvku. Řádky můžete načítat prostřednictvím Rows kolekcí a SelectedRows ovládacího prvku.

Na rozdíl od objektu DataGridViewColumnobsahuje DataGridViewRow objekt fyzicky kolekci všech buněk v daném řádku. K této kolekci můžete přistupovat Cells prostřednictvím vlastnosti .

Třída DataGridViewRow se používá pro přístup k jednotlivým prvkům buňky a také k úpravě vzhledu a chování uživatelského rozhraní řádku, jako je výška a styl buňky. Obvykle chcete, aby všechny řádky nebo většina řádků v ovládacím prvku sdílela stejné vlastnosti. Chcete-li nastavit styly buněk pro všechny řádky v ovládacím prvku, nastavte vlastnosti objektu vráceného DataGridView.RowsDefaultCellStyle vlastností . Pokud chcete nastavit styly pro střídavé řádky, použijte DataGridView.AlternatingRowsDefaultCellStyle vlastnost . Další informace o stylech buněk naleznete v tématu Styly buňky v ovládacím prvku model Windows Forms DataGridView. Vlastnost můžete použít také DataGridView.RowTemplate k definování řádku, který bude použit jako základ pro všechny řádky přidané do ovládacího prvku.

Ovládací DataGridView prvek bude sdílet DataGridViewRow objekty mezi více řádky dat, kdykoli je to možné, aby se zabránilo snížení výkonu. Pokud nepracujete s velkými objemy dat a nedochází k problémům s výkonem, můžete sdílení řádků obvykle ignorovat. Sdílený řádek je označen Index hodnotou vlastnosti -1. Některé členy DataGridViewRow třídy nelze použít se sdílenými řádky, ale sdílení řádku můžete zrušit tak, že k němu budete přistupovat prostřednictvím DataGridViewRowCollection.Item[] vlastnosti . Řádky se můžou zrušit i jinými způsoby. Pokud chcete získat přístup k řádku bez zrušení sdílení, použijte metodu DataGridViewRowCollection.SharedRow . Při práci s velkými objemy dat byste měli vědět, jak se řádky sdílejí a nesdílejí, abyste se vyhnuli postihům za výkon. Další informace najdete v tématu Osvědčené postupy pro škálování ovládacího prvku model Windows Forms DataGridView.

Poznámky pro dědice

Když odvozujete a DataGridViewRow přidáte nové vlastnosti do odvozené třídy, nezapomeňte přepsat metodu Clone() pro zkopírování nových vlastností během operací klonování. Měli byste také volat metodu základní třídy Clone() , aby se vlastnosti základní třídy zkopírovaly do nové buňky.

Konstruktory

Vlastnosti

Metody

Platí pro

Viz také

• DataGridView
• DataGridViewColumn
• Clone()
• Doporučené postupy pro změnu velikosti v ovládacím prvku Windows Forms DataGridView
• Styly buňky v ovládacím prvku Windows Forms DataGridView