创建属于全天事件的约会

此代码示例展示了如何使用 AllDayEvent 属性创建属于全天事件的约会。

示例

注意

下面的代码示例摘录自 Microsoft Office Outlook 2007 应用程序编程

事件与常规约会不同,因为它是持续 24 小时或更长时间的活动。 活动示例包括贸易展、研讨会或假期。 事件和年度事件不会在用户的日历中显示为占用的时间块。 相反,它们显示为横幅。 可以在日历日或周视图顶部看到横幅。 对于全天约会,默认情况下,其他用户查看时,用户的时间显示为忙碌,但用户的时间在事件或年度事件中显示为空闲。

若要以编程方式创建全天事件,请将 AppointmentItem 对象的 AllDayEvent 属性设置为 true。 然后,设置 AppointmentItem 的 StartEnd 属性。 如果将 AllDayEvent 属性设置为 true 而没有设置 Start 和 End 属性,则事件会在今天发生,并且它会成为约会,在日历上显示忙碌状态。 若要创建未来发生的事件,必须设置 Start 和 End 属性。

注意

若要使约会成为全天事件,必须将 Start 属性设置为希望事件开始的那天的午夜 12:00,并将 End 属性设置为希望事件结束的那天的午夜 12:00。 如果你将 Start 或 End 时间设置为除凌晨 12:00 以外的其他日期和时间值,约会便成为多天约会,而不是全天事件。

例如,如果您的事件只持续一天,请将 Start 属性设置为希望事件开始的那天的午夜 12:00,并将 End 属性设置为第二天的午夜 12:00。 应始终将 End 属性设置为比开始日期多一天的日期的午夜 12:00。

在下面的代码示例中,AllDayEventExample 创建 2007 年 6 月 11 日开始,2007 年 6 月 15 日结束的全天事件。 请注意,约会的 End 属性设置为 2007 年 6 月 16 日的午夜 12:00。

如果使用 Visual Studio 测试此代码示例,必须先添加对 Microsoft Outlook 15.0 对象库组件的引用,并在导入 Microsoft.Office.Interop.Outlook 命名空间时指定 Outlook 变量。 不得将 using 语句直接添加到此代码示例中的函数前面,这个语句必须后跟公共类声明。 下面的代码行演示了如何在 C# 中执行导入和分配。

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);
}

另请参阅