Click here to Skip to main content
Click here to Skip to main content

Programming With Exchange Server 2007 (EWS) - Part 1

, 28 Aug 2008 CPOL
Rate this:
Please Sign up or sign in to vote.
This article is the first part of the series on EWS which explores Exchange Web Services

Introduction

Recently I worked on a custom MailClient project. In that, we used EWS API provided by Exchange Server 2007 which is fairly new. During development, we faced many problems. On the Internet, you will get a lot of results but they are really scattered and some of them are missing. Here I want to share my knowledge with all of you and try to provide all the required information and sample code in this series. In every part, I'll take one functionality and try to explore that. Any suggestion will be highly appreciated.

What Is Exchange Server?

Exchange Server is a messaging system that includes Mail Server, e-mail client and GroupWare application. Exchange Server is generally used with Microsoft Outlook and tightly integrated with Active Directory and Instant Messenger.

Messaging System comprises creation, storage, maintenance of different kinds of messages like email, voice mail, fax, images, etc.

Exchange Server API's History

exchange11.JPG

What is Exchange Web Services

EWS (Exchange Web Services) is an Application Programming Interface which can be used by different developers to communicate with Microsoft Exchange Server 2007.

This API is exposed as SOAP (Simple object Access Protocol)- based Web-service, which means a requester must send their request in an XML form using SOAP to EWS contained in an HTTP POST request. EWS itself responds in the same manner using SOAP and XML messages in the HTTP response object. EWS is exposed on a Exchange Client Access Server (CAS) through an ASP.NET 2.0 Web service. This can be represented pictorially as follows:

Exchange22.JPG
Client talking SOAP + XML to EWS

Special Features

  • Efficient access to Outlook PIM objects
  • Notifications and events
  • Synchronization
  • Availability service
  • Autodiscover service
  • E-mail Lifecycle
  • OWA WebParts

How to Use EWS

Most Web services publish a “Contract” of sorts that tell those on the outside what the service can do and how to communicate with it. EWS exposes this contract as a standard Web Services Description Languages (WSDL) document named services.wsdl which resides in the same directory as Web service. One can look into it.

To use it “Add a Web Reference to your project”. It may ask you to supply your credentials, so go ahead if prompted.

Note: Certificate Issues - depending on the nature of the certificate that the Exchange CAS provides to Visual Studio, It might complain that the certificate is untrusted and disable the Add Reference button, so you need to install this certificate.

Now you are ready to use the EWS in your application.

Here, I will take one method exposed by EWS and try to explore it.

Using the Code

How to Send a Mail - Normal Mail

The sample code is like this:

public void SendMessage(
string subject,
string body,
string toEmailAddress)
{
 // Set the version, credentials, and the Client Access server on ExchangeServiceBinding.
    ExchangeServiceBinding esb = new ExchangeServiceBinding();
    esb.Credentials = new NetworkCredential("user2", "password", "domain");
    esb.Url = "https://www.example.com/ews/exchange.asmx";

// Create a CreateItem request object
CreateItemType request = new CreateItemType();

// Setup the request:
// Indicate that we only want to send the message. No copy will be saved.
request.MessageDisposition = MessageDispositionType.SendOnly;
request.MessageDispositionSpecified = true;

// Create a message object and set its properties
MessageType message = new MessageType();
message.Subject = subject;
message.Body = new BodyType();
message.Body.BodyType1 = BodyTypeType.Text;
message.Body.Value = body;
message.ToRecipients = new EmailAddressType[1];
message.ToRecipients[0] = new EmailAddressType();
message.ToRecipients[0].EmailAddress = toEmailAddress;
message.ToRecipients[0].RoutingType = "SMTP"; 

//There are some more properties in MessageType object 
//you can set all according to your requirement
// Construct the array of items to send
request.Items = new NonEmptyArrayOfAllItemsType();
request.Items.Items = new ItemType[1];
request.Items.Items[0] = message;

// Call the CreateItem EWS method.
CreateItemResponseType response = esb.CreateItem(request);
this.ThrowOnError("SendMessage", response.ResponseMessages.Items[0]);
}

How to Send a Mail with Attachment

To send mail with attachment:

  1. Create a MessageType object using CreateItem
  2. Add the attachments using CreateItem
  3. Send the message using SendItem

Creating a messageType Object using CreateItem

public ItemIdType CreateMessage(
string subject,
string body,
string toEmailAddress)
{
 // Set the version, credentials, and the Client Access server on ExchangeServiceBinding.
    ExchangeServiceBinding esb = new ExchangeServiceBinding();
    esb.Credentials = new NetworkCredential("user2", "password", "domain");
    esb.Url = https://www.example.com/ews/exchange.asmx;

// Create a CreateItem request object
CreateItemType request = new CreateItemType();

// Setup the request:
// Indicate that we only want to send the message. No copy will be saved.
request.MessageDisposition = MessageDispositionType.SaveOnly;
request.MessageDispositionSpecified = true;

// Create a message object and set its properties
MessageType message = new MessageType();
message.Subject = subject;
message.Body = new BodyType();
message.Body.BodyType1 = BodyTypeType.Text;
message.Body.Value = body;

message.ToRecipients = new EmailAddressType[1];
message.ToRecipients[0] = new EmailAddressType();
message.ToRecipients[0].EmailAddress = toEmailAddress;
message.ToRecipients[0].RoutingType = "SMTP";

//Note: Same you can set CC and BCC Recipients

// Construct the array of items to send
request.Items = new NonEmptyArrayOfAllItemsType();
request.Items.Items = new ItemType[1];
request.Items.Items[0] = message;

// Call the CreateItem EWS method.
CreateItemResponseType response = esb.CreateItem(request);
this.ThrowOnError("SendMessage", response.ResponseMessages.Items[0]);
}   

Adding the Attachments

public ItemIdType CreateAttachment(string name,string FilePath, ItemIdType p_signalId)
{
 ExchangeServiceBinding esb = new ExchangeServiceBinding();
    esb.Credentials = new NetworkCredential("user2", "password", "domain");
    esb.Url = "https://www.example.com/ews/exchange.asmx";

FileAttachmentType fileAttachment = null;

//Create add attachment request.
CreateAttachmentType attachementRequest = new CreateAttachmentType();

attachementRequest.ParentItemId = p_signalId;
attachementRequest.Attachments = new AttachmentType[intAttachmentsCount];

fileAttachment = new FileAttachmentType();
MessageBDO.AttachmentsDTRow drowAttachment
= (MessageBDO.AttachmentsDTRow)p_signal.AttachmentsDT.Rows[intIndex];

fileAttachment.Name =name;
fileAttachment.ContentType = "text/plain";
fileAttachment.Content = System.IO.File.ReadAllBytes(FilePath);
attachementRequest.Attachments[intIndex] = fileAttachment;

ItemIdType attachmentItemId = new ItemIdType();
CreateAttachmentResponseType response = 
	(CreateAttachmentResponseType)_esb.CreateAttachment(attachementRequest );
if (response.ResponseMessages.Items[0].ResponseClass == ResponseClassType.Success)
{
AttachmentIdType attachmentId = ((AttachmentInfoResponseMessageType)
	response.ResponseMessages.Items[0]).Attachments[0].AttachmentId;
attachmentItemId.ChangeKey = attachmentId.RootItemChangeKey.ToString();
attachmentItemId.Id = attachmentId.RootItemId.ToString();
}
return attachmentItemId;
}

Now Sending the Mail

 //Here the itemID is returned by the CreateMessage Function         
public bool SendMessage(ItemIdType p_itemId)
 {
 bool blnResult = false;
 SendItemType siSendItem = new SendItemType();
 siSendItem.ItemIds = new BaseItemIdType[1];
 siSendItem.SavedItemFolderId = new TargetFolderIdType();
 DistinguishedFolderIdType siSentItemsFolder = new DistinguishedFolderIdType();
 siSentItemsFolder.Id = DistinguishedFolderIdNameType.sentitems;
 siSendItem.SavedItemFolderId.Item = siSentItemsFolder;
 siSendItem.SaveItemToFolder = true;
 
 siSendItem.ItemIds[0] = (BaseItemIdType)p_itemId;
 SendItemResponseType srSendItemResponseMessage = _esb.SendItem(siSendItem);
 if (srSendItemResponseMessage.ResponseMessages.Items[0].ResponseClass == 
	ResponseClassType.Success)
 {
 blnResult = true;
 }
 else
 {
 blnResult = false;
 }
 return blnResult;
 }  

Reference

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Brij
Software Developer (Senior)
India India
Brij is a 3-times Microsoft MVP in ASP.NET/IIS Category and a passionate .NET developer. More than 6 years of experience in IT field, currently serving a MNC as a Tech Lead/Architect.
 
He is a very passionate .NET developer and have expertise over Web technologies like ASP.NET 2.0/3.5/4.0, jQuery, JSON, Javascript, IIS and related technologies. He is also a Exchange Server (EWS) Specialist. He has great experience in design patterns and N-Tier Architecture.
 
He is also certified as Microsoft Certified Technologies Specialist-ASP.NET and Microsoft Certified Technologies Specialist-WCF in .NET 4.0. He has also received several awards at various forums and his various articles got listed as "Article of the day" at ASP.NET Microsoft Official Website www.asp.net.
 
He has done MCA from NIT Durgapur and completed his graduation from Lucknow University.
 
Learning new technologies and sharing knowledge excites him most. Blogging, solving problems at various forums, helping people, keeps him busy entire day.


Visit his Blog: Brij's arena of .NET
 
Area of Expertise :
C#, ASP.NET 2.0,3.5,4.0, AJAX, JQuery, JSON, XML, XSLT, ADO.Net, WCF, Active Directory, Exchange Server 2007 (EWS), Java script, Web Services ,Win services, DotnetNuke, WSS 3.0,Sharepoint Designer, SQL Server 2000/2005/2008
Follow on   Twitter

Comments and Discussions

 
QuestionStuck on service.FindFolders Exchange 2010 EWS C# PinmemberGSShailesh12-Sep-14 1:51 
QuestionHi sir , i am stuck with this "you must add a reference to system.core assembly" PinmemberSanthosh Kumar23-Sep-13 1:45 
QuestionImages url Problem when i implement in our website(Like images url in Cid) PinmemberM@n!sh29-May-13 21:07 
QuestionCreate email with set up DateTimeCreated [modified] PinmemberИван Старцев15-May-13 0:11 
AnswerRe: Create email with set up DateTimeCreated PinmemberИван Старцев20-May-13 1:28 
QuestionSigned E-mails with PFX certificated and EWS Pinmemberfetcher14-May-13 3:29 
QuestionThe request failed with HTTP status 401: Unauthorized. PinmemberSarvesh Kushwaha23-Jan-13 2:10 
GeneralMy vote of 2 PinmemberVEMS4-Oct-12 9:51 
Questionsending mail with attachment without save is PinmemberMember 905482731-May-12 21:34 
QuestionSynching Of Contacts to a Private Database PinmemberSachin Dubey4-Apr-12 22:14 
Dear All,
 
I have an application which have users as contacts.
 
Users are just customers who buy from my web application.
 
I want to synch user database with Microsoft Exchange Contacts.
Mean i need synching between them..
 
Please advise how i go about it..
 
Many Thanks
GeneralMy vote of 1 PinmemberJosep Maria Roy15-Dec-11 20:57 
GeneralChanging From Name in Code Pinmembersupremeben18-Oct-10 6:13 
GeneralRe: Changing From Name in Code PinmentorBrij18-Oct-10 9:41 
GeneralRe: Changing From Name in Code Pinmembersupremeben18-Oct-10 10:59 
GeneralScann Inbox ??!!! Help me PinmemberFeuxxx12-Oct-10 1:37 
GeneralRe: Scann Inbox ??!!! Help me PinmentorBrij18-Oct-10 9:46 
GeneralRe: Scann Inbox ??!!! Help me PinmemberFeuxxx18-Oct-10 23:07 
Question"Request failed. The remote server returned an error: (401) Unauthorized PinmemberNehalSS14-Jul-10 21:40 
AnswerRe: "Request failed. The remote server returned an error: (401) Unauthorized PinmentorBrij18-Oct-10 9:42 
GeneralPower shell vs Web services Pinmemberviswanath_nath7-Jun-10 2:55 
GeneralNearly there PinmemberSteven Amani17-Feb-10 10:58 
GeneralRe: Nearly there PinmemberSteven Amani17-Feb-10 11:22 
GeneralRe: Nearly there PinmemberSteven Amani17-Feb-10 11:25 
GeneralRe: Nearly there PinmemberBrij18-Feb-10 9:07 
GeneralResolving Email addresses PinmemberSteven Amani16-Feb-10 10:58 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web01 | 2.8.141015.1 | Last Updated 29 Aug 2008
Article Copyright 2008 by Brij
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid