ch15.htm

visual c plus plus its a book for how to learn c plus plus in just 21 days its an easy way to lea

27: END_ADO_BINDING()
28:
29: public:
30:     LONG m_lAddressID;
31:     ULONG lAddressIDStatus;
32:     CHAR m_szFirstName[51];
33:     ULONG lFirstNameStatus;
34:     CHAR m_szLastName[51];
35:     ULONG lLastNameStatus; 
36:     CHAR m_szSpouseName[51];
37:     ULONG lSpouseNameStatus;
38:     CHAR m_szAddress[256];
39:     ULONG lAddressStatus;
40:     CHAR m_szCity[51];
41:     ULONG lCityStatus;
42:     CHAR m_szStateOrProvince[21];
43:     ULONG lStateOrProvinceStatus;
44:     CHAR m_szPostalCode[21];
45:     ULONG lPostalCodeStatus;
46:     CHAR m_szCountry[51];
47:     ULONG lCountryStatus;
48:     CHAR m_szEmailAddress[51];
49:     ULONG lEmailAddressStatus;
50:     CHAR m_szHomePhone[31];
51:     ULONG lHomePhoneStatus;
52:     CHAR m_szWorkPhone[31];
53:     ULONG lWorkPhoneStatus;
54:     CHAR m_szWorkExtension[21];
55:     ULONG lWorkExtensionStatus;
56:     CHAR m_szFaxNumber[31];
57:     ULONG lFaxNumberStatus;
58:     DATE m_dtBirthdate;
59:     ULONG lBirthdateStatus;
60:     VARIANT_BOOL m_bSendCard;
61:     ULONG lSendCardStatus;
62:     CHAR m_szNotes[65536];
63:     ULONG lNotesStatus;
64: };
</PRE>
<P>Once you've created this class, you need to add a variable to the document class.
Add a new member variable to the document class, specifying the variable type as
CCustomRs, the name as m_rsRecSet, and the access as private. You'll also need to
include the custom record class header file in the document source code file, as
in Listing 15.2.</P>
<P>
<H4>LISTING 15.2. THE DOCUMENT SOURCE CODE INCLUDES.</H4>
<PRE> 1: // dbadoDoc.cpp : implementation of the CDbAdoDoc class
 2: //
</PRE>
<H3><A NAME="Heading16"></A>3:</H3>
<PRE> 4: #include &quot;stdafx.h&quot;
 5: #include &quot;dbado.h&quot;
 6:
 7: #include &quot;CustomRs.h&quot;
 8: #include &quot;dbadoDoc.h&quot;
 9: #include &quot;dbadoView.h&quot;
</PRE>
<P>Another detail that you need to attend to before going any further is providing
a way for the view to get a pointer to the record class from the document class.
This function should return a pointer to the record class variable. To add this function
to your application, add a new member function to the document class, specifying
the function type as CCustomRs*, the function declaration as GetRecSet, and the function
access as public. Edit this function, adding the code in Listing 15.3.</P>
<P>
<H4>LISTING 15.3. THE CDbAdoDoc GetRecSet FUNCTION.</H4>
<PRE> 1: CCustomRs* CDbAdoDoc::GetRecSet()
 2: {
 3:     // Return a pointer to the record object
 4:     return &amp;m_rsRecSet;
 5: }
</PRE>
<P>One last piece of functionality that you'll add before getting to the real heart
of ADO programming is the function for reporting ADO and database errors. This function
will display a message to the user, reporting that an error occurred and displaying
the error code and error message for the user. To add this function to your application,
add a new member function to your document class. Specify the function type as void,
the function declaration as GenerateError(HRESULT hr, PWSTR pwszDescription), and
the access as public. Edit the function, entering the code in Listing 15.4.</P>
<P>
<H4>LISTING 15.4. THE CDbAdoDoc GenerateError FUNCTION.</H4>
<PRE> 1: void CDbAdoDoc::GenerateError(HRESULT hr, PWSTR pwszDescription)
 2: {
 3:     CString strError;
 4:
 5:     // Format and display the error message
 6:     strError.Format(&quot;Run-time error `%d (%x)'&quot;, hr, hr);
 7:     strError += &quot;\n\n&quot;;
 8:     strError += pwszDescription;
 9:
10:     AfxMessageBox(strError);
11: }
</PRE>
<H3><A NAME="Heading17"></A>Connecting and Retrieving Data</H3>
<P>You can perform all of the connecting to the database and retrieving the record
set in the OnNewDocument function in the document class. Before you can add this
functionality, you need to add a few more variables to the document class. You'll
need a Recordset object pointer, an IADORecordBinding interface pointer, a couple
of string variables for holding the database connection string, and the SQL command
to execute to populate the record set. Add all of these variables to the document
class as specified in Table 15.3.</P>
<P>
<H4>TABLE 15.3. DOCUMENT CLASS MEMBER VARIABLES.</H4>
<P>
<TABLE BORDER="1">
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT"><I>Name</I></TD>
		<TD ALIGN="LEFT"><I>Type</I></TD>
		<TD ALIGN="LEFT"><I>Access</I></TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">m_pRs		</TD>
		<TD ALIGN="LEFT">_RecordsetPtr		</TD>
		<TD ALIGN="LEFT">Private		</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">m_piAdoRecordBinding		</TD>
		<TD ALIGN="LEFT">IADORecordBinding*		</TD>
		<TD ALIGN="LEFT">Private		</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">m_strConnection		</TD>
		<TD ALIGN="LEFT">CString		</TD>
		<TD ALIGN="LEFT">Private		</TD>
	</TR>
	<TR ALIGN="LEFT" VALIGN="TOP">
		<TD ALIGN="LEFT">m_strCmdText		</TD>
		<TD ALIGN="LEFT">CString		</TD>
		<TD ALIGN="LEFT">Private		</TD>
	</TR>
</TABLE>
</P>
<P>In the OnNewDocument function, you'll perform a series of steps for connecting
and retrieving the record set. First, you'll set the strings for the database connection
and the SQL command to be run. Next, you'll initialize the COM environment and initialize
the two pointers so that they are both NULL. You'll create the Recordset object using
the CreateInstance function. Open the Recordset, connecting to the database and running
the SQL command at the same time. Bind the record class to the record set using the
IADORecordBinding interface pointer. Finally, tell the view class to refresh the
bound data, displaying the initial record for the user using a view class function
that you'll add in a little while. To add all this functionality, edit the OnNewDocument
function in the document class, adding the code starting with line 8 in Listing 15.5.</P>
<P>
<H4>LISTING 15.5. THE CDbAdoDoc OnNewDocument FUNCTION.</H4>
<PRE> 1: BOOL CDbAdoDoc::OnNewDocument()
 2: {
 3:     if (!CDocument::OnNewDocument())
 4:         return FALSE;
 5:
 6:     // TODO: add reinitialization code here
 7:     // (SDI documents will reuse this document)
 8:     // Set the connection and SQL command strings
 9:     m_strConnection = _T(&quot;Provider=MSDASQL.1;Data Source=TYVCDB&quot;);
10:     m_strCmdText = _T(&quot;select * from Addresses&quot;);
11:
12:     // Initialize the Recordset and binding pointers
13:     m_pRs = NULL;
14:     m_piAdoRecordBinding = NULL;
15:     // Initialize the COM environment
16:     ::CoInitialize(NULL);
17:     try
18:     {
19:         // Create the record set object
20:         m_pRs.CreateInstance(__uuidof(Recordset));
21:
22:         // Open the record set object
23:         m_pRs-&gt;Open((LPCTSTR)m_strCmdText, (LPCTSTR)m_strConnection, 
24:             adOpenDynamic, adLockOptimistic, adCmdUnknown);
25:
26:         // Get a pointer to the record binding interface
27:         if (FAILED(m_pRs-&gt;QueryInterface(__uuidof(IADORecordBinding),
28:                 (LPVOID *)&amp;m_piAdoRecordBinding)))
29:             _com_issue_error(E_NOINTERFACE);
30:         // Bind the record class to the record set
31:         m_piAdoRecordBinding-&gt;BindToRecordset(&amp;m_rsRecSet);
32:
33:         // Get a pointer to the view
34:         POSITION pos = GetFirstViewPosition();
35:         CDbAdoView* pView = (CDbAdoView*)GetNextView(pos);
36:         if (pView)
37:             // Sync the data set with the form
38:             pView-&gt;RefreshBoundData();
39:     }
40:     // Any errors?
41:     catch (_com_error &amp;e)
42:     {
43:         // Display the error
44:         GenerateError(e.Error(), e.Description());
45:     }
46:
47:     return TRUE;
48: }
</PRE>
<P>Before moving any further, it's a good idea to make sure that you add all the
code necessary to clean up as your application is closing. You need to close the
record set and release the pointer to the record binding interface. You'll also shut
down the COM environment. To add all this functionality to your application, add
a function to the DeleteContents event message in the document class. Edit this function,
adding the code in Listing 15.6.</P>
<P>
<H4>LISTING 15.6. THE CDbAdoDoc DeleteContents FUNCTION.</H4>
<PRE> 1: void CDbAdoDoc::DeleteContents()
 2: {
 3:     // TODO: Add your specialized code here and/or call the base class
 4:     // Close the record set
 5:     if (m_pRs)
 6:         m_pRs-&gt;Close();
 7:     // Do we have a valid pointer to the record binding?
 8:     if (m_piAdoRecordBinding)
 9:         // Release it
10:         m_piAdoRecordBinding-&gt;Release();
11:     // Set the record set pointer to NULL
12:     m_pRs = NULL;
13:
14:     // Shut down the COM environment
15:     CoUninitialize();
16:
17:     CDocument::DeleteContents();
18: }
</PRE>
<H3><A NAME="Heading18"></A>Populating the Form</H3>
<P>To display the record column values for the user, you'll add a function for copying
the values from the record class to the view variables. This function first needs
to get a pointer to the record class from the document class. Next, it will check
the status of each individual field in the record class to make sure that it's okay
to copy, and then it will copy the value. Once all values have been copied, you can
call UpdateData to display the values in the controls on the form. To add this functionality
to your application, add a new member function to the view class. Specify the function
type as void, the function declaration as RefreshBoundData, and the access as public.
Edit this new function, adding the code in Listing 15.7.</P>
<P>
<H4>LISTING 15.7. THE CDbAdoView RefreshBoundData FUNCTION.</H4>
<PRE> 1: void CDbAdoView::RefreshBoundData()
 2: {
 3:     CCustomRs* pRs;
 4:
 5:     // Get a pointer to the document object
 6:     pRs = GetDocument()-&gt;GetRecSet();
 7:
 8:     // Is the field OK
 9:     if (adFldOK == pRs-&gt;lAddressIDStatus)
10:         // Copy the value
11:         m_lAddressID = pRs-&gt;m_lAddressID;
12:     else
13:         // Otherwise, set the value to 0
14:         m_lAddressID = 0;
15:     // Is the field OK
16:     if (adFldOK == pRs-&gt;lFirstNameStatus)
17:         // Copy the value
18:         m_strFirstName = pRs-&gt;m_szFirstName;
19:     else
20:         // Otherwise, set the value to 0
21:         m_strFirstName = _T(&quot;&quot;);
22:     if (adFldOK == pRs-&gt;lLastNameStatus)
23:         m_strLastName = pRs-&gt;m_szLastName;
24:     else
25:         m_strLastName = _T(&quot;&quot;);
26:     if (adFldOK == pRs-&gt;lSpouseNameStatus)
27:         m_strSpouseName = pRs-&gt;m_szSpouseName;
28:     else
29:         m_strSpouseName = _T(&quot;&quot;);
30:     if (adFldOK == pRs-&gt;lAddressStatus)
31:         m_strAddress = pRs-&gt;m_szAddress;
32:     else
33:         m_strAddress = _T(&quot;&quot;);
34:     if (adFldOK == pRs-&gt;lCityStatus)
35:         m_strCity = pRs-&gt;m_szCity;
36:     else
37:         m_strCity = _T(&quot;&quot;);
38:     if (adFldOK == pRs-&gt;lStateOrProvinceStatus)
39:         m_strStateOrProvince = pRs-&gt;m_szStateOrProvince;
40:     else
41:         m_strStateOrProvince = _T(&quot;&quot;);
42:     if (adFldOK == pRs-&gt;lPostalCodeStatus) 
43:         m_strPostalCode = pRs-&gt;m_szPostalCode;
44:     else
45:         m_strPostalCode = _T(&quot;&quot;);
46:     if (adFldOK == pRs-&gt;lCountryStatus)
47:         m_strCountry = pRs-&gt;m_szCountry;
48:     else
49:         m_strCountry = _T(&quot;&quot;);
50:     if (adFldOK == pRs-&gt;lEmailAddressStatus)
51:         m_strEmailAddress = pRs-&gt;m_szEmailAddress;
52:     else
53:         m_strEmailAddress = _T(&quot;&quot;);
54:     if (adFldOK == pRs-&gt;lHomePhoneStatus)
55:         m_strHomePhone = pRs-&gt;m_szHomePhone;
56:     else
57:         m_strHomePhone = _T(&quot;&quot;);
58:     if (adFldOK == pRs-&gt;lWorkPhoneStatus)
59:         m_strWorkPhone = pRs-&gt;m_szWorkPhone;
60:     else
61:         m_strWorkPhone = _T(&quot;&quot;);
62:     if (adFldOK == pRs-&gt;lWorkExtensionStatus)
63:         m_strWorkExtension = pRs-&gt;m_szWorkExtension;
64:     else
65:         m_strWorkExtension = _T(&quot;&q