Condividi tramite


Procedura: associare il controllo DataGrid Windows Form a un'origine dati

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.

Il controllo DataGrid Windows Form è specificamente progettato per la visualizzazione di informazioni di un'origine dati. Il controllo viene associato in fase di esecuzione chiamando il metodo SetDataBinding. Sebbene sia possibile visualizzare dati da numerose origini dati, quelle più comuni sono i dataset e le visualizzazioni dati.

Per eseguire l'associazione dati del controllo DataGrid a livello di codice

  1. Aggiungere codice per il riempimento del dataset.

    Se l'origine dati è un dataset o una visualizzazione dati basata su una tabella di dataset, aggiungere codice al form per riempire il dataset.

    L'esatto codice utilizzato dipende da dove il dataset ottiene i dati. Se il dataset viene popolato direttamente da un database, verrà chiamato il metodo Fill di un adattatore dati, come nell'esempio riportato di seguito, nel quale viene popolato un dataset denominato DsCategories1:

    sqlDataAdapter1.Fill(DsCategories1)
    
    sqlDataAdapter1.Fill(DsCategories1);
    
    sqlDataAdapter1->Fill(dsCategories1);
    

    Se la compilazione del dataset avviene da un servizio Web XML, verrà normalmente creata un'istanza del servizio nel codice e verrà chiamato uno dei relativi metodi per restituire un dataset. Quindi, il dataset del servizio Web XML verrà unito al dataset locale. Nell'esempio riportato di seguito viene illustrato come creare un'istanza di un servizio Web XML denominato CategoriesService, come chiamare il metodo GetCategories corrispondente e come unire il dataset risultante a un dataset locale, denominato DsCategories1:

    Dim ws As New MyProject.localhost.CategoriesService()
    ws.Credentials = System.Net.CredentialCache.DefaultCredentials
    DsCategories1.Merge(ws.GetCategories())
    
    MyProject.localhost.CategoriesService ws = new MyProject.localhost.CategoriesService();
    ws.Credentials = System.Net.CredentialCache.DefaultCredentials;
    DsCategories1.Merge(ws.GetCategories());
    
    MyProject::localhost::CategoriesService^ ws = 
       new MyProject::localhost::CategoriesService();
    ws->Credentials = System::Net::CredentialCache::DefaultCredentials;
    dsCategories1->Merge(ws->GetCategories());
    
  2. Chiamare il metodo SetDataBinding del controllo DataGrid, passando l'origine dati e un membro dati. Nel caso non fosse necessario passare un membro dati in modo esplicito, passare una stringa vuota.

    Nota

    Se si sta eseguendo l'associazione della griglia per la prima volta, è possibile impostare le proprietà DataSource e DataMember del controllo. non sarà però più possibile reimpostarle, una volta eseguita l'operazione. Si consiglia quindi di utilizzare sempre il metodo SetDataBinding.

    Nell'esempio seguente viene illustrato come effettuare l'associazione a livello di codice alla tabella Customers in un dataset denominato DsCustomers1:

    DataGrid1.SetDataBinding(DsCustomers1, "Customers")
    
    DataGrid1.SetDataBinding(DsCustomers1, "Customers");
    
    dataGrid1->SetDataBinding(dsCustomers1, "Customers");
    

    Se la tabella Customers è l'unica tabella del dataset, sarà possibile, in alternativa, associare la griglia nel modo che segue:

    DataGrid1.SetDataBinding(DsCustomers1, "")
    
    DataGrid1.SetDataBinding(DsCustomers1, "");
    
    dataGrid1->SetDataBinding(dsCustomers1, "");
    
  3. Se lo si desidera, aggiungere alla griglia gli stili di tabella e di colonna appropriati. Se non è presente alcun stile di tabella, la tabella verrà ugualmente visualizzata, ma con una formattazione minima e con tutte le colonne visibili.

Vedere anche

Attività

Procedura: aggiungere tabelle e colonne al controllo DataGrid Windows Form

Riferimenti

Cenni preliminari sul controllo DataGrid (Windows Form)

Altre risorse

Controllo DataGrid (Windows Form)

Associazione ai dati di Windows Form