GetEventsType Classe

Definição

Namespace:

ExchangeWebServices

Assembly:

EWS.dll

A GetEventsType classe representa uma solicitação para obter eventos para uma assinatura de notificação pull.

public ref class GetEventsType : ExchangeWebServices::BaseRequestType

public class GetEventsType : ExchangeWebServices.BaseRequestType

Public Class GetEventsType
Inherits BaseRequestType

Herança

Object

BaseRequestType

GetEventsType

Exemplos

O exemplo a seguir mostra como compor uma solicitação para obter os eventos para uma assinatura de notificação pull. A marca d'água usada para compilar a solicitação deve ser a última marca d'água retornada na última chamada GetEvents ou, se essa for a primeira chamada GetEvents, a marca d'água da resposta assinar. A marca d'água do último evento deve ser salva para ser usada para a próxima chamada para 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 obter mais informações sobre notificações por pull, consulte Aplicativo de exemplo de notificação por push.

Comentários

Alterações em itens de calendário podem resultar na geração de vários eventos. As operações em outros itens também podem gerar vários eventos de baixo nível. Esses eventos são o resultado da criação de itens temporários na caixa de correio e alterações em itens de armazenamento de dados gratuitos/ocupados como parte das operações de calendário usuais ou ambos. Eventos para iPM da classe de item. SchedulePlus.FreeBusy.BinaryData deve ser ignorado pelos clientes dos serviços Web. Esses itens temporários são excluídos após serem criados. Se for feita uma tentativa de recuperar esses itens, será retornado um erro que afirma que o item não foi encontrado.

Construtores

GetEventsType()

O GetEventsType construtor inicializa uma nova instância da GetEventsType classe.

Propriedades

SubscriptionId	A SubscriptionId propriedade obtém ou define o identificador de uma assinatura. Esta propriedade é obrigatória. Esta é uma propriedade de leitura/gravação.
Watermark	A Watermark propriedade obtém ou define uma cadeia de caracteres que representa um indicador de evento na fila de eventos da caixa de correio. Esta propriedade é obrigatória. Esta é uma propriedade de leitura/gravação.