Compartilhar via


RecurrencePattern Interface

Definição

Representa o padrão de incidência de compromissos e tarefas recorrentes para o objeto associado AppointmentItem e TaskItem .

public interface class RecurrencePattern
[System.Runtime.InteropServices.Guid("00063044-0000-0000-C000-000000000046")]
public interface RecurrencePattern
Public Interface RecurrencePattern
Atributos

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 Items objeto.

O tipo de padrão de recorrência é indicado pela RecurrenceType propriedade. A propriedade RecurrenceType é a primeira propriedade que deve ser definida.

As seguintes propriedades são válidas para todos os padrões de recorrência: EndTime, , OccurrencesStartDate, StartTimeou Type.

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 apenas como o Ou do DayOfWeekMask .

olRecursDaily Duration, EndTime, Interval, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime
olRecursWeekly DayOfWeekMask, Duração, EndTime, Interval, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime
olRecursMonthly DayOfMonth, Duração, EndTime, Interval, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime
olRecursMonthNth DayOfWeekMask, Duration, EndTime, Interval, Instance, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime
olRecursYearly DayOfMonth, Duration, EndTime, Interval, MonthOfYear, NoEndDate, Occurrences, PatternStartDate, PatternEndDate, StartTime
olRecursYearNth DayOfWeekMask, duração e EndTime, intervalo, instância, NoEndDate, ocorrências, PatternStartDate, PatternEndDate, StartTime

Quando você trabalha com itens de compromisso recorrente, você deve liberar qualquer referência anterior, obter novas referências para o item de compromisso recorrente 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 recorrente AppointmentItem e a qualquer Exception objeto ou RecurrencePattern . Para liberar uma referência no Visual Basic, defina esse objeto existente como Nothing. Em c#, release explicitamente a memória para o objeto.

Observe que, mesmo depois que você liberar a sua referência e tenta obter uma referência de nova, se ainda houver uma referência 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.

Propriedades

Application

Retorna um Application objeto que representa o aplicativo pai do Outlook para o objeto. Somente leitura.

Class

Retorna uma OlObjectClass constante que indica a classe do objeto. Somente leitura.

DayOfMonth

Retorna ou define um valor Inteiro (int em C#) indicando o dia do mês em que ocorre o compromisso ou tarefa recorrente. Leitura/gravação.

DayOfWeekMask

Retorna ou define uma OlDaysOfWeek constante que representa a máscara para os dias da semana em que ocorre o compromisso ou tarefa recorrente. Leitura/gravação.

Duration

Retorna ou define um valor Inteiro (int em C#) indicando a duração (em minutos) do RecurrencePattern. Leitura/gravação.

EndTime

Retorna ou define um DateTime indicando a hora de término de um padrão de recorrência. Leitura/gravação.

Exceptions

Retorna a Exceptions coleção para uma série especificada de compromissos recorrentes. Somente leitura.

Instance

Retorna ou define um valor Inteiro (int em C#) especificando a contagem para a qual o padrão de recorrência é válido para um determinado intervalo. Leitura/gravação.

Interval

Retorna ou define um valor Inteiro (int em C#) especificando o número de unidades de um determinado tipo de recorrência entre ocorrências. Leitura/gravação.

MonthOfYear

Retorna ou define um valor Inteiro (int em C#) indicando qual mês do ano é válido para o padrão de recorrência especificado. Leitura/gravação.

NoEndDate

Retorna um valor bool (bool em C#) que indica True se o padrão de recorrência não tiver data de término. Leitura/gravação.

Occurrences

Retorna ou define um valor Inteiro (int em C#) indicando o número de ocorrências do padrão de recorrência. Leitura/gravação.

Parent

Retorna o pai do objeto do objeto especificado. Somente leitura.

PatternEndDate

Retorna ou define um DateTime que indica a data de término do padrão de recorrência. Leitura/gravação.

PatternStartDate

Retorna ou define um DateTime indicando a data de início do padrão de recorrência. Leitura/gravação.

RecurrenceType

Retorna ou define uma OlRecurrenceType constante especificando a frequência de ocorrências para o padrão de recorrência. Leitura/gravação.

Regenerate

Retorna um bool (bool em C#) que indica True se a tarefa deve ser regenerada após essa passagem pelo padrão de recorrência. Leitura/gravação.

Session

Retorna o NameSpace objeto para a sessão atual. Somente leitura.

StartTime

Retorna ou define um DateTime indicando a hora de início de um padrão de recorrência. Leitura/gravação.

Métodos

GetOccurrence(DateTime)

Retorna uma instância específica do AppointmentItem objeto na data especificada.

Aplica-se a