RecurrencePattern Interface
Definição
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.
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 RecurrencePatternPublic 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. |