SAMPLE: How To Retrieve XML Data Using an XPath Query with ADO in Visual C++ (271782)

MORE INFORMATION

The following file is available for download from the Microsoft Download Center:
Release Date: 10-04-2000

For additional information about how to download Microsoft Support files, click the following article number to view the article in the Microsoft Knowledge Base: Microsoft scanned this file for viruses. Microsoft used the most current virus-detection software that was available on the date that the file was posted. The file is stored on security-enhanced servers that help to prevent any unauthorized changes to the file. The XPath.exe file contains the following files:

File name	Size
EULA.txt	2 KB
AdoHeader.h	1 KB
CustomerOrder.xml	2 KB
ReadMe.txt	1 KB
resource.h	1 KB
StdAfx.cpp	1 KB
StdAfx.h	1 KB
XPath.cpp	3 KB
XPath.dsp	5 KB
XPath.dsw	1 KB
XPath.h	2 KB
XPath.rc	5 KB
XPathDlg.cpp	7 KB
XPathDlg.h	2 KB
\Res\XPath.ico	2 KB
\Res\XPath.rc2	2 KB

This sample demonstrates how to run an XPath query to output an XML stream. The sample shows how to configure an ADO Command object to run an XPath query by using the Command object's CommandText property. Alternatively, you can do this by using the CommandStream property and an input Stream as well.

Additionally, the sample provides a mapping schema file that contains mapping information between elements and attributes in the XPath query and the tables and columns contained in the back-end SQL Server 2000 relational database management system (RDBMS). The CustomerOrder.xml mapping schema file provided with this sample contains information about a SQL JOIN between the Customers and Orders tables and their columns in terms of the Customers and CustOrder elements and their attributes. All the tables are from the Northwind sample database in SQL Server 2000.

The sample does the following:

1. Sets up a connection to a valid SQL Server 2000 database:
   
   Note uid <user name> must have the appropriate permissions to perform these operations on the database.

   _bstr_t m_Conn("PROVIDER=SQLOLEDB.1;Server=SQL2000Srv;Database=Northwind;uid=<user name>;pwd=<strong password>;");
   					

2. Assigns the XPath globally unique identifier (GUID) to the ADO Command object's Dialect property:

   hr = cmd->Properties->Item[L"Mapping Schema"]- >put_Value(_variant_t(L"\\CustomerOrder.xml")); 
   					

3. Sets the ADO Command object's Mapping Schema property to point to the mapping schema file CustomerOrder.xml:

   hr = cmd->Properties->Item[L"Mapping Schema"]->put_Value(_variant_t(L"C:\\MySchemaFilePath\\CustomerOrder.xml"));
   					

4. Sets the ADO Command object's Output Stream property to an ADO Stream for retrieving the XML data:

   hr = cmd->Properties->Item[L"Output Stream"]->put_Value(_variant_t((IDispatch*) strm));
   					

5. Sets the Command object's CommandText property to the XPath query:

   // Default XPATH Query is -
   // m_XPathIn = L"/Customers/CustOrder[@CustomerID=\"ALFKI\"]";
   hr = cmd->put_CommandText(_bstr_t(m_XPathIn ));
   					

6. Runs the Command by using the adExecuteStream enumeration:

   hr = cmd->Execute(&vra,&vtEmpty,adExecuteStream);
   					

Steps to Run the Sample

1. Unzip the XPath.exe file.
2. Modify the connection string in XPathDlg.cpp to refer to a valid SQL Server 2000 database.
3. Compile and then run the application.