Erstellen einer Terminserie mithilfe des Standardserienmusters
Dieses Beispiel zeigt, wie eine Terminserie mithilfe des Standardserienmusters erstellt wird.
Beispiel
Hinweis
Das folgende Codebeispiel ist ein Auszug aus Programming Applications für Microsoft Office Outlook 2007.
Wenn Sie einen Termin in Outlook erstellen, erstellen Sie ein AppointmentItem-Objekt. Bei Ihrem Termin handelt es sich um eine Terminserie, wenn die IsRecurring-Eigenschaft des AppointmentItem auf „true“ festgelegt wird. IsRecurring kann nicht direkt festgelegt werden.
Sie können jedoch eine Terminserie mithilfe des RecurrencePattern-Objekts erstellen. Um eine Terminserie programmgesteuert zu erstellen, erstellen Sie ein AppointmentItem-Objekt, rufen Sie die GetRecurrencePattern()-Methode des AppointmentItem-Objekts auf, und speichern Sie dann das AppointmentItem-Objekt. Dadurch wird ein Termin erstellt, der das Standardserienmuster verwendet, und der täglich an dem Tag der Woche auftritt, für den der Termin erstellt wurde. Eine Terminserie weist kein Enddatum auf. Mit dem RecurrencePattern-Objekt können Sie Terminserien an angegebenen Intervallen erstellen – täglich, wöchentlich, monatlich oder jährlich. Wenn Sie keine Intervalle für das RecurrencePattern-Objekt nicht angeben, verwendet Outlook das Standardserienmuster.
Wenn Sie mit Terminserien arbeiten, müssen Sie vorherige Verweise freigeben, neue Verweise auf das Terminserienelement abrufen, bevor Sie das Element öffnen oder bearbeiten, und diese Verweise freigeben, sobald Sie Ihre Änderungen abgeschlossen und gespeichert haben. Diese Vorgehensweise gilt für das sich wiederholende AppointmentItem-Objekt und alle Exception- oder RecurrencePattern-Objekte. Um einen Verweis in Visual Basic freizugeben, legen Sie dieses vorhandene Objekt auf „Nothing“ fest. Geben Sie in C# den Arbeitsspeicher für dieses Objekt explizit frei.
Auch nachdem Sie Ihren Verweis freigegeben und versucht haben, einen neuen Verweis abzurufen, zeigt Ihr neuer Verweis, wenn es noch einen aktiven Verweis (der von einem anderen Add-In oder Outlook aktiviert wurde) auf eines der obigen Objekte gibt, weiter auf eine veraltete Kopie des Objekts. Deshalb müssen Sie stets Ihre Verweise freigeben, sobald Sie mit dem Bearbeiten der Terminserie fertig sind.
Im folgenden Beispiel erstellt CreateRecurringAppointment ein AppointmentItem-Objekt. Dann wird GetRecurrencePattern aufgerufen. GetRecurrencePattern gibt ein RecurrencePattern-Objekt zurück, und das AppointmentItem wird gespeichert. Dadurch wird eine Terminserie erstellt, die das Standardserienmuster verwendet.
Wenn Sie Visual Studio verwenden, um dieses Codebeispiel zu testen, müssen Sie der Microsoft Outlook 15.0-Objektbibliothekkomponente zuerst einen Verweis hinzufügen und die Outlook-Variable angeben, wenn Sie den Microsoft.Office.Interop.Outlook-Namespace importieren. Die using-Anweisung darf im Codebeispiel nicht direkt vor den Funktionen stehen, sondern muss vor der öffentlichen Class-Deklaration hinzugefügt werden. Die folgende Codezeile zeigt, wie Sie den Import und die Zuweisung in C# vornehmen.
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();
}