DataGridView.RowTemplate Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ottiene o imposta la riga che rappresenta il modello per tutte le righe nel controllo.

public:
 property System::Windows::Forms::DataGridViewRow ^ RowTemplate { System::Windows::Forms::DataGridViewRow ^ get(); void set(System::Windows::Forms::DataGridViewRow ^ value); };
[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.DataGridViewRow RowTemplate { get; set; }
[<System.ComponentModel.Browsable(true)>]
member this.RowTemplate : System.Windows.Forms.DataGridViewRow with get, set
Public Property RowTemplate As DataGridViewRow

Valore della proprietà

DataGridViewRow

Oggetto DataGridViewRow che rappresenta il modello di riga.

Attributi
BrowsableAttribute

Eccezioni

InvalidOperationException

La riga specificata durante l'impostazione di questa proprietà ha la proprietà DataGridView impostata.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il modello di riga per specificare un'altezza della riga iniziale e un'altezza minima di riga.

DataGridViewRow^ row = this->dataGridView1->RowTemplate;
row->DefaultCellStyle->BackColor = Color::Bisque;
row->Height = 35;
row->MinimumHeight = 20;

DataGridViewRow row = this.dataGridView1.RowTemplate;
row.DefaultCellStyle.BackColor = Color.Bisque;
row.Height = 35;
row.MinimumHeight = 20;

With Me.dataGridView1.RowTemplate
    .DefaultCellStyle.BackColor = Color.Bisque
    .Height = 35
    .MinimumHeight = 20
End With

Commenti

A volte si vuole maggiore controllo sull'aspetto delle DataGridView righe rispetto a quello fornito dalle varie DataGridView proprietà dello stile di cella. La RowTemplate proprietà consente di creare e inizializzare un DataGridViewRow oggetto per l'uso come modello per tutte le righe, inclusa la riga per i nuovi record se AllowUserToAddRows è true.

Ciò è utile quando si impostano valori predefiniti per le proprietà, ad esempio l'altezza della riga. Ad esempio, è possibile aumentare l'altezza della riga predefinita per fornire spazio aggiuntivo sotto il contenuto normale della cella per visualizzare il contenuto che si estende su più colonne.

L'impostazione del modello di riga è necessaria quando i dati esterni vengono visualizzati usando tipi personalizzati derivati dalla DataGridViewRow classe. Con i controlli non in ingresso DataGridView è possibile popolare a livello di codice la Rows raccolta con istanze del tipo di riga personalizzato. Quando si visualizzano dati esterni, tuttavia, le righe vengono generate automaticamente, ma sono basate sul modello di riga, che è possibile impostare su un'istanza del tipo di riga personalizzato.

Se questa proprietà non è stata impostata la prima volta che si recupera il relativo valore, viene creato e restituito un nuovo oggetto DataGridViewRow .

Si applica a

Vedi anche