GetEventsType Clase

Definición

Espacio de nombres:

ExchangeWebServices

Ensamblado:

EWS.dll

La GetEventsType clase representa una solicitud para obtener eventos para una suscripción de notificación de incorporación de cambios.

public ref class GetEventsType : ExchangeWebServices::BaseRequestType

public class GetEventsType : ExchangeWebServices.BaseRequestType

Public Class GetEventsType
Inherits BaseRequestType

Herencia

Object

BaseRequestType

GetEventsType

Ejemplos

En el ejemplo siguiente se muestra cómo crear una solicitud para obtener los eventos de una suscripción de notificación de incorporación de cambios. La marca de agua que se usa para compilar la solicitud debe ser la última marca de agua que se devuelve en la última llamada a GetEvents o, si se trata de la primera llamada a GetEvents, la marca de agua de la respuesta Subscribe. La marca de agua del último evento debe guardarse para usarse para la siguiente llamada a GetEvents.

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.
            }
        }
    }
}

Para obtener más información sobre las notificaciones de incorporación de cambios, vea Aplicación de ejemplo de notificación push.

Comentarios

Los cambios en los elementos de calendario pueden dar lugar a la generación de varios eventos. Las operaciones en otros elementos también pueden generar varios eventos de bajo nivel. Estos eventos son el resultado de la creación de elementos temporales en el buzón de correo y cambios en los elementos de almacenamiento de datos de disponibilidad como parte de las operaciones habituales de Calendario, o ambas. Eventos de la clase de elemento IPM. Los clientes de servicios web deben omitir SchedulePlus.FreeBusy.BinaryData. Estos elementos temporales se eliminan después de crearlos. Si se intenta recuperar estos elementos, se devolverá un error que indica que no se encontró el elemento.

Constructores

GetEventsType()

El GetEventsType constructor inicializa una nueva instancia de la GetEventsType clase .

Propiedades

SubscriptionId	La SubscriptionId propiedad obtiene o establece el identificador de una suscripción. La propiedad es obligatoria. Se trata de una propiedad de lectura y escritura.
Watermark	La Watermark propiedad obtiene o establece una cadena que representa un marcador de eventos en la cola de eventos del buzón. La propiedad es obligatoria. Se trata de una propiedad de lectura y escritura.