DataGridViewRow Classe

Definizione

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

Ereditarietà

Object

DataGridViewElement

DataGridViewBand

DataGridViewRow

Attributi

TypeConverterAttribute

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo tipo. Questo esempio fa parte di un esempio più ampio disponibile in Procedura: Modificare righe nel controllo 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

Commenti

La DataGridViewRow classe rappresenta una riga in un DataGridView controllo . È possibile recuperare righe tramite le Rows raccolte e SelectedRows del controllo .

A differenza di un DataGridViewColumnoggetto , un DataGridViewRow oggetto contiene fisicamente una raccolta di tutte le celle di tale riga. È possibile accedere a questa raccolta tramite la Cells proprietà .

La DataGridViewRow classe viene usata per accedere ai singoli elementi di cella, nonché per regolare l'aspetto e il comportamento dell'interfaccia utente della riga, ad esempio altezza e stile cella. In genere, è necessario che tutte le righe o la maggior parte delle righe nel controllo convida le stesse caratteristiche. Per impostare gli stili di cella per tutte le righe del controllo, impostare le proprietà dell'oggetto restituito dalla DataGridView.RowsDefaultCellStyle proprietà . Per impostare gli stili per le righe alternate, utilizzare la DataGridView.AlternatingRowsDefaultCellStyle proprietà . Per altre informazioni sugli stili di cella, vedere Stili di cella nel controllo DataGridView Windows Forms. È anche possibile utilizzare la DataGridView.RowTemplate proprietà per definire una riga che verrà utilizzata come base per tutte le righe aggiunte al controllo.

Il DataGridView controllo condividerà DataGridViewRow gli oggetti tra più righe di dati quando possibile per evitare penalità sulle prestazioni. A meno che non si stia usando grandi quantità di dati e si verifichino problemi di prestazioni, in genere è possibile ignorare la condivisione delle righe. Una riga condivisa è indicata da un Index valore di proprietà pari a -1. Alcuni membri della DataGridViewRow classe non possono essere usati con righe condivise, ma è possibile annullare la condivisione di una riga accedendola tramite la DataGridViewRowCollection.Item[] proprietà . Le righe possono anche diventare non condivise in altri modi. Per accedere a una riga senza unsharing, usare il DataGridViewRowCollection.SharedRow metodo . Quando si utilizzano grandi quantità di dati, è necessario essere consapevoli del modo in cui le righe vengono condivise e non condivise per evitare penalità per le prestazioni. Per altre informazioni, vedere Procedure consigliate per ridimensionare il controllo DataGridView Windows Form.

Note per gli eredi

Quando si deriva da DataGridViewRow e si aggiungono nuove proprietà alla classe derivata, assicurarsi di eseguire l'override del Clone() metodo per copiare le nuove proprietà durante le operazioni di clonazione. È anche necessario chiamare il metodo della classe di Clone() base in modo che le proprietà della classe di base vengano copiate nella nuova cella.

Costruttori

Proprietà

Metodi

Si applica a

Vedi anche

• DataGridView
• DataGridViewColumn
• Clone()
• Procedure consigliate per ridimensionare il controllo DataGridView Windows Form
• Stili della cella nel controllo DataGridView Windows Form