DataGridViewRow Classe

Riferimento

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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à: 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

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