This sample shows you how to use the Exchange Web Services (EWS) Managed API to access an item's property by its property tag.
Description of the Exchange 2013: Access a property by its property tag sample
This sample authenticates an email address and password entered from the console, and then searches for an item based on a property tag. We recommend that you use schematized EWS properties instead of property tags when they are available.
Prerequisites
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 The 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.
Or
-
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
This sample contains the following files:
-
Ex15_AccessPropertyByTag_CS.sln — The Visual Studio 2010 solution file for the AccessPropertyByTag project.
-
Ex15_AccessPropertyByTag_CS.csproj — The Visual Studio 2010 project file for the AccessMAPIPropertyByPropertyTag function.
-
app.config — Contains configuration data for the AccessPropertyByTag project.
-
Ex15_AccessPropertyByTag_CS.cs — Contains the using directives, namespace, class, and functions to access a property by its property tag.
-
Authentication.csproj — The Visual Studio 2010 project file for the dependent authentication code.
-
TextFileTraceListener.cs — Contains the using directives, namespace, class, and code to write the XML request and response to a text file.
-
Service.cs — Contains the using directives, namespace, class, and functions necessary to acquire an ExchangeService object used in the AccessPropertyByTag project.
-
CertificateCallback.cs — Contains the using directives, namespace, class, and code to acquire an X509 certificate.
-
UserData.cs — Contains the using directives, 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: Access a property by its property tag sample.
-
Set the startup project to Ex15_AccessPropertyByTag_CS.csproj 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 F6 to build and deploy the sample.
Run and test the sample
Press F5 to run the sample.
Related content
-
Exchange 2013: Access a property by property set GUID and name
-
Exchange 2013: Create custom extended properties programmatically
-
Exchange 2013: Delete custom extended properties programmatically
-
Exchange 2013: Update custom extended properties programmatically
-
Exchange 2013: View custom extended properties programmatically
Change log
First release.