Courrier électronique et les services EWS d'Exchange

  • Article

Découvrez comment utiliser les messages électroniques, notamment comment créer un e-mail et comment effectuer d’autres tâches liées à la messagerie à l’aide de l’API managée EWS ou EWS dans Exchange.

À la base, Exchange concerne les e-mails. Mais qu’est-ce qui fait d’un e-mail un e-mail ? 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, avant même d’être envoyés. Email messages 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.

Dans l’API managée EWS, l’objet EmailMessage dérive de l’objet Item . 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. Lorsque vous recevez, mettez à jour ou supprimez un e-mail, dans la plupart des cas, vous pouvez le faire à l’aide de l’objet EmailMessage ou de l’objet Item de base, selon que les propriétés que vous utilisez se trouvent dans la classe EmailMessageSchema ou ItemSchema . La création d’élément est différente, car la classe Item n’a pas de constructeur. Par conséquent, lorsque vous créez un e-mail, vous utilisez le constructeur EmailMessage pour le créer et les méthodes EmailMessage.Save ou EmailMessage.SendAndSaveCopy pour l’enregistrer, ou l’envoyer et l’enregistrer.

De même, dans EWS, utilisez l’opération CreateItem avec l’élément Message pour créer un e-mail. Pour obtenir, mettre à jour ou supprimer des e-mails à l’aide d’EWS, le fait que l’élément en cours de modification soit un message électronique n’est pas important, à part le fait que des propriétés supplémentaires sont disponibles sur les messages électroniques. Les mêmes opérations que celles utilisées pour d’autres éléments fortement typés sont également utilisées pour les messages électroniques.

Tâche Méthode d'API managée EWS Opération EWS
Créer
 EmailMessage.Save
CreateItem
Obtenir
 EmailMessage.Bind
GetItem
Update
 Item.Update
UpdateItem
Supprimer
 Item.Delete
DeleteItem

Étant donné que les e-mails sont simplement des éléments fortement typés, dans certains cas, vous les utilisez de la même façon que vous utilisez des éléments génériques.

Créer un e-mail à l’aide de l’API managée EWS

Vous pouvez créer un message électronique à l’aide de la méthode Save de l’API managée EWS, comme indiqué dans le code de l’exemple suivant. Notez que l’exemple enregistre uniquement le message dans le dossier Brouillons. Il n’envoie pas le 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, voir Envoyer des messages électroniques à l’aide d’EWS dans Exchange.

Cet exemple suppose que le service est un objetExchangeService valide et que l’utilisateur a bien été authentifié pour un serveur Exchange.

// 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 e-mail à l’aide d’EWS

Vous pouvez créer un message électronique à l’aide de l’opération CreateItem EWS, comme illustré dans l’exemple suivant. Il s’agit également de la requête XML que l’API managée EWS envoie lorsque vous créez un e-mail. Notez que l’exemple suivant enregistre uniquement le message dans le dossier Brouillons. Il n’envoie pas le message. Pour plus d’informations sur la façon d’envoyer le message ou de créer et d’envoyer le message dans une unité, voir Envoyer des messages électroniques à l’aide d’EWS dans 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.

Obtenir, mettre à jour et supprimer un e-mail à l’aide de l’API managée EWS

Vous pouvez utiliser l’API managée EWS pour obtenir, mettre à jour ou supprimer un e-mail de la même façon que vous effectuez ces actions sur n’importe quel élément générique à partir de la banque Exchange. Pour plus d’informations, consultez Utiliser des éléments de boîte aux lettres Exchange à l’aide d’EWS dans Exchange.

Si vous mettez à jour un message électronique, consultez Email propriétés et éléments dans EWS dans Exchange pour obtenir la liste des propriétés de message électronique accessibles en écriture. Pour envoyer un brouillon de message après l’avoir mis à jour, consultez Envoyer un brouillon de message électronique à l’aide de l’API managée EWS.

Obtenir, mettre à jour et supprimer un e-mail à l’aide d’EWS

Vous pouvez utiliser EWS pour obtenir, mettre à jour et supprimer un e-mail de la même façon que vous effectuez ces actions sur n’importe quel élément générique à partir de la banque Exchange. Pour plus d’informations, consultez Utiliser des éléments de boîte aux lettres Exchange à l’aide d’EWS dans Exchange.

Si vous mettez à jour un message électronique, consultez Email propriétés et éléments dans EWS dans Exchange pour obtenir la liste des propriétés de message électronique accessibles en écriture. Pour envoyer un brouillon de message après l’avoir mis à jour, consultez Envoyer un brouillon de message électronique à l’aide d’EWS.

Dans cette section

Voir aussi