_Items.IncludeRecurrences Propriedade

Definição

Namespace:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

Retorna um bool (bool em C#) que indica True se a Items coleção deve incluir padrões de recorrência. Leitura/gravação.

public:
 property bool IncludeRecurrences { bool get(); void set(bool value); };

public bool IncludeRecurrences { get; set; }

Public Property IncludeRecurrences As Boolean

Valor da propriedade

Boolean

Comentários

Essa propriedade só terá efeito se a coleção Itens contiver compromissos e não for classificada por nenhuma propriedade diferente de Start em ordem crescente. O valor padrão é False. Use essa propriedade quando desejar recuperar todos os compromissos para uma determinada data, onde compromissos recorrentes normalmente não seriam exibidos porque elas não estiverem associadas a nenhuma data específica. Se você precisar classificar e filtrar itens de compromisso que contenham compromissos recorrentes, você deve fazê-lo nesta ordem: classificar os itens em ordem crescente, defina IncludeRecurrences como True e, em seguida, filtrar os itens. Para um exemplo de código mostrando nesta ordem, consulte o segundo exemplo abaixo. Se a coleção incluir compromissos recorrentes sem data final, a configuração da propriedade como True pode causar a coleção tenha uma contagem infinita. Certifique-se de incluir um teste para isso em qualquer loop. Você não deve usar a propriedade Count da coleção de itens ao iterar coleção Items com a propriedade IncludeRecurrence definida como True. O valor de Count será um valor indefinido.

Cuidado: a filtragem em uma lista classificada de ocorrências fará com que a propriedade IncludeRecurrences não funcione conforme o esperado. Por exemplo, a seguinte seqüência retornará todas as ocorrências do compromisso; recorrentes e não-recorrente: (1) classificar por propriedade Start (2) definir a propriedade para false (3) chamada Restrict (ou seja, o filtro).