DataGridViewRow Classe

Definizione

Rappresenta una riga in un controllo 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
Ereditarietà
Attributi

Esempio

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo di questo tipo. Questo esempio fa parte di un esempio più ampio disponibile in procedura: modificare le righe nel controllo Windows Form 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

Commenti

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

Diversamente da DataGridViewColumn , un oggetto DataGridViewRow contiene fisicamente una raccolta di tutte le celle della riga. È possibile accedere a questa raccolta tramite la Cells Proprietà.

La DataGridViewRow classe viene utilizzata per accedere ai singoli elementi della cella, nonché per modificare l'aspetto e il comportamento dell'interfaccia utente di riga, ad esempio l'altezza e lo stile della cella. In genere, si desidera che tutte le righe o la maggior parte delle righe nel controllo condividano le stesse caratteristiche. Per impostare gli stili delle celle per tutte le righe nel 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 ulteriori informazioni sugli stili delle celle, vedere la pagina relativa agli stili delle celle nel controllo DataGridView Windows Form. È anche possibile usare la DataGridView.RowTemplate proprietà per definire una riga che verrà usata 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 le penalizzazioni delle prestazioni. A meno che non si stiano lavorando con grandi quantità di dati e si verifichino problemi di prestazioni, in genere è possibile ignorare la condivisione di righe. Una riga condivisa è indicata dal Index valore della proprietà-1. Alcuni membri della DataGridViewRow classe non possono essere usati con righe condivise, ma è possibile annullare la condivisione di una riga accedendo alla DataGridViewRowCollection.Item[] Proprietà. È inoltre possibile annullare la condivisione delle righe in altri modi. Per accedere a una riga senza rimuoverne la condivisione, usare il DataGridViewRowCollection.SharedRow metodo. Quando si lavora con grandi quantità di dati, è necessario tenere presente il modo in cui le righe vengono condivise e non condivise per evitare le penalizzazioni delle prestazioni. Per altre informazioni, vedere Procedure consigliate per ridimensionare il controllo DataGridView Windows Form.

Note per gli eredi

Quando si derivano 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 base Clone() in modo che le proprietà della classe di base vengano copiate nella nuova cella.

Costruttori

DataGridViewRow()

Inizializza una nuova istanza del controllo DataGridViewRow senza l'utilizzo di un modello.

Proprietà

AccessibilityObject

Ottiene l'oggetto DataGridViewRow.DataGridViewRowAccessibleObject assegnato a DataGridViewRow.

Cells

Ottiene la raccolta di celle inserite nella riga.

ContextMenuStrip

Ottiene o imposta il menu di scelta rapida della riga.

DataBoundItem

Ottiene l'oggetto con associazione a dati che ha popolato la riga.

DataGridView

Ottiene il controllo DataGridView associato a questo elemento.

(Ereditato da DataGridViewElement)
DefaultCellStyle

Ottiene o imposta gli stili predefiniti per la riga utilizzati per il rendering delle celle nella riga, a meno che non sia stato eseguito l'override degli stili.

DefaultHeaderCellType

Ottiene o imposta il tipo in fase di esecuzione della cella di intestazione predefinita.

(Ereditato da DataGridViewBand)
Displayed

Ottiene un valore che indica se la riga è visualizzata sullo schermo.

DividerHeight

Ottiene o imposta l'altezza, in pixel, del divisore di righe.

ErrorText

Ottiene o imposta il testo del messaggio degli errori a livello di riga.

Frozen

Ottiene o imposta un valore che indica se la riga è bloccata.

HasDefaultCellStyle

Ottiene un valore che indica se la proprietà DefaultCellStyle è stata impostata.

(Ereditato da DataGridViewBand)
HeaderCell

Ottiene o imposta la cella di intestazione della riga.

HeaderCellCore

Ottiene o imposta la cella di intestazione dell'oggetto DataGridViewBand.

(Ereditato da DataGridViewBand)
Height

Ottiene o imposta l'altezza corrente della riga.

Index

Ottiene la posizione relativa della banda all'interno del controllo DataGridView.

(Ereditato da DataGridViewBand)
InheritedStyle

Ottiene lo stile della cella attivo per la riga.

IsNewRow

Ottiene un valore che indica se la riga è per i nuovi record.

IsRow

Ottiene un valore che indica se la banda rappresenta una riga.

(Ereditato da DataGridViewBand)
MinimumHeight

Ottiene o imposta l'altezza minima della riga.

ReadOnly

Ottiene o imposta un valore che indica se la riga è di sola lettura.

Resizable

Ottiene o imposta un valore che indica se gli utenti possono ridimensionare la riga o che il comportamento viene ereditato dalla proprietà AllowUserToResizeRows.

Selected

Ottiene o imposta un valore che indica se la riga è selezionata.

State

Ottiene lo stato corrente della riga.

Tag

Ottiene o imposta l'oggetto contenente i dati da associare alla banda.

(Ereditato da DataGridViewBand)
Visible

Ottiene o imposta un valore che indica se la riga è visibile.

Metodi

AdjustRowHeaderBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)

Modifica lo stile del bordo dell'intestazione della riga di input in base ai criteri specificati.

Clone()

Crea una copia esatta di questa riga.

CreateAccessibilityInstance()

Crea un nuovo oggetto accessibile per DataGridViewRow.

CreateCells(DataGridView)

Cancella le celle esistenti e imposta il loro modello in base al modello DataGridView fornito.

CreateCells(DataGridView, Object[])

Cancella le celle esistenti e ne imposta il modello e i valori.

CreateCellsInstance()

Costruisce una nuova raccolta di celle basate su questa riga.

Dispose()

Rilascia tutte le risorse usate da DataGridViewBand.

(Ereditato da DataGridViewBand)
Dispose(Boolean)

Rilascia le risorse non gestite usate da DataGridViewBand e, facoltativamente, le risorse gestite.

(Ereditato da DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)

Disegna un rettangolo di attivazione intorno ai limiti specificati.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetContextMenuStrip(Int32)

Ottiene il menu di scelta rapida della riga.

GetErrorText(Int32)

Ottiene il testo di errore per la riga in corrispondenza dell'indice specificato.

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean)

Calcola l'altezza ideale della riga specificata in base ai criteri specificati.

GetState(Int32)

Restituisce un valore che indica lo stato corrente della riga.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
OnDataGridViewChanged()

Viene chiamato quando la banda è associata a un oggetto DataGridView differente.

(Ereditato da DataGridViewBand)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean)

Disegna la riga corrente.

PaintCells(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)

Disegna le celle nella riga corrente.

PaintHeader(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)

Disegna la cella di intestazione nella riga corrente.

RaiseCellClick(DataGridViewCellEventArgs)

Genera l'evento CellClick.

(Ereditato da DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

Genera l'evento CellContentClick.

(Ereditato da DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

Genera l'evento CellContentDoubleClick.

(Ereditato da DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

Genera l'evento CellValueChanged.

(Ereditato da DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

Genera l'evento DataError.

(Ereditato da DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

Genera l'evento MouseWheel.

(Ereditato da DataGridViewElement)
SetValues(Object[])

Imposta i valori delle celle della riga.

ToString()

Ottiene una stringa leggibile che descrive la riga.

Si applica a

Vedi anche