Click here to Skip to main content
15,867,453 members
Articles / Desktop Programming / MFC

Using MS DataGrid Control with ADO

Rate me:
Please Sign up or sign in to vote.
4.91/5 (18 votes)
2 Sep 2001CPOL3 min read 485.1K   17.5K   88   82
Use the MS DataGrid control in your C++ app with ADO

Sample Image - msdatagrid.gif

Introduction

The Microsoft DataGrid is usually seen associated with VB when you start searching for information on how to implement the MS DataGrid in Visual C++. There is not a lot of information out there and therefore many Visual C++ programmers tend not to use this excellent and easy to use database control.

This is a simple implementation that shows you how to use the MS DataGrid control with ADO. The sample has been tested with both MS Access and SQL Server, in theory, you should be able to use it against all data sources that support OLE-DB.

You can find information on the DataGrid control and its properties on MSDN.

Requirements

MDAC v2.1 or higher (this can be obtained from Microsoft). This contains the OLE DB drivers that are required to hook up to the database or the data source.

A good knowledge of ADO (ActiveX Data Object) is also required to understand the binding process to the DataGrid.

Using ADO

In order to use the ADO COM object, you will need to import the following type libraries, this should be done in your stdafx.h file.

#import msado15.dll  //This contains the ADO Type Library.
#import Oledb32.dll  //this contains the Data Source Locator COM Interface

Please note that you may need to add the full path to these DLLs or you can add the path through your visual C++ environment via:

Tools->Options->Directories->Include Files

Adding the DataGrid Control to the Project

You need to add the DataGrid control to your project, this is done in the usual way via:

Project->Add to project->Components and Controls

Select the Registered ActiveX Control folder from the dialog and find Microsoft DataGrid Control, Version 6 (OLEDB).

Registered Controls - msdatagrid2.gif

Then press the insert button, the following dialog will appear:

Insert Classes - msdatagrid3.gif

You only need the CDataGrid class for this sample, therefore check only this class.

Go to the Resource editor, you should see the MS DataGrid Control added to your collection of controls that you can use. The CDataGrid class will have been generated for you in DataGrid.h and DataGrid.CPP, these files will also have been added to your project.

Bind the DataGrid to a Dialog or Formview

Use the Class Wizard in the normal way to bind the control to a Dialog or Formview. Class wizard will bind the CDataGrid class with the control.

C++
CDataGrid m_ctlDataGrid;
void CDataGridView::DoDataExchange(CDataExchange* pDX)
{
    CFormView::DoDataExchange(pDX);
    //{{AFX_DATA_MAP(CDataGridView)
    DDX_Control(pDX, IDC_DATAGRID1, m_ctlDataGrid);
    //}}AFX_DATA_MAP
}

Bind the DataGrid to ADO

You have to bind the DataGrid at run-time using an ADO Recordset. The following code gives you the example used.

C++
void CDataGridView::UpdateGridDetails(const CString& sTableName)
{
    CMainFrame* pMainFrame = reinterpret_cast<CMAINFRAME*>(AfxGetMainWnd());
    if (pMainFrame)
    {
        m_pRS = NULL; 
        m_pRS.CreateInstance(__uuidof(Recordset));
        try  
        {
            m_pRS->CursorLocation= adUseClient;
            m_pRS->Open((LPCSTR)sTableName,(LPCSTR)pMainFrame->
                m_ptrConnection->GetConnectionString(), 
                adOpenKeyset,adLockOptimistic, adCmdTable);
        }
	    catch (_com_error &e)
        {
            AfxMessageBox(GetErrorDescription(e));
        }
	    
    	//Demonstrates, how to populate DataGrid 
    	//by assigning it a Recordset object.
	    m_ctlDataGrid.SetCaption(sTableName);
        m_ctlDataGrid.SetRefDataSource(NULL);
        m_ctlDataGrid.SetRefDataSource( (LPUNKNOWN) m_pRS );
        m_ctlDataGrid.Refresh();
	    
        UpdateData(FALSE);	
    }
}

The SetRefDataSource property is used to bind the ADO Recordset generated to the control. Please note that the type of Recordset cursor generated determines what can and cannot be done in the grid. For example, if a forward only cursor is used, then the grid will not allow you to add, edit or delete records via the grid.

Note: The client cursor location needs to be set in order for it to work with Microsoft Access (this is not required in SQL Server).

Conclusion

The MS DataGrid control is straightforward to use as long as you know ADO.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Web Developer
United Kingdom United Kingdom
Was made redundant in early 2003 after 10 years in computer programming, since then started my own business (selling computer books on the net)
www.pricecutbook.co.uk


Comments and Discussions

 
Questionhow to add combobox to DataGrid in VC++ Pin
pangziququ323-Nov-12 19:37
pangziququ323-Nov-12 19:37 
GeneralMy vote of 3 Pin
buyong10-Nov-11 21:11
buyong10-Nov-11 21:11 
Generaldao.ocx dbgrid.ocx Pin
Member 28096371-Sep-10 10:18
Member 28096371-Sep-10 10:18 
Questionadd column number in DataGrid control Pin
auliac26-Jan-10 5:58
auliac26-Jan-10 5:58 
GeneralWTL/ATL Pin
manosza10-Jan-09 21:04
manosza10-Jan-09 21:04 
QuestionMicrosoft DataGrid Control, Version 6 (OLEDB) Pin
Michael B Pliam2-Apr-08 13:28
Michael B Pliam2-Apr-08 13:28 
AnswerRe: Microsoft DataGrid Control, Version 6 (OLEDB) Pin
MartaFdez9-Dec-09 1:47
MartaFdez9-Dec-09 1:47 
GeneralRe: Microsoft DataGrid Control, Version 6 (OLEDB) Pin
Michael B Pliam11-Dec-09 14:02
Michael B Pliam11-Dec-09 14:02 
QuestionHow can you print this grid???? Pin
jani0120-Nov-07 22:13
jani0120-Nov-07 22:13 
QuestionProblem with CDataGrid Pin
kazim bhai16-Apr-07 4:16
kazim bhai16-Apr-07 4:16 
GeneralProblem with visual C++ 7.1 / 2003 Pin
kazim bhai16-Apr-07 0:03
kazim bhai16-Apr-07 0:03 
QuestionSample to work with MS Access ? Pin
bujal21-Mar-07 16:16
bujal21-Mar-07 16:16 
AnswerRe: Sample to work with MS Access ? Pin
kazim bhai15-Apr-07 23:45
kazim bhai15-Apr-07 23:45 
Search this word in Codeproject and the sample is ther
"A set of ADO classes - version 2.20"

Kazim

It is Kaz

GeneralUpdate recordset via grid. Pin
mishkaU22-Jan-06 5:06
mishkaU22-Jan-06 5:06 
GeneralData Grid Pin
Anonymous28-Aug-05 22:39
Anonymous28-Aug-05 22:39 
QuestionHow to delete one row? Pin
Anonymous2-Aug-05 2:56
Anonymous2-Aug-05 2:56 
GeneralChange the color of one cell Pin
Alundra0215-Apr-05 5:23
Alundra0215-Apr-05 5:23 
QuestionCan i add a row to datagrid? Pin
zimli30-Dec-04 22:44
zimli30-Dec-04 22:44 
Generala stupid question: why doesn't confirm dialog come out :( Pin
IsaacLitingjun23-Nov-04 18:24
IsaacLitingjun23-Nov-04 18:24 
Generalask question in a right way... Pin
IsaacLitingjun24-Nov-04 18:19
IsaacLitingjun24-Nov-04 18:19 
Generalsomething more... Pin
IsaacLitingjun24-Nov-04 19:15
IsaacLitingjun24-Nov-04 19:15 
Generala stupid question again Pin
IsaacLitingjun24-Nov-04 20:56
IsaacLitingjun24-Nov-04 20:56 
QuestionCan i click one of each field record in the datagrid and then the record apear in the text box? Pin
Anonymous23-Nov-04 16:02
Anonymous23-Nov-04 16:02 
GeneralUnable to bind the recordset to the DataGrid Pin
Brandon Jen5-Nov-04 20:03
Brandon Jen5-Nov-04 20:03 
Generali need to update records using datagrid Pin
jaisriram17-Sep-04 21:53
jaisriram17-Sep-04 21:53 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.