This sample shows you how to use the Exchange Web Services (EWS) Managed API to create a custom extended property on an item.
Description of the Exchange 2013: Create custom extended properties programmatically sample
This sample authenticates an email address and password entered from the console, creates an email message with a custom extended property, and then saves the email message in the default Drafts folder.
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_CreateCustomExtendedProperties_CS.sln — The Visual Studio 2010 solution file for the Ex15_CreateCustomExtendedProperties_CS project.
-
Ex15_CreateCustomExtendedProperties_CS.csproj — The Visual Studio 2010 project file for the CreateCustomExtendedProperties function.
-
app.config — Contains configuration data for the Ex15_CreateCustomExtendedProperties_CS project.
-
Ex15_CreateCustomExtendedProperties_CS.cs — Contains the using directives, namespace, class, and functions to create an extended property on an item.
-
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 Ex15_CreateCustomExtendedProperties_CS 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: Create custom extended properties programmatically sample.
-
Set the startup project to Ex15_CreateCustomExtendedProperties_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
Change log
First release.