E-Mail- und EWS in Exchange

  • Artikel

Erfahren Sie mehr darüber, wie Sie mit E-Mail-Nachrichten arbeiten, z. B. wie Sie eine E-Mail-Nachricht erstellen und wie Sie andere E-Mail-bezogene Aufgaben mithilfe der EWS Managed API oder von ESW in Exchange durchführen.

In Kern dreht sich bei Exchange alles um E-Mail. Aber was macht eine E-Mail zu einer E-Mail? Nun, E-Mail-Nachrichten sind eins der stark typisierten Elemente in Exchange, was bedeutet, dass sie einen bestimmten Satz von Eigenschaften enthalten, schon bevor sie gesendet werden. E-Mail-Nachrichten werden von der Klasse EmailMessage in der EWS Managed API und vom Element Message und dessen untergeordneten Elementen in EWS dargestellt.

In der EWS Managed API wird das Objekt EmailMessage vom Objekt Item abgeleitet. Die Klasse EmailMessage erweitert die Klasse Item durch die Bereitstellung zusätzlicher Eigenschaften wie EmailMessage.Sender und EmailMessage.IsRead, die jetzt für nahezu alle Messagingszenarien typisch sind. Wenn Sie eine E-Mail-Nachricht abrufen, aktualisieren oder löschen, können Sie dies in den meisten Fällen mit dem Objekt EmailMessage oder dem Basisobjekt Item tun, je nachdem, ob sich die Eigenschaften, mit denen Sie arbeiten, in der Klasse EmailMessageSchema oder der Klasse ItemSchema befinden. Die Elementerstellung ist unterschiedlich, da die Klasse Item nicht über einen Konstruktor verfügt, deshalb verwenden Sie beim Erstellen einer E-Mail den EmailMessage-Konstruktor, um die E-Mail zu erstellen, und die Methode EmailMessage.Save oder EmailMessage.SendAndSaveCopy, um sie zu speichern oder zu senden und zu speichern.

Auf ähnliche Weise verwenden Sie in EWS den Vorgang CreateItem mit dem Element Message, um eine E-Mail-Nachricht zu erstellen. Zum Abrufen, Aktualisieren oder Löschen von E-Mails mithilfe von EWS ist die Tatsache, dass das zu ändernde Element eine E-Mail-Nachricht ist, nicht wichtig, trotz der Tatsache, dass zusätzliche Eigenschaften für E-Mail-Nachrichten verfügbar sind. Dieselben Vorgänge, die für andere stark typisierte Elemente verwendet werden, werden auch für E-Mail-Nachrichten benutzt.

Aufgabe EWS Managed API-Methode EWS-Vorgang
Erstellen
 EmailMessage.Save
CreateItem
Abrufen
 EmailMessage.Bind
GetItem
Aktualisieren
 Item.Update
UpdateItem
Löschen
 Item.Delete
DeleteItem

Da E-Mail-Nachrichten einfach stark typisierte Elemente sind, arbeiten Sie mit ihnen in einigen Fällen auf dieselbe Weise wie beim Arbeiten mit generischen Elementen.

Erstellen einer E-Mail-Nachricht mithilfe der EWS Managed API

Sie können eine E-Mail-Nachricht erstellen, indem Sie die EWS Managed API-Methode Save verwenden, wie im Code im folgenden Beispiel gezeigt. Beachten Sie, dass im Beispiel die Nachricht nur im Ordner „Entwürfe“ gespeichert wird, ohne sie zu senden. Informationen zum Senden der Nachricht oder zum Erstellen und Senden der Nachricht in einem Schritt finden Sie unter Senden von E-Mail-Nachrichten mithilfe von EWS in Exchange.

In diesem Beispiel wird davon ausgegangen, dass service ein gültiges ExchangeService-Objekt ist und dass der Benutzer mit einem Exchange-Server authentifiziert wurde.

// 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.");

Erstellen einer E-Mail-Nachricht mithilfe von EWS

Sie können eine E-Mail-Nachricht erstellen, indem Sie den EWS-Vorgang CreateItem verwenden, wie im folgenden Beispiel gezeigt. Dies ist auch die XML-Anforderung, die von der EWS Managed API gesendet wird, wenn Sie eine E-Mail-Nachricht erstellen. Beachten Sie, dass im folgenden Beispiel die Nachricht nur im Ordner „Entwürfe“ gespeichert wird, ohne sie zu senden. Informationen zum Senden der Nachricht oder zum Erstellen und Senden der Nachricht in einem Schritt finden Sie unter Senden von E-Mail-Nachrichten mithilfe von 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>

Der Server antwortet auf die CreateItem-Anforderung mit einer CreateItemResponse-Nachricht, die einen ResponseCode-Wert von NoError enthält, der darauf hinweist, dass die E-Mail erfolgreich erstellt wurde. Außerdem ist die ItemId der neu erstellten Nachricht enthalten.

Abrufen, Aktualisieren und Löschen einer E-Mail-Nachricht mithilfe der EWS Managed API

Sie können die EWS Managed API verwenden, um eine E-Mail-Nachricht auf dieselbe Weise abzurufen, zu aktualisieren oder zu löschen, in der Sie diese Aktionen für jedes generische Element aus dem Exchange-Informationsspeicher durchführen. Weitere Informationen finden Sie unter Arbeiten mit Exchange-Postfachelementen mithilfe von EWS in Exchange.

Wenn Sie eine E-Mail-Nachricht aktualisieren, finden Sie unter E-Mail-Eigenschaften und Elemente in EWS in Exchange eine Liste der schreibbaren Eigenschaften für E-Mail-Nachrichten. Informationen zum Senden eines Nachrichtenentwurfs nach dem Aktualisieren finden Sie unter Senden eines E-Mail-Nachrichtenentwurfs mithilfe der EWS Managed API.

Abrufen, Aktualisieren und Löschen einer E-Mail-Nachricht mithilfe von EWS

Sie können EWS verwenden, um eine E-Mail-Nachricht auf dieselbe Weise abzurufen, zu aktualisieren und zu löschen, in der Sie diese Aktionen für jedes generische Element aus dem Exchange-Informationsspeicher durchführen. Weitere Informationen finden Sie unter Arbeiten mit Exchange-Postfachelementen mithilfe von EWS in Exchange.

Wenn Sie eine E-Mail-Nachricht aktualisieren, finden Sie unter E-Mail-Eigenschaften und Elemente in EWS in Exchange eine Liste der schreibbaren Eigenschaften für E-Mail-Nachrichten. Informationen zum Senden eines Nachrichtenentwurfs nach dem Aktualisieren finden Sie unter Senden eines E-Mail-Nachrichtenentwurfs mithilfe von EWS.

Inhalt dieses Abschnitts

Siehe auch