How to use the CDOEX Library to create a contact by using an Item object in Visual C# (310200)



The information in this article applies to:

  • Microsoft Visual C# .NET (2003)
  • Microsoft Visual C# .NET (2002)
  • ActiveX Data Objects (ADO) 2.5
  • ActiveX Data Objects (ADO) 2.6
  • ActiveX Data Objects (ADO) 2.7
  • Collaboration Data Objects for Exchange 2000
  • Microsoft Exchange 2000 Server
  • Microsoft Visual C# 2005

This article was previously published under Q310200

SUMMARY

This article describes how to use the Microsoft Collaboration Data Objects (CDO) for Exchange 2000 (CDOEX) Library to create a contact by using an Item object in Microsoft Visual C#.

MORE INFORMATION

To use the CDOEX Library to create a contact by using an Item object in Visual C#, follow these steps:
  1. Start Microsoft Visual Studio .NET or Microsoft Visual Studio 2005.
  2. On the File menu, point to New, and then click Project.
  3. In the Visual C# Projects types list, click Console Application.

    By default, Class1.cs is created.

    Note In Visual Studio 2005, click Console Application in the Visual C# list. By default, Program.cs is created.
  4. Add a reference to the CDOEX Library. To do so, follow these steps:
    1. On the Project menu, click Add Reference.
    2. Click the COM tab, locate Microsoft CDO for Exchange 2000 Library, and then 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 CDOEX is supported only through a COM interop.
  5. If Visual Studio .NET or Visual Studio 2005 does not add a reference to the Microsoft ActiveX Data Objects 2.5 Library, repeat step 4 to add a reference to it.
  6. In the code window, replace the code with the following:
    using System;
    
    namespace Samples
    {
    	class Class1
    	{
    		static void Main(string[] args)
    		{
    			try 
    			{
    			CDO.Item oItem = new CDO.Item();
    
                            // TODO: Replace with your folder URL
    			string sURL = "http://ExchServer/Exchange/UserAlias/Contacts";
    
    			ADODB.Fields oFields;	
    			oFields = oItem.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 = "DSX Messaging";
    			oFields["urn:schemas:contacts:email1"].Value = "someone@example.com";
    
    
    			oFields.Update();
    
    			oItem.DataSource.SaveToContainer(sURL, null, // has oCn or not, OK
    				ADODB.ConnectModeEnum.adModeReadWrite, 
    				ADODB.RecordCreateOptionsEnum.adCreateNonCollection, 
    				ADODB.RecordOpenOptionsEnum.adOpenSource,  
    				"", "");
    
    
    			oItem = null;
    			oFields = null;
    			}
    			catch (Exception e)
    			{
    				Console.WriteLine("{0} Exception caught.", e);
    			}			
    		}
            }
    }
  7. Search for TODO in the code, and then modify the code for your environment.
  8. Press F5 to build and to run the program.
  9. Make sure that the contact was created.

REFERENCES

For more information, visit the following MSDN Web site: For additional information, click the following article number to view the article in the Microsoft Knowledge Base:

813349 Support policy for Microsoft Exchange APIs with .NET Framework applications


Modification Type:MinorLast Reviewed:10/4/2006
Keywords:kbcode kbhowto KB310200 kbAudDeveloper