Compartilhar via


Criar um compromisso recorrente que usa o padrão de recorrência padrão

Este exemplo mostra como criar um compromisso recorrente usando o padrão de recorrência padrão.

Exemplo

Observação

O exemplo de código a seguir foi tirado do artigo Programação de aplicativos do Microsoft Office Outlook 2007.

Ao criar um compromisso no Outlook, você está criando um objeto AppointmentItem. Seu compromisso será um compromisso recorrente se a propriedade IsRecurring do AppointmentItem estiver definida como true. IsRecurring não pode ser definido diretamente.

No entanto, é possível criar um compromisso recorrente usando o objeto RecurrencePattern. Para criar um compromisso recorrente programaticamente, crie um objeto AppointmentItem, chame o método GetRecurrencePattern() do objeto AppointmentItem e, em seguida, salve o objeto AppointmentItem. Isso cria um compromisso que usa o padrão de recorrência padrão que ocorre semanalmente no dia da semana para o qual o compromisso foi criado e não tem data de término. O objeto RecurrencePattern permite a criação de compromissos recorrentes em intervalos especificados: diário, semanal, mensal ou anual. Se você não especificar intervalos para o objeto RecurrencePattern, o Outlook usará o padrão de recorrência padrão.

Ao trabalhar com itens de compromisso recorrente, você deve liberar referências anteriores, obter novas referências para o item de compromisso recorrente antes de acessar ou modificar o item e liberar essas referências assim que tiver terminado e salvado as alterações. Essa prática aplica o objeto AppointmentItem recorrente e a qualquer objeto Exception ou RecurrencePattern. Para liberar uma referência no Visual Basic, defina esse objeto existente como Nothing. Em c#, release explicitamente a memória para aquele objeto.

Observe que mesmo após liberar sua referência e tentar obter uma nova referência, se ainda houver uma referência ativa (mantida por outro suplemento ou pelo Outlook) para um dos objetos acima, sua nova referência continuará a apontar para uma cópia desatualizada do objeto. Portanto, é importante liberar suas referências assim que seu compromisso recorrente terminar.

No exemplo a seguir CreateRecurringAppointment cria um objeto AppointmentItem. Em seguida, ele chama GetRecurrencePattern. GetRecurrencePattern retorna um objeto RecurrencePattern e AppointmentItem é salvo. Isso cria um compromisso recorrente que usa o padrão de recorrência padrão.

Se usar o Visual Studio para testar este exemplo de código, adicione primeiro uma referência ao componente da biblioteca de objetos do Microsoft Outlook 15.0 e especifique a variável do Outlook quando importar o namespace Microsoft.Office.Interop.Outlook. A instruçãousing não deve ocorrer diretamente antes das funções no exemplo de código, mas deve ser adicionada antes da declaração de classe pública. The following line of code shows how to do the import and assignment in C#.

using Outlook = Microsoft.Office.Interop.Outlook;
private void CreateRecurringAppointment()
{
    Outlook.AppointmentItem appt = Application.CreateItem(
        Outlook.OlItemType.olAppointmentItem)
        as Outlook.AppointmentItem;
    appt.Subject = "Weekly Extensibility Team Meeting";
    Outlook.RecurrencePattern pattern = appt.GetRecurrencePattern();
    appt.Save();
}

Confira também