Objeto RecurrencePattern (Outlook)
Representa o padrão de incidência de compromissos recorrentes e tarefas do objeto AppointmentItem e TaskItem associado.
Comentários
Use o método GetRecurrencePattern para retornar o objeto RecurrencePattern associado ao objeto AppointmentItem ou TaskItem.
Chamar GetRecurrencePattern ou ClearRecurrencePattern tem o efeito do lado do definindo a propriedade IsRecurring do item de acordo. Essa propriedade pode ser usada conforme necessário para filtragem eficiente do objeto Items.
O tipo de padrão de recorrência é indicado pela propriedade RecurrenceType. A propriedade RecurrenceType é a primeira propriedade que deve ser definida.
As propriedades abaixo são válidas para todos os padrões de recorrência: EndTime, ocorrências, StartDate, StartTime ou tipo.
A tabela a seguir mostra as propriedades que são válidas para os diferentes tipos de recorrência. Ocorrerá um erro se o item é salvo e a propriedade for nula ou contém um valor inválido. Padrões mensais e anuais somente são válidos para um único dia. Os padrões semanais são válidos como o ou de DayOfWeekMask somente.
| RecurrenceType | Propriedades | Exemplos |
|---|---|---|
| olRecursDaily | Duração e EndTime, intervalo, NoEndDate, ocorrências, PatternStartDate, PatternEndDate, StartTime | Um valor N por intervalo é a cada N dias. |
| olRecursWeekly | DayOfWeekMask, duração, EndTime, intervalo, NoEndDate, ocorrências, PatternStartDate, PatternEndDate, StartTime | Um valor N por intervalo é a cada N semanas. Um exemplo de DayofWeekMask é toda terça-feira, quarta-feira e quinta-feira. |
| olRecursMonthly | DayOfMonth, duração e EndTime, intervalo, NoEndDate, ocorrências, PatternStartDate, PatternEndDate, StartTime | Um valor N para o intervalo é a cada N meses. Um valor N para DayofMonth é enésimo dia do mês. |
| olRecursMonthNth | DayOfWeekMask, duração e EndTime, intervalo, instância, NoEndDate, ocorrências, PatternStartDate, PatternEndDate, StartTime | Um valor N por intervalo é a cada N meses. Um exemplo de valor N instância é cada enésimo terça-feira. Um exemplo de DayofWeekMask é toda terça-feira e quarta-feira. |
| olRecursYearly | DayOfMonth, duração, EndTime, intervalo, MonthOfYear, NoEndDate, ocorrências, PatternStartDate, PatternEndDate, StartTime | Um valor N para DayofMonth é o nono dia do mês. Um exemplo de MonthOfYear é fevereiro. |
| olRecursYearNth | DayOfWeekMask, duração e EndTime, intervalo, instância, NoEndDate, ocorrências, PatternStartDate, PatternEndDate, StartTime | Um exemplo de valor N para instância é o enésimo terça-feira. Um exemplo de DayofWeekMask é terça-feira, quarta-feira e quinta-feira. Um exemplo de MonthOfYear é fevereiro. |
Quando você trabalha com os itens de compromisso recorrente, deve liberar qualquer referência anterior, obter referências de novas para o item de compromisso recorrente a antes de acessar ou modificar o item e liberar essas referências assim que você tiver terminado e salvou as alterações. Essa prática se aplica ao objeto AppointmentItem recorrente e qualquer objeto de exceção ou RecurrencePattern. Para liberar uma referência no Visual Basic for Applications (VBA) ou no Visual Basic, defina esse objeto existente como Nothing. Em c#, release explicitamente a memória para aquele objeto. Para obter um exemplo de código, consulte o tópico do objeto AppointmentItem.
Observe que, mesmo depois que você liberar seu referência e tenta obter uma referência de nova, se ainda houver uma referência de ativa, conduzida por outro suplemento ou no Outlook, como um dos objetos acima, sua nova referência continuarão a apontar para uma cópia desatualizada do objeto. Portanto, é importante que você libera seus referências assim que terminar com um compromisso recorrente.
Métodos
| Nome |
|---|
| GetOccurrence |
Propriedades
Confira também
Membros do objeto Do Outlook Object ReferenceRecurrencePattern
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.