Erstellen eines Termins, der ein ganztägiges Ereignis darstellt
In diesem Beispiel wird veranschaulicht, wie die AllDayEvent-Eigenschaft verwendet wird, um einen Termin als ganztägiges Ereignis zu erstellen.
Beispiel
Hinweis
Das folgende Codebeispiel ist ein Auszug aus Programming Applications für Microsoft Office Outlook 2007.
Ein Ereignis unterscheidet sich insofern von einem normalen Termin, als es sich um eine Aktivität von mindestens 24-stündiger Dauer handelt. Beispiele für Ereignisse sind Messen, Seminare oder Urlaube. Ereignisse und jährliche Ereignisse werden nicht als belegte Zeiträume im Kalender des Benutzers angezeigt. Sie werden vielmehr als Banner dargestellt. Sie können die Banner am oberen Rand einer Tages- oder Wochenansicht des Kalenders sehen. Für einen ganztägigen Termin wird die Zeit des Benutzers anderen Personen gegenüber standardmäßig als gebucht angezeigt, für ein Ereignis oder jährliches Ereignis wird sie dagegen als frei angezeigt.
Um ein ganztägiges Ereignis programmgesteuert zu erstellen, legen Sie die AllDayEvent-Eigenschaft des AppointmentItem-Objekts auf „true“ fest. Legen Sie dann die Eigenschaften Start und End des AppointmentItem fest. Wenn Sie die AllDayEvent-Eigenschaft auf „true“ festlegen und die Start- und End-Eigenschaft nicht festlegen, findet das Ereignis heute statt, und es handelt sich um einen Termin, sodass der Status „Gebucht“ in Ihrem Kalender angezeigt wird. Sie müssen die Start- und End-Eigenschaft festlegen, wenn das Ereignis an einem Datum in der Zukunft stattfinden soll.
Hinweis
Soll es sich bei dem Termin um ein ganztägiges Ereignis handeln, müssen Sie die Start-Eigenschaft auf 00:00 Uhr (Mitternacht) des Tages festlegen, an dem das Ereignis beginnen soll, und die End-Eigenschaft auf 00:00 Uhr des Tages nach dem gewünschten Ende des Ereignisses. Wenn Sie die Start- oder Endzeit auf einen anderen Datums- oder Zeitwert als 24 Uhr festlegen, wird der Termin ein mehrtägiger Termin und kein ganztägiges Ereignis.
Dauert das Ereignis beispielsweise nur einen Tag, legen Sie die Start-Eigenschaft auf 00:00 Uhr des Tages fest, an dem das Ereignis beginnen soll, und legen Sie die End-Eigenschaft auf 00:00 Uhr des folgenden Tages fest. Sie sollten die End-Eigenschaft immer auf 00:00 Uhr an einem Datum festlegen, das mehr als einen Tag nach dem Startdatum liegt.
Im folgenden Codebeispiel erstellt AllDayEventExample ein ganztägiges Ereignis, das am 11. Juni 2007 beginnt und am 15. Juni 2007 endet. Beachten Sie, dass die End-Eigenschaft für den Termin am 16. Juni 2007 auf 12:00 Uhr festgelegt ist.
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 AllDayEventExample()
{
Outlook.AppointmentItem appt = Application.CreateItem(
Outlook.OlItemType.olAppointmentItem)
as Outlook.AppointmentItem;
appt.Subject = "Developer's Conference";
appt.AllDayEvent = true;
appt.Start = DateTime.Parse("6/11/2007 12:00 AM");
appt.End = DateTime.Parse("6/16/2007 12:00 AM");
appt.Display(false);
}