Article ID: 310199 - Last Review: November 29, 2007 - Revision: 3.3

How to create a contact with ADO and the ExOLEDB provider by using Visual C#

View products that this article applies to.

This article was previously published under Q310199

Caution ADO and ADO MD have not been fully tested in a Microsoft .NET Framework environment. They may cause intermittent issues, especially in service-based applications or in multithreaded applications. The techniques that are discussed in this article should only be used as a temporary measure during migration to ADO.NET. You should only use these techniques after you have conducted complete testing to make sure that there are no compatibility issues. Any issues that are caused by using ADO or ADO MD in this manner are unsupported. For more information, see the following article in the Microsoft Knowledge Base:

840667 (http://support.microsoft.com/kb/840667/ ) You receive unexpected errors when using ADO and ADO MD in a .NET Framework application

Expand all | Collapse all

SUMMARY

This article describes how to create a contact with ActiveX Data Objects (ADO) and the Microsoft Exchange OLE DB (ExOLEDB) provider by using Microsoft Visual C# .

Back to the top

MORE INFORMATION

To create a contact with ADO and the EXOLEDB provider by using Visual C# , follow these steps:

Start Microsoft Visual Studio .NET or Microsoft Visual Studio 2005.
On the File menu, point to New, and then click Project.
In the Visual C# Projects types list, click Console Application.

By default, Class1.cs is created.

Note In Microsoft Visual C# 2005, click Console Application under Visual C#. By default, Program.cs is created.
Add a reference to the Microsoft ActiveX Data Objects 2.5 Library. To do so, follow these steps:
1. On the Project menu, click Add Reference.
2. Click the COM tab, locate Microsoft ActiveX Data Objects 2.5 Library, and then click Select.
  
  Note In Microsot Visual C# 2005, you do not have to click Select .
3. In the Add References dialog box, click OK.
4. If you are prompted to generate wrappers for the libraries that you selected, click Yes.
Note Microsoft Collaboration Data Objects for Exchange 2000 (CDOEX) is supported only through a COM interop.

In the code window, replace the code with the following:

using System;

namespace Samples
{
	class Class1
	{
		static void Main(string[] args)
		{
			try 
			{
                        // TODO: Replace with your item URL
			string sURL = "http:/<ExchServer>/Exchange/<UserAlias>/Contacts/Test.eml";
 			
			ADODB.Connection oCn = new ADODB.Connection();
			ADODB.Record oRc = new ADODB.Record();
			ADODB.Fields oFields;

			oCn.Provider = "exoledb.datasource";

			oCn.Open(sURL, "", "", 0);  
			if(oCn.State == 1)
			{
				Console.WriteLine("Connection Successful");
			}
			else
			{
				Console.WriteLine("Connection Unsuccessful");
				return;
			}			
			
			oRc.Open(sURL, oCn, 
				ADODB.ConnectModeEnum.adModeReadWrite, 
				ADODB.RecordCreateOptionsEnum.adCreateNonCollection,
				ADODB.RecordOpenOptionsEnum.adOpenRecordUnspecified,
				"", "");
			
			oFields = oRc.Fields;

			oFields["DAV:contentclass"].Value = "urn:content-classes:person";
			oFields["http://schemas.microsoft.com/exchange/outlookmessageclass"].Value = "IPM.Contact";
			oFields["urn:schemas:contacts:cn"].Value = "David Jones";
			oFields["urn:schemas:contacts:nickname"].Value = "Dave";
			oFields["urn:schemas:contacts:title"].Value = "Engineer";
			oFields["urn:schemas:contacts:department"].Value = "Department Name";
			oFields["urn:schemas:contacts:email1"].Value = "someone@example.com";

			
			oFields.Update();


			oCn = null;
			oRc = null;
			oFields = null;
			}
			catch (Exception e)
			{
				Console.WriteLine("{0} Exception caught.", e);
			}			
		}
        }
}