GetEventsType Classe

Referência

Definição

Namespace:: ExchangeWebServices

Assembly:: EWS.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

O GetEventsType classe representa uma solicitação para obter eventos para uma inscrição de notificação de recepção.

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 redigir uma solicitação para obter os eventos para uma inscrição de notificação de recepção. A marca d'água que é usada para criar a solicitação deve ser a última marca d'água retornada na última chamada de GetEvents ou, se essa for as primeira GetEvents chamada, a marca d'água na resposta da inscrição. A marca d'água do último evento deve ser salvas para ser usado para a próxima chamada ao 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 notificaton = responseMessage.Notification;
            BaseNotificationEventType[] bneta = notificaton.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 (notificaton.MoreEvents)
            {
                // TODO: Call GetEvents again with the watermark to get the
                //       remaining events.
            }
        }
    }
}

Para obter mais informações sobre as notificações de recepção, consulte o aplicativo de amostra de notificação de Push.

Comentários

Alterações nos itens de calendário podem resultar na geração de vários eventos. Operações em outros itens também podem gerar vários eventos de nível inferior. Esses eventos são o resultado da criação de itens temporários na caixa de correio e alterações livre/ocupado itens de armazenamento de dados como parte das operações de calendário usuais, ou ambos. Eventos para a classe de item IPM. SchedulePlus.FreeBusy.BinaryData devem ser ignorados por clientes de serviços Web. Esses itens temporários são excluídos depois que eles são criados. Se for feita uma tentativa para 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 do GetEventsType classe.

Propriedades

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

Aplica-se a