Procedura: aggiungere tabelle e colonne al controllo DataGrid Windows Form

Nota

Benché il controllo DataGridView sostituisca il controllo DataGrid aggiungendovi funzionalità, il controllo DataGrid viene mantenuto per compatibilità con le versioni precedenti e per un eventuale utilizzo futuro. Per ulteriori informazioni, vedere Differenze tra i controlli DataGridView e DataGrid di Windows Form.

È possibile visualizzare i dati del controllo DataGrid Windows Form in tabelle e colonne creando oggetti DataGridTableStyle e aggiungendoli all'oggetto GridTableStylesCollection, a cui si accede mediante la proprietà TableStyles del controllo DataGrid. Ogni stile di tabella visualizza il contenuto di qualsiasi tabella di dati specificata nella proprietà MappingName dell'oggetto DataGridTableStyle. Per impostazione predefinita, uno stile di tabella per il quale non sono stati specificati stili di colonna visualizzerà tutte le colonne presenti nella tabella di dati corrispondente. È possibile limitare il numero di colonne della tabella da visualizzare aggiungendo oggetti DataGridColumnStyle all'oggetto GridColumnStylesCollection, a cui si accede mediante la proprietà GridColumnStyles di ciascun oggetto DataGridTableStyle.

Per aggiungere una tabella e una colonna a un controllo DataGrid a livello di codice

1. Per visualizzare i dati nella tabella è innanzitutto necessario associare il controllo DataGrid a un dataset. Per ulteriori informazioni, vedere Procedura: associare il controllo DataGrid Windows Form a un'origine dati.

   Attenzione

   Quando si specificano gli stili di colonna a livello di codice, prima di aggiungere oggetti DataGridTableStyle all'oggetto GridTableStylesCollection è necessario creare sempre oggetti DataGridColumnStyle e aggiungerli all'oggetto GridColumnStylesCollection. Quando si aggiunge all'insieme un oggetto DataGridTableStyle vuoto, gli oggetti DataGridColumnStyle vengono generati automaticamente. Di conseguenza, se si tenta di aggiungere all'oggetto GridColumnStylesCollection nuovi oggetti DataGridColumnStyle con valori di MappingName duplicati, verrà generata un'eccezione.

2. Dichiarare un nuovo stile di tabella e impostarne il nome di associazione.

   Dim ts1 As New DataGridTableStyle()
   ts1.MappingName = "Customers"
   

   DataGridTableStyle ts1 = new DataGridTableStyle();
   ts1.MappingName = "Customers";
   

   DataGridTableStyle* ts1 = new DataGridTableStyle();
   ts1->MappingName = S"Customers";
   

3. Dichiarare un nuovo stile di colonna e impostarne il nome di associazione e altre proprietà.

   Dim myDataCol As New DataGridBoolColumn()
   myDataCol.HeaderText = "My New Column"
   myDataCol.MappingName = "Current"
   

   DataGridBoolColumn myDataCol = new DataGridBoolColumn();
   myDataCol.HeaderText = "My New Column";
   myDataCol.MappingName = "Current";
   

   DataGridBoolColumn^ myDataCol = gcnew DataGridBoolColumn();
   myDataCol->HeaderText = "My New Column";
   myDataCol->MappingName = "Current";
   

4. Chiamare il metodo Add dell'oggetto GridColumnStylesCollection per aggiungere la colonna allo stile di tabella.

   ts1.GridColumnStyles.Add(myDataCol)
   

   ts1.GridColumnStyles.Add(myDataCol);
   

   ts1->GridColumnStyles->Add(myDataCol);
   

5. Chiamare il metodo Add dell'oggetto GridTableStylesCollection per aggiungere lo stile di tabella alla griglia di dati.

   DataGrid1.TableStyles.Add(ts1)
   

   dataGrid1.TableStyles.Add(ts1);
   

   dataGrid1->TableStyles->Add(ts1);
   

Vedere anche

Attività

Procedura: eliminare o nascondere colonne nel controllo DataGrid Windows Form

Altre risorse

Controllo DataGrid (Windows Form)