Courrier électronique et les services EWS d'ExchangeEmail and EWS in Exchange

Découvrez comment utiliser les messages électroniques, y compris comment créer un courrier électronique et effectuer d’autres tâches liées à la messagerie à l’aide de l’API managée EWS ou d’EWS dans Exchange.Find out how to work with email messages, including how to create an email and how to perform other email-related tasks by using the EWS Managed API or EWS in Exchange.

Exchange est à la base du courrier électronique.At its core, Exchange is about email. Qu’est-ce qu’un courrier électronique ?But what makes an email an email? Eh bien, les messages électroniques sont l’un des éléments fortement typés dans Exchange, ce qui signifie qu’ils contiennent un ensemble particulier de propriétés, même avant leur envoi.Well, email messages are one of the strongly typed items in Exchange, which means that they contain a particular set of properties, even before they're sent. Les messages électroniques sont représentés par la classe EmailMessage dans l’API managée EWS et par l’élément message et ses éléments enfants dans EWS.Email messages are represented by the EmailMessage class in the EWS Managed API and by the Message element and its child elements in EWS.

Dans l’API managée EWS, l’objet EmailMessage est dérivé de l’objet Item .In the EWS Managed API, the EmailMessage object derives from the Item object. La classe EmailMessage étend la classe Item en fournissant des propriétés supplémentaires, telles que EmailMessage. sender et EmailMessage. IsRead, qui sont désormais communes à presque tous les scénarios de messagerie.The EmailMessage class extends the Item class by providing additional properties like EmailMessage.Sender and EmailMessage.IsRead, which are now common to nearly all messaging scenarios. Lorsque vous obtenez, mettez à jour ou supprimez un message électronique, dans la plupart des cas, vous pouvez le faire à l’aide de l’objet EmailMessage ou de l’objet d' élément de base, selon que les propriétés que vous utilisez sont dans la EmailMessageSchema ou la classe ItemSchema .When you get, update, or delete an email message, in most cases you can do that by using the EmailMessage object or the base Item object, depending on whether the properties you're working with are in the EmailMessageSchema or the ItemSchema class. La création d’élément est différente étant donné que la classe d' élément n’a pas de constructeur, ainsi, lorsque vous créez un message électronique, vous utiliserez le constructeur EmailMessage pour le créer et les méthodes EmailMessage. Save ou EmailMessage. méthodesendandsavecopy pour l’enregistrer, ou l’envoyer et l’enregistrer.Item creation is different because the Item class does not have a constructor, so when you're creating an email, you'll use the EmailMessage constructor to create it and the EmailMessage.Save or EmailMessage.SendAndSaveCopy methods to save it, or send it and save it.

De même, dans EWS, utilisez l’opération CreateItem avec l’élément message pour créer un message électronique.Similarly, in EWS, use the CreateItem operation with the Message element to create an email message. Pour obtenir, mettre à jour ou supprimer des courriers électroniques à l’aide d’EWS, le fait que l’élément en cours de modification soit un message électronique n’est pas important, hormis le fait que des propriétés supplémentaires sont disponibles pour les messages électroniques.To get, update, or delete emails by using EWS, the fact that the item being modified is an email message is not important, aside from the fact that additional properties are available on email messages. Les mêmes opérations utilisées pour d’autres éléments fortement typés sont également utilisées pour les messages électroniques.The same operations that are used for other strongly typed items are also used for email messages.

TâcheTask Méthode d'API managée EWSEWS Managed API method Opération EWSEWS operation
CréerCreate
EmailMessage. SaveEmailMessage.Save
CreateItemCreateItem
ObtenirGet
EmailMessage. bindEmailMessage.Bind
GetItemGetItem
UpdateUpdate
Item.UpdateItem.Update
UpdateItemUpdateItem
SupprimerDelete
Item.DeleteItem.Delete
DeleteItemDeleteItem

Étant donné que les messages électroniques sont simplement des éléments fortement typés, dans certains cas, vous les utilisez de la même manière que pour les éléments génériques.Because email messages are simply strongly typed items, in some cases you work with them in the same way that you work with generic items.

Créer un message électronique à l’aide de l’API managée EWSCreate an email message by using the EWS Managed API

Vous pouvez créer un message électronique à l’aide de la méthode Save de l’API managée EWS, comme illustré dans le code de l’exemple suivant.You can create an email message by using the EWS Managed API Save method, as shown in the code in the following example. Notez que l’exemple enregistre uniquement le message dans le dossier Brouillons, il n’envoie pas le message.Note that the example only saves the message in the Drafts folder, it does not send the message. Pour plus d’informations sur la façon d’envoyer le message ou de créer et d’envoyer le message en une seule étape, consultez la rubrique Envoyer des messages électroniques à l’aide d’EWS dans Exchange.For information about how to send the message or create and send the message in one step, see Send email messages by using EWS in Exchange.

Cet exemple suppose que le service est un objetExchangeService valide et que l’utilisateur a bien été authentifié pour un serveur Exchange.This example assumes that service is a valid ExchangeService object and that the user has been authenticated to an Exchange server.

// Create a new email message.
EmailMessage message = new EmailMessage(service);
// Set properties on the email message.
message.ToRecipients.Add("mack@contoso.com");
message.Subject = "Project priorities";
message.Body = "(1) Buy pizza, (2) Eat pizza";
// Save the email message to the Drafts folder (where it can be retrieved, updated, and sent at a later time).
// This method call results in a CreateItem call to EWS.
message.Save(WellKnownFolderName.Drafts);
Console.WriteLine("A draft email message with the subject '" + message.Subject + "' has been saved to the Drafts folder.");

Créer un message électronique à l’aide d’EWSCreate an email message by using EWS

Vous pouvez créer un message électronique à l’aide de l’opération CREATEITEM EWS, comme illustré dans l’exemple suivant.You can create an email message by using the EWS CreateItem operation, as shown in the following example. Il s’agit également de la demande XML que l’API managée EWS envoie lorsque vous créez un message électronique.This is also the XML request that the EWS Managed API sends when you create an email message. Notez que l’exemple suivant enregistre uniquement le message dans le dossier Brouillons, il n’envoie pas le message.Note that the following example only saves the message in the Drafts folder, it does not send the message. Pour plus d’informations sur l’envoi du message ou sur la création et l’envoi du message dans un Ste, voir Envoyer des messages électroniques à l’aide d’EWS dans Exchange.For information about how to send the message or create and send the message in one ste, see Send email messages by using EWS in Exchange.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <t:RequestServerVersion Version="Exchange2010_SP2" />
  </soap:Header>
  <soap:Body>
    <m:CreateItem MessageDisposition="SaveOnly">
      <m:SavedItemFolderId>
        <t:DistinguishedFolderId Id="drafts" />
      </m:SavedItemFolderId>
      <m:Items>
        <t:Message>
          <t:Subject>Project priorities</t:Subject>
          <t:Body BodyType="HTML">(1) Buy pizza, (2) Eat pizza</t:Body>
          <t:ToRecipients>
            <t:Mailbox>
              <t:EmailAddress>mack@contoso.com</t:EmailAddress>
            </t:Mailbox>
          </t:ToRecipients>
        </t:Message>
      </m:Items>
    </m:CreateItem>
  </soap:Body>
</soap:Envelope>

Le serveur répond à la demandeCreateItem par un message GetItemResponse, qui inclut ResponseCode renvoyant la valeur NoError, indiquant que le message a bien été créé, et où apparaît l’élément ItemId du nouveau message.The server responds to the CreateItem request with a CreateItemResponse message that includes a ResponseCode value of NoError, which indicates that the email was created successfully, and the ItemId of the newly created message.

Obtenir, mettre à jour et supprimer un message électronique à l’aide de l’API managée EWSGet, update, and delete an email message by using the EWS Managed API

Vous pouvez utiliser l’API managée EWS pour obtenir, mettre à jour ou supprimer un message électronique de la même façon que vous effectuez ces actions sur n’importe quel élément générique de la Banque d’aide Exchange.You can use the EWS Managed API to get, update, or delete an email message in the same way that you perform these actions on any generic item from the Exchange store. Pour plus d’informations, consultez la rubrique utilisation des éléments de boîte aux lettres Exchange à l’aide d’EWS dans Exchange.For more information, see Work with Exchange mailbox items by using EWS in Exchange.

Si vous mettez à jour un message électronique, consultez la rubrique Propriétés et éléments de messagerie dans EWS dans Exchange pour obtenir la liste des propriétés d’un message électronique accessible en écriture.If you're updating an email message, see Email properties and elements in EWS in Exchange for a list of writable email message properties. Pour envoyer un brouillon de message une fois que vous l’avez mis à jour, consultez la rubrique envoyer un brouillon de message électronique à l’aide de l’API managée EWS.To send a draft message after you've updated it, see Send a draft email message by using the EWS Managed API.

Obtenir, mettre à jour et supprimer un message électronique à l’aide d’EWSGet, update, and delete an email message by using EWS

Vous pouvez utiliser EWS pour obtenir, mettre à jour et supprimer un message électronique de la même façon que vous effectuez ces actions sur n’importe quel élément générique de la Banque d’aide Exchange.You can use EWS to get, update, and delete an email message in the same way that you perform these actions on any generic item from the Exchange store. Pour plus d’informations, consultez la rubrique utilisation des éléments de boîte aux lettres Exchange à l’aide d’EWS dans Exchange.For more information, see Work with Exchange mailbox items by using EWS in Exchange.

Si vous mettez à jour un message électronique, consultez la rubrique Propriétés et éléments de messagerie dans EWS dans Exchange pour obtenir la liste des propriétés d’un message électronique accessible en écriture.If you're updating an email message, see Email properties and elements in EWS in Exchange for a list of writable email message properties. Pour envoyer un brouillon de message une fois que vous l’avez mis à jour, consultez la rubrique envoyer un brouillon de message électronique à l’aide d’EWS.To send a draft message after you've updated it, see Send a draft email message by using EWS.

Dans cette sectionIn this section

Voir aussiSee also