AppointmentItem.GetRecurrencePattern method (Outlook)

Gibt ein RecurrencePattern-Objekt zurück, das die Serienattribute eines Termins darstellt.

Syntax

Ausdruck. GetRecurrencePattern

Ausdruck Eine Variable, die ein AppointmentItem-Objekt darstellt.

Rückgabewert

Ein RecurrencePattern-Objekt, das die Serienattribute eines Termins darstellt.

HinwBemerkungeneise

Wenn kein Serienmuster vorhanden ist, wird ein neues leeres RecurrencePattern-Objekt zurückgegeben.

Beim Arbeiten mit Terminserien Termin, sollten Sie alle vorherigen Verweise freigeben, erhalten neue Verweise auf die wiederkehrenden Terminelement, bevor Sie zugreifen oder das Element ändern und diese Verweise freigeben, sobald Sie fertig sind und die Änderungen gespeichert haben. Diese Vorgehensweise gilt für das wiederkehrende AppointmentItem-Objekt und alle Exception - oder RecurrencePattern-Objekte . Um einen Verweis in Visual Basic für Applikationen (VBA) oder Visual Basic freizugeben, legen Sie das vorhandene Objekt auf Nothing zurück. In c# explizit freigeben des Speichers für dieses Objekt. Ein Codebeispiel finden Sie unter dem Thema für das AppointmentItem -Objekt.

Beachten Sie Folgendes: Selbst wenn Sie den Verweis freigegeben haben und versuchen, einen neuen Verweise abzurufen, zeigt der neue Verweis weiterhin auf eine veraltete Kopie des Objekts, wenn immer noch ein aktiver Verweis auf eines der obigen Objekte vorhanden ist, der von einem anderen Add-In oder von Outlook verwendet wird. Deshalb ist es wichtig, dass Sie die Verweise freigeben, sobald Sie die Bearbeitung der Terminserie abgeschlossen haben.

Beispiel

Visual Basic für Applikationen (VBA) wird verwendet CreateItem, um ein AppointmentItem -Objekt zu erstellen. Das RecurrencePattern für dieses Element wird über die GetRecurrencePattern -Methode ermittelt. RecurrencePattern -Eigenschaften, RecurrenceType, PatternStartDate und PatternEndDate festlegen, werden die Termine in einer Terminserie, die täglich für den Zeitraum von einem Jahr auftreten.

Ein Exception -Objekt wird erstellt, wenn eine Instanz dieser Terminserie mithilfe der GetOccurrence -Methode abgerufen wird und die Eigenschaften für diese Instanz geändert. Diese Ausnahme in der Terminserie wird abgerufen, verwenden die GetRecurrencePattern -Methode, um auf die Exceptions -Auflistung, die dieser Serie zugeordnet zuzugreifen. Meldungsfelder zeigen das ursprüngliche Subject und OriginalDate für diese Ausnahme auf die Datenreihe der Termine und das aktuelle Datum, Zeit und Betreff für diese Ausnahme.

Public Sub cmdExample() 
 
 Dim myApptItem As Outlook.AppointmentItem 
 
 Dim myRecurrPatt As Outlook.RecurrencePattern 
 
 Dim myNamespace As Outlook.NameSpace 
 
 Dim myFolder As Outlook.Folder 
 
 Dim myItems As Outlook.Items 
 
 Dim myDate As Date 
 
 Dim myOddApptItem As Outlook.AppointmentItem 
 
 Dim saveSubject As String 
 
 Dim newDate As Date 
 
 Dim myException As Outlook.Exception 
 
 
 
 Set myApptItem = Application.CreateItem(olAppointmentItem) 
 
 myApptItem.Start = #2/2/2003 3:00:00 PM# 
 
 myApptItem.End = #2/2/2003 4:00:00 PM# 
 
 myApptItem.Subject = "Meet with Boss" 
 
 
 
 'Get the recurrence pattern for this appointment 
 
 'and set it so that this is a daily appointment 
 
 'that begins on 2/2/03 and ends on 2/2/04 
 
 'and save it. 
 
 Set myRecurrPatt = myApptItem.GetRecurrencePattern 
 
 myRecurrPatt.RecurrenceType = olRecursDaily 
 
 myRecurrPatt.PatternStartDate = #2/2/2003# 
 
 myRecurrPatt.PatternEndDate = #2/2/2004# 
 
 myApptItem.Save 
 
 
 
 'Access the items in the Calendar folder to locate 
 
 'the master AppointmentItem for the new series. 
 
 Set myNamespace = Application.GetNamespace("MAPI") 
 
 Set myFolder = myNamespace.GetDefaultFolder(olFolderCalendar) 
 
 Set myItems = myFolder.Items 
 
 Set myApptItem = myItems("Meet with Boss") 
 
 
 
 'Get the recurrence pattern for this appointment 
 
 'and obtain the occurrence for 3/12/03. 
 
 myDate = #3/12/2003 3:00:00 PM# 
 
 Set myRecurrPatt = myApptItem.GetRecurrencePattern 
 
 Set myOddApptItem = myRecurrPatt.GetOccurrence(myDate) 
 
 
 
 'Save the existing subject. Change the subject and 
 
 'starting time for this particular appointment 
 
 'and save it. 
 
 saveSubject = myOddApptItem.Subject 
 
 myOddApptItem.Subject = "Meet NEW Boss" 
 
 newDate = #3/12/2003 3:30:00 PM# 
 
 myOddApptItem.Start = newDate 
 
 myOddApptItem.Save 
 
 
 
 'Release references to the appointment series 
 
 Set myApptItem = Nothing 
 
 Set myRecurrPatt = Nothing 
 
 
 
 'Get the recurrence pattern for the master 
 
 'AppointmentItem. Access the collection of 
 
 'exceptions to the regular appointments. 
 
 Set myItems = myFolder.Items 
 
 Set myApptItem = myItems("Meet with Boss") 
 
 
 
 Set myRecurrPatt = myApptItem.GetRecurrencePattern 
 
 Set myException = myRecurrPatt.Exceptions.Item(1) 
 
 
 
 'Display the original date, time, and subject 
 
 'for this exception. 
 
 MsgBox myException.OriginalDate & ": " & saveSubject 
 
 
 
 'Display the current date, time, and subject 
 
 'for this exception. 
 
 MsgBox myException.AppointmentItem.Start & ": " & _ 
 
 myException.AppointmentItem.Subject 
 
End Sub

Siehe auch

AppointmentItem-Objekt

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.