DataGridViewRow Klas

Definitie

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

Overname

Object

DataGridViewElement

DataGridViewBand

DataGridViewRow

Kenmerken

TypeConverterAttribute

Voorbeelden

Het volgende codevoorbeeld illustreert het gebruik van dit type. Dit voorbeeld maakt deel uit van een groter voorbeeld dat beschikbaar is in Hoe u: Rijen bewerken in het Windows Forms DataGridView-besturingselement.

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

Opmerkingen

De DataGridViewRow klasse vertegenwoordigt een rij in een DataGridView besturingselement. U kunt rijen ophalen via de Rows en SelectedRows verzamelingen van het besturingselement.

In tegenstelling tot een DataGridViewColumn, bevat een DataGridViewRow fysiek een verzameling van alle cellen in die rij. U kunt deze verzameling openen via de Cells eigenschap.

De DataGridViewRow klasse wordt gebruikt voor toegang tot de afzonderlijke celelementen en voor het aanpassen van het uiterlijk en gedrag van de gebruikersinterface van rijen, zoals hoogte en celstijl. Normaal gesproken wilt u dat alle rijen of de meeste rijen in het besturingselement dezelfde kenmerken delen. Als u celstijlen wilt instellen voor alle rijen in het besturingselement, stelt u de eigenschappen in van het object dat door de DataGridView.RowsDefaultCellStyle eigenschap wordt geretourneerd. Als u stijlen voor afwisselende rijen wilt instellen, gebruikt u de DataGridView.AlternatingRowsDefaultCellStyle eigenschap. Zie Celstijlen in het besturingselement Windows Forms DataGridViewvoor meer informatie over celstijlen. U kunt de DataGridView.RowTemplate eigenschap ook gebruiken om een rij te definiëren die wordt gebruikt als basis voor alle rijen die aan het besturingselement worden toegevoegd.

Het DataGridView besturingselement deelt DataGridViewRow waar mogelijk objecten in meerdere gegevensrijen om prestatiestraffen te voorkomen. Tenzij u met grote hoeveelheden gegevens werkt en prestatieproblemen ondervindt, kunt u het delen van rijen meestal negeren. Een gedeelde rij wordt aangegeven met een Index eigenschapswaarde van -1. Sommige leden van de DataGridViewRow klasse kunnen niet worden gebruikt met gedeelde rijen, maar u kunt het delen van een rij opheffen door deze te openen via de DataGridViewRowCollection.Item[] eigenschap. Rijen kunnen ook op andere manieren niet worden gedeeld. Gebruik de DataGridViewRowCollection.SharedRow methode om toegang te krijgen tot een rij zonder de vorm ervan ongedaan te maken. Wanneer u met grote hoeveelheden gegevens werkt, moet u rekening houden met hoe rijen worden gedeeld en niet worden gedeeld om prestatiestraffen te voorkomen. Zie Best practices voor het schalen van het Windows Forms DataGridView-besturingselement voor meer informatie.

Notities voor overnemers

Wanneer u bent afgeleid van DataGridViewRow en nieuwe eigenschappen toevoegt aan de afgeleide klasse, moet u de Clone() methode overschrijven om de nieuwe eigenschappen te kopiëren tijdens het klonen. U moet ook de methode van Clone() de basisklasse aanroepen, zodat de eigenschappen van de basisklasse naar de nieuwe cel worden gekopieerd.

Zie ook

• DataGridView
• DataGridViewColumn
• Clone()
• Aanbevolen procedures voor het schalen van het Besturingselement Windows Forms DataGridView
• Celstijlen in het Windows Forms DataGridView-besturingselement