Classe DataGridView
Assembly: System.Windows.Forms (in system.windows.forms.dll)
[ComVisibleAttribute(true)] [ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] public class DataGridView : Control, ISupportInitialize
/** @attribute ComVisibleAttribute(true) */ /** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ public class DataGridView extends Control implements ISupportInitialize
Il controllo DataGridView fornisce una tabella personalizzabile per la visualizzazione dei dati. La classe DataGridView consente la personalizzazione di celle, righe, colonne e bordi tramite l'utilizzo di proprietà quali DefaultCellStyle, ColumnHeadersDefaultCellStyle, CellBorderStyle e GridColor. Per ulteriori informazioni, vedere Formattazione e stile di base nel controllo DataGridView Windows Form.
È possibile utilizzare un controllo DataGridView per visualizzare i dati con o senza un'origine dati sottostante. Senza specificare un'origine dati, è possibile creare righe e colonne di dati e aggiungerle direttamente al controllo DataGridView. In alternativa, è possibile impostare le proprietà DataSource e DataMember per associare DataGridView a un'origine dati e inserire automaticamente i dati nel controllo. Per ulteriori informazioni, vedere Visualizzazione di dati nel controllo DataGridView Windows Form.
Quando si utilizzano grandi quantità di dati, è possibile impostare la proprietà VirtualMode su true in modo da visualizzare un sottoinsieme dei dati disponibili. In modalità virtuale è necessario prevedere l'implementazione di una cache dati dalla quale prelevare i dati da inserire nel controllo DataGridView. Per ulteriori informazioni, vedere Modalità di visualizzazione dati nel controllo DataGridView di Windows Form.
Per informazioni aggiuntive sulle funzionalità disponibili nel controllo DataGridView, vedere Controllo DataGridView (Windows Form).
Il controllo DataGridView sostituisce il controllo DataGrid disponibile nelle versioni precedenti. Quest'ultimo, tuttavia, è stato mantenuto per garantire la compatibilità con le versioni precedenti e può essere eventualmente utilizzato. Per ulteriori informazioni, vedere Differenze tra i controlli DataGridView e DataGrid di Windows Form.
Nell'esempio di codice riportato di seguito viene illustrato come inizializzare un controllo DataGridView non associato. Per eseguire l'esempio, incollare il codice riportato di seguito in un form contenente un oggetto DataGridView denominato dataGridView1 e tre pulsanti denominati addNewRowButton, deleteRowButton e ledgerStyleButton. Chiamare i metodi SetUpDataGridView e PopulateDataGridView dal costruttore del form o dal gestore eventi Load. Accertarsi che tutti gli eventi siano associati ai relativi gestori eventi.
private void ledgerStyleButton_Click(object sender, System.EventArgs e) { // Create a new cell style. DataGridViewCellStyle style = new DataGridViewCellStyle(); { style.BackColor = Color.Beige; style.ForeColor = Color.Brown; style.Font = new Font("Verdana", 8); } // Apply the style as the default cell style. dataGridView1.AlternatingRowsDefaultCellStyle = style; ledgerStyleButton.Enabled = false; } private void SetUpDataGridView() { this.Controls.Add(dataGridView1); dataGridView1.ColumnCount = 5; DataGridViewCellStyle style = dataGridView1.ColumnHeadersDefaultCellStyle; style.BackColor = Color.Navy; style.ForeColor = Color.White; style.Font = new Font(dataGridView1.Font, FontStyle.Bold); dataGridView1.EditMode = DataGridViewEditMode.EditOnEnter; dataGridView1.Name = "dataGridView1"; dataGridView1.Location = new Point(8, 8); dataGridView1.Size = new Size(500, 300); dataGridView1.AutoSizeRowsMode = DataGridViewAutoSizeRowsMode.DisplayedCellsExceptHeaders; dataGridView1.ColumnHeadersBorderStyle = DataGridViewHeaderBorderStyle.Raised; dataGridView1.CellBorderStyle = DataGridViewCellBorderStyle.Single; dataGridView1.GridColor = SystemColors.ActiveBorder; dataGridView1.RowHeadersVisible = false; dataGridView1.Columns[0].Name = "Release Date"; dataGridView1.Columns[1].Name = "Track"; dataGridView1.Columns[1].DefaultCellStyle.Alignment = DataGridViewContentAlignment.MiddleCenter; dataGridView1.Columns[2].Name = "Title"; dataGridView1.Columns[3].Name = "Artist"; dataGridView1.Columns[4].Name = "Album"; // Make the font italic for row four. dataGridView1.Columns[4].DefaultCellStyle.Font = new Font(DataGridView.DefaultFont, FontStyle.Italic); dataGridView1.SelectionMode = DataGridViewSelectionMode.FullRowSelect; dataGridView1.MultiSelect = false; dataGridView1.BackgroundColor = Color.Honeydew; dataGridView1.Dock = DockStyle.Fill; dataGridView1.CellFormatting += new DataGridViewCellFormattingEventHandler(dataGridView1_CellFormatting); dataGridView1.CellParsing += new DataGridViewCellParsingEventHandler(dataGridView1_CellParsing); addNewRowButton.Click += new EventHandler(addNewRowButton_Click); deleteRowButton.Click += new EventHandler(deleteRowButton_Click); ledgerStyleButton.Click += new EventHandler(ledgerStyleButton_Click); dataGridView1.CellValidating += new DataGridViewCellValidatingEventHandler(dataGridView1_CellValidating); } private void PopulateDataGridView() { // Create the string array for each row of data. string[] row0 = { "11/22/1968", "29", "Revolution 9", "Beatles", "The Beatles [White Album]" }; string[] row1 = { "4/4/1960", "6", "Fools Rush In", "Frank Sinatra", "Nice 'N' Easy" }; string[] row2 = { "11/11/1971", "1", "One of These Days", "Pink Floyd", "Meddle" }; string[] row3 = { "4/4/1988", "7", "Where Is My Mind?", "Pixies", "Surfer Rosa" }; string[] row4 = { "5/1981", "9", "Can't Find My Mind", "Cramps", "Psychedelic Jungle" }; string[] row5 = { "6/10/2003", "13", "Scatterbrain. (As Dead As Leaves.)", "Radiohead", "Hail to the Thief" }; string[] row6 = { "6/30/1992", "3", "Dress", "P J Harvey", "Dry" }; // Add a row for each string array. { DataGridViewRowCollection rows = this.dataGridView1.Rows; rows.Add(row0); rows.Add(row1); rows.Add(row2); rows.Add(row3); rows.Add(row4); rows.Add(row5); rows.Add(row6); } // Change the order the columns are displayed. { DataGridViewColumnCollection columns = this.dataGridView1.Columns; columns[0].DisplayIndex = 3; columns[1].DisplayIndex = 4; columns[2].DisplayIndex = 0; columns[3].DisplayIndex = 1; columns[4].DisplayIndex = 2; } }
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.DataGridView
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.
Riferimenti
Membri DataGridViewSpazio dei nomi System.Windows.Forms
Altre risorse
Controllo DataGridView (Windows Form)Cenni preliminari sul controllo DataGridView (Windows Form)
Formattazione e stile di base nel controllo DataGridView Windows Form
Visualizzazione di dati nel controllo DataGridView Windows Form
Modalità di visualizzazione dati nel controllo DataGridView di Windows Form
Differenze tra i controlli DataGridView e DataGrid di Windows Form
