A Contacts folder in an Exchange mailbox can contain items of more than one message class, such as contact items or distribution list items. This sample shows you how to use the Exchange Web Services (EWS) Managed API to retrieve items of a particular type.
This sample authenticates an email address and password entered from the console and displays the display name of all of the contact items in the Contacts folder to the console.
This sample requires the following:
- A target server that is running a version of Exchange starting with Exchange Server 2007 Service Pack 1 (SP1), including Exchange Online as part of Office 365.
- The .NET Framework 4.
- The EWS Managed API assembly file, Microsoft.Exchange.WebServices.dll. You can download the assembly from the Microsoft Download Center.
Note: This sample assumes that the assembly is in the default download directory. You will need to verify the path before you run the solution.
- Visual Studio 2010 with the Visual Web Developer and C# components and an open Visual Studio 2010 solution.
- A text editor to create and edit source code files and a command prompt window to run a .NET Framework command line compiler.
Key components of the sample
The Exchange 2013: Retrieve contact items from the Contacts folder programmatically sample contains the following files:
- Ex15DisplayContacts.sln — The Visual Studio 2010 solution file for the EX15DisplayContacts project.
- Ex15DisplayContacts.csproj — The Visual Studio 2010 project file for the DisplayContacts function.
- Ex15DisplayContacts.cs — Contains the using statements, namespace, class, and functions to retrieve contact items from the contacts folder and display them to the console.
- app.config — Contains configuration data for the Ex15DisplayContacts project.
- Authentication.csproj — The Visual Studio 2010 project file for the dependent authentication code.
- TextFileTraceListener.cs — Contains the using statements, namespace, class, and code to write the XML request and response to a text file.
- Service.cs — Contains the using statements, namespace, class, and functions necessary to acquire the ExchangeService object used in the Ex15DisplayContacts project.
- CertificateCallback.cs — Contains the using statements, namespace, class, and code to acquire an X509 certificate.
- UserData.cs — Contains the using statements, namespace, class, and functions necessary to acquire user information required by the service object.
Configure the sample
Follow these steps to configure the Exchange 2013: Retrieve contact items from the Contacts folder programmatically sample.
- Set the startup project to Ex15DisplayContacts by selecting the project in the Solution Explorer and choosing "Set as StartUp Project" from the Project menu.
- Ensure that the reference path for the Microsoft.Exchange.WebServices.dll points to where the DLL is installed on your local computer.
Build the sample
- Press F5 to build and deploy the sample.
- Run and test the sample
- Press F5 to run the sample.
- Get Started with the EWS Managed API
- Exchange 2013: Find contacts by their display names programmatically