Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
3/29/2010

Defines an Appointment item in the Appointment collection. Appointments are blocks of time that appear in the Outlook calendar. They can have beginning and ending times, can repeat, can have a location; and become Meetings when scheduled (sent) to recipients (Contacts).

The following tables list the members exposed by the Appointmenttype.

Public Constructors

  Name Description
Appointment Overloaded.  
Top

Public Properties

  Name Description
AllDayEvent Gets or sets a value indicating whether an Appointment occurs as an all day event. By default, Appointments occur at a particular point in the day.
Body Gets or sets an Appointment's text Notes. The maximum size is 20 KB.
BusyStatus Gets or sets a Contact's availability in the time period spanned by an Appointment or Meeting. The BusyStatus enumeration defines the possible values. The default value is Busy.
Categories Gets or sets an Appointment's categories. This string is limited to 1023 characters.
Duration Gets or sets the length of an Appointment. This is a System.TimeSpan object.
End Gets or sets the Appointment's end time. This System.DateTime value must be greater than or equal to the Appointment's start time.
IsRecurring Gets a value indicating whether an Appointment is recurring.
ItemId  Gets the PIM item’s ID. (inherited from PimItem)
Location Gets or sets an Appointment's location. This string is limited to 1023 characters.
MeetingStatus Gets a value indicating whether an Appointment is a Meeting.
Properties  Gets the PimPropertySet. This object is used for creating custom PIM item properties. (inherited from PimItem)
Recipients Gets the collection of Recipients for a Meeting. The RecipientCollection object is available only if IsMeeting is TRUE.
RecurrencePattern Gets an Appointment's recurrence pattern. A recurrence pattern defines when and how often an Appointment repeats (for example, every Monday at 9:00 AM).
ReminderDialog Gets or sets a value indicating whether a reminder dialog box appears to remind the user of an upcoming Appointment.
ReminderLed Gets or sets a value indicating whether Outlook Mobile uses the mobile device's notification light-emitting diode (LED) to remind the user of an upcoming Appointment.
ReminderMinutesBeforeStart Gets or sets the number of minutes a reminder alarm occurs before the start of an Appointment. This property defaults to the current setting in Calendar options.
ReminderRepeat Gets or sets a value indicating whether the Appointment reminder sound file repeats until the user dismisses the reminder.
ReminderSet Gets or sets a value indicating whether a reminder dialog box appears to remind the user of an upcoming Appointment.
ReminderSound Gets or sets a value indicating whether Outlook Mobile plays the Appointment reminder audio file to remind the user of an upcoming Appointment.
ReminderSoundFile Gets or sets the fully qualified path name of the audio file that Outlook Mobile plays as the Appointment reminder. This property is valid only if the ReminderSet property is TRUE, and if the ReminderOptions property includes Sound. This property defaults to the current setting in Calendar options, but if no audio file is specified, then it defaults to Alarm1.wav. The maximum length of the the fully qualified path name is 255 characters.
ReminderVibrate Gets or sets a value indicating whether Outlook Mobile uses the mobile device's built-in vibrator to remind the user of an upcoming Appointment.
Sensitivity Gets or sets an Appointment's sensitivity. The Sensitivity enumeration defines the possible values. The default value is Normal.
Start Gets or sets the Appointment's start time. This System.DateTime value must be less than or equal to the Appointment's end time.
Subject Gets or sets an Appointment's subject line. This string is limited to 4096 characters.
Top

Public Methods(see also Protected Methods)

  Name Description
Cancel Cancels a Meeting. Removes the Meeting from the calendar.
Copy Creates a copy of the current Appointment in the Appointment collection.
CreateObjRef  (inherited from MarshalByRefObject)
Delete Overloaded.  
Equals  Overloaded. (inherited from Object)
GetHashCode  (inherited from Object)
GetLifetimeService  (inherited from MarshalByRefObject)
GetType  (inherited from Object)
InitializeLifetimeService  (inherited from MarshalByRefObject)
ReferenceEquals  (inherited from Object)
Send Sends (e-mails) a Meeting request to one or more Recipients.
ShowDialog  Opens the PIM item’s standard summary card. (inherited from PimItem)
ToString Overridden. Gets the subject of an Appointment.
Update Overridden.  
Top

Protected Methods

  Name Description
Delete  Overloaded. (inherited from PimItem)
Finalize  The PimItem class destructor. (inherited from PimItem)
MemberwiseClone  (inherited from Object)
Top

Public Events

  Name Description
AllDayEventChanged Occurs when an Appointment's AllDayEvent property changes.
BodyChanged Occurs when an Appointment's Notes change.
BusyStatusChanged Occurs when an Appointment's BusyStatus property changes.
CategoriesChanged Occurs when an Appointment's Categories change.
DurationChanged Occurs when an Appointment's Duration changes.
EndChanged Occurs when an Appointment's End changes.
LocationChanged Occurs when an Appointment's Location changes.
ReminderDialogChanged Occurs when an Appointment's ReminderDialog property changes.
ReminderLedChanged Occurs when an Appointment's ReminderLed property changes.
ReminderMinutesBeforeStartChanged Occurs when an Appointment's ReminderMinutesBeforeStart property changes.
ReminderRepeatChanged Occurs when an Appointment's ReminderRepeat property changes.
ReminderSetChanged Occurs when an Appointment's ReminderSet property changes.
ReminderSoundChanged Occurs when an Appointment's ReminderSound property changes.
ReminderSoundFileChanged Occurs when an Appointment's ReminderSoundFile property changes.
ReminderVibrateChanged Occurs when an Appointment's ReminderVibrate property changes.
SensitivityChanged Occurs when an Appointment's Sensitivity changes.
StartChanged Occurs when an Appointment's Start changes.
SubjectChanged Occurs when an Appointment's Subject changes.
Top

See Also