GetEventsType Klasse

Referenz

Definition

Namespace:: ExchangeWebServices

Assembly:: EWS.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Die GetEventsType -Klasse stellt eine Anforderung zum Abrufen von Ereignissen für ein Pullbenachrichtigungsabonnement dar.

public ref class GetEventsType : ExchangeWebServices::BaseRequestType

public class GetEventsType : ExchangeWebServices.BaseRequestType

Public Class GetEventsType
Inherits BaseRequestType

Vererbung: Object

BaseRequestType
GetEventsType

Beispiele

Das folgende Beispiel zeigt, wie Sie eine Anforderung zum Abrufen der Ereignisse für ein Pullbenachrichtigungsabonnement erstellen. Das Zum Erstellen der Anforderung verwendete Wasserzeichen muss das letzte Wasserzeichen sein, das beim letzten GetEvents-Aufruf zurückgegeben wird, oder, wenn dies der erste GetEvents-Aufruf ist, das Wasserzeichen aus der Subscribe-Antwort. Das Wasserzeichen des letzten Ereignisses sollte gespeichert werden, um für den nächsten Aufruf von GetEvents verwendet zu werden.

static void GetEvents(ExchangeServiceBinding esb)
{ 
    // Create the GetEvents request.
    GetEventsType <span class="label">request</span> = new GetEventsType();

    // Identify the subscription identifier and watermark for the subscription 
    // that will be polled for changes in the Exchange store.
<span class="label">request</span>.SubscriptionId = "2448550a-4685-412c-bc40-62f0999a8bdb";
<span class="label">request</span>.Watermark = "AQAAAM/SnQORsD1IqTUHelGT0oxxHQAAAAAAAAE=";

    // Send the request and get the response.
    GetEventsResponseType response = esb.GetEvents(<span class="label">request</span>);
    ArrayOfResponseMessagesType aormt = response.ResponseMessages;
    ResponseMessageType[] rmta = aormt.Items;

    foreach (ResponseMessageType rmt in rmta)
    {
        // Determine whether the request was a success.
        if (rmt.ResponseClass == ResponseClassType.Success)
        {
            // Cast to appropriate response message type.
            GetEventsResponseMessageType responseMessage = (rmt as GetEventsResponseMessageType);

            // Get the notifications.
            NotificationType notification = responseMessage.Notification;
            BaseNotificationEventType[] bneta = notification.Items;

            foreach (BaseNotificationEventType bnet in bneta)
            {
                // TODO: Handle each notification. Refer to the Push Notification 
                //       sample for an example of how to do this.
            }

            if (notification.MoreEvents)
            {
                // TODO: Call GetEvents again with the watermark to get the
                //       remaining events.
            }
        }
    }
}

Weitere Informationen zu Pullbenachrichtigungen finden Sie unter Beispielanwendung für Pushbenachrichtigungen.

Hinweise

Änderungen an Kalenderelementen können zur Generierung mehrerer Ereignisse führen. Vorgänge für andere Elemente können auch mehrere Ereignisse auf niedriger Ebene generieren. Diese Ereignisse sind das Ergebnis der Erstellung temporärer Elemente im Postfach und Änderungen an Frei/Gebucht-Datenspeicherelementen im Rahmen der üblichen Kalendervorgänge oder beides. Ereignisse für die Elementklasse IPM. SchedulePlus.FreeBusy.BinaryData sollte von Webdienstclients ignoriert werden. Diese temporären Elemente werden gelöscht, nachdem sie erstellt wurden. Wenn versucht wird, diese Elemente abzurufen, wird ein Fehler zurückgegeben, der besagt, dass das Element nicht gefunden wurde.

Konstruktoren

GetEventsType()

Der GetEventsType Konstruktor initialisiert eine neue Instanz der GetEventsType -Klasse.

Eigenschaften

SubscriptionId	Die SubscriptionId -Eigenschaft ruft den Bezeichner eines Abonnements ab oder legt diese fest. Diese Eigenschaft ist erforderlich. Dies ist eine Lese-/Schreibeigenschaft.
Watermark	Die Watermark -Eigenschaft ruft eine Zeichenfolge ab, die ein Ereignislesezeichen in der Postfachereigniswarteschlange darstellt, oder legt diese fest. Diese Eigenschaft ist erforderlich. Dies ist eine Lese-/Schreibeigenschaft.

Gilt für:

Freigeben über