Объект AppointmentItem (Outlook)AppointmentItem object (Outlook)

Представляет собрание, одноразовую встречу или повторяющуюся встречу или собрание в папке "Календарь".Represents a meeting, a one-time appointment, or a recurring appointment or meeting in the Calendar folder.

ПримечанияRemarks

Используйте метод CreateItem для создания объекта AppointmentItem , представляющего новую встречу.Use the CreateItem method to create an AppointmentItem object that represents a new appointment.

Используйте элементы (index), где index — это индекс встречи или значения, используемого по умолчанию для встречи, чтобы возвратить один объект AppointmentItem из папки "Календарь".Use Items (index), where index is the index number of an appointment or a value used to match the default property of an appointment, to return a single AppointmentItem object from a Calendar folder.

Вы также можете вернуть объект AppointmentItem из объекта MeetingItem с помощью метода метод GetAssociatedAppointment .You can also return an AppointmentItem object from a MeetingItem object by using the GetAssociatedAppointment method.

При работе с элементами повторяющихся встреч необходимо удалить все ранее существовавшие ссылки, получить новые ссылки на элемент повторяющейся встречи перед вызовом или изменением этого элемента и удалить эти ссылки сразу же по окончании внесения изменений и их сохранения.When you work with recurring appointment items, you should release any prior references, obtain new references to the recurring appointment item before you access or modify the item, and release these references as soon as you are finished and have saved the changes. Это применимо к объекту повторяющегося объекта AppointmentItem , а также к любому объекту Exception или RecurrencePattern .This practice applies to the recurring AppointmentItem object, and any Exception or RecurrencePattern object. Чтобы освободить ссылку в Visual Basic для приложений (VBA) или Visual Basic, установите для существующего объекта значение Nothing.To release a reference in Visual Basic for Applications (VBA) or Visual Basic, set that existing object to Nothing. В C# следует явно освободить память для этого объекта.In C#, explicitly release the memory for that object.

Обратите внимание, что даже после высвобождения ссылки и попытки получения новой ссылки, если по-прежнему существует активная ссылка на любой из вышеупомянутых объектов, удерживаемая другой надстройкой или приложением Outlook, новая ссылка будет указывать на устаревшую копию объекта.Note that even after you release your reference and attempt to obtain a new reference, if there is still an active reference, held by another add-in or Outlook, to one of the above objects, your new reference will still point to an out-of-date copy of the object. В связи с этим важно высвобождать ссылки немедленно после завершения текущей встречи.Therefore, it is important that you release your references as soon as you are finished with the recurring appointment.

В приведенном ниже примере кода в VBA показано, как освобождать и обновлять ссылки для получения актуальных данных для повторяющейся встречи.The following code example in VBA shows how to release and refresh references in order to obtain up-to-date data for a recurring appointment. В этом примере показано, как получить набор элементов встречи из папки "Календарь".The example obtains a set of appointment items from the Calendar folder. Предполагается, что первый элемент в коллекции встреч является частью повторяющейся встречи.It assumes that the first item in the appointment collection is part of a recurring appointment. В этом примере показано, что ссылка на коллекцию встреч, полученную до создания исключения, не отражает исключение.The example shows that a reference to the appointment collection obtained before an exception is created does not reflect the exception. Затем он освобождает эту ссылку и другие существующие ссылки на встречу, после чего новые ссылки, указывающие на коллекцию встреч, отражают исключение.The example then releases this reference and other existing appointment references, after which new references that point to the appointment collection reflect the exception.

Sub TestExceptions() 
 
 Dim oItems As Items 
 
 Dim oItemOriginal As AppointmentItem 
 
 Dim oItemNew As AppointmentItem 
 
 Dim rPattern As RecurrencePattern 
 
 Dim oEx As Exceptions 
 
 Dim oEx2 As Exceptions 
 
 Dim oOccurrence As AppointmentItem 
 
 Dim i As Long 
 
 
 
 ' This is the initial reference to an appointment collection. 
 
 Set oItems = _ 
 
 Outlook.Application.Session.GetDefaultFolder(olFolderCalendar).Items 
 
 
 
 ' This is the original reference to the first appointment in the 
 
 ' collection before an exception is created. 
 
 Set oItemOriginal = oItems.Item(1) 
 
 
 
 ' Code example assumes that the first appointment in the collection 
 
 ' is a recurring appointment. 
 
 Set oOccurrence = _ 
 
 oItemOriginal.GetRecurrencePattern().GetOccurrence(#2/28/2010 8:00:00 AM#) 
 
 
 
 ' Create an exception by changing the 2/28 occurrence to 3/3. 
 
 oOccurrence.Start = #3/3/2010 8:00:00 AM# 
 
 oOccurrence.Save 
 
 
 
 Stop 
 
 
 
 ' Preexisting reference to the first appointment in the collection 
 
 ' does not reflect the exception. 
 
 oItemOriginal.Save 
 
 Set oEx = oItemOriginal.GetRecurrencePattern().Exceptions 
 
 Debug.Print oItemOriginal.subject 
 
 Debug.Print " Original item exceptions: " & oEx.Count 
 
 
 
 ' Get a new reference based on the existing reference to the 
 
 ' appointment collection created before the exception. 
 
 ' The new reference does not reflect the exception. 
 
 Set oItemNew = oItems.Item(1) 
 
 oItemNew.Save 
 
 Set oEx2 = oItemNew.GetRecurrencePattern().Exceptions 
 
 Debug.Print " New item exceptions: " & oEx2.Count 
 
 
 
 ' Same: preexisting reference to the first appointment in the collection 
 
 ' does not reflect the exception. 
 
 Set oEx = oItemOriginal.GetRecurrencePattern().Exceptions 
 
 Debug.Print " Original item exceptions: " & oEx.Count 
 
 
 
 ' Release all existing references to appointment items, 
 
 ' including the appointment collection, an exception, occurrence, 
 
 ' or any other appointment. 
 
 Debug.Print "REFRESH ITEM COLLECTION" 
 
 Set oItems = Nothing 
 
 Set oItemNew = Nothing 
 
 Set oEx = Nothing 
 
 Set oEx2 = Nothing 
 
 Set oOccurrence = Nothing 
 
 Set oItemOriginal = Nothing 
 
 Set rPattern = Nothing 
 
 
 
 ' Get new references to appointment items, including the appointment 
 
 ' collection, individual appointments, and exceptions. 
 
 Set oItems = _ 
 
 Outlook.Application.Session.GetDefaultFolder(olFolderCalendar).Items 
 
 Set oItemNew = oItems.Item(1) 
 
 
 
 ' If no other add-ins have the same recurring appointment open, 
 
 ' the new references reflect the current exception count. 
 
 Set oEx2 = oItemNew.GetRecurrencePattern().Exceptions 
 
 Debug.Print " New item exceptions: " & oEx2.Count 
 
 
 
 Debug.Print "RE-GET ORIGINAL" 
 
 Set oItemOriginal = oItems.Item(1) 
 
 Set oEx = oItemOriginal.GetRecurrencePattern().Exceptions 
 
 Debug.Print " Original item exceptions: " & oEx.Count 
 
End Sub

ПримерExample

В приведенном ниже примере Visual Basic для приложений (VBA) возвращается новая встреча.The following Visual Basic for Applications (VBA) example returns a new appointment.

Set myItem = Application.CreateItem(olAppointmentItem)

СобытияEvents

ИмяName
AfterWriteAfterWrite
AttachmentAddAttachmentAdd
AttachmentReadAttachmentRead
AttachmentRemoveAttachmentRemove
BeforeAttachmentAddBeforeAttachmentAdd
BeforeAttachmentPreviewBeforeAttachmentPreview
BeforeAttachmentReadBeforeAttachmentRead
BeforeAttachmentSaveBeforeAttachmentSave
BeforeAttachmentWriteToTempFileBeforeAttachmentWriteToTempFile
BeforeAutoSaveBeforeAutoSave
BeforeCheckNamesBeforeCheckNames
BeforeDeleteBeforeDelete
BeforeReadBeforeRead
CloseClose
CustomActionCustomAction
CustomPropertyChangeCustomPropertyChange
ForwardForward
OpenOpen
PropertyChangePropertyChange
ReadRead
ReadCompleteReadComplete
ReplyReply
ReplyAllReplyAll
SendSend
UnloadUnload
WriteWrite

МетодыMethods

ИмяName
ClearRecurrencePatternClearRecurrencePattern
CloseClose
CopyCopy
CopyToCopyTo
DeleteDelete
DisplayDisplay
ForwardAsVcalForwardAsVcal
GetConversationGetConversation
GetOrganizerGetOrganizer
GetRecurrencePatternGetRecurrencePattern
MoveMove
PrintOutPrintOut
RespondRespond
SaveSave
SaveAsSaveAs
SendSend
ShowCategoriesDialogShowCategoriesDialog

СвойстваProperties

ИмяName
ActionsActions
AllDayEventAllDayEvent
ApplicationApplication
AttachmentsAttachments
AutoResolvedWinnerAutoResolvedWinner
BillingInformationBillingInformation
BodyBody
BusyStatusBusyStatus
CategoriesCategories
ClassClass
CompaniesCompanies
ConflictsConflicts
ConversationIDConversationID
ConversationIndexConversationIndex
ConversationTopicConversationTopic
CreationTimeCreationTime
DownloadStateDownloadState
DurationDuration
EndEnd
EndInEndTimeZoneEndInEndTimeZone
EndTimeZoneEndTimeZone
EndUTCEndUTC
EntryIDEntryID
ForceUpdateToAllAttendeesForceUpdateToAllAttendees
FormDescriptionFormDescription
GetInspectorGetInspector
GlobalAppointmentIDGlobalAppointmentID
ImportanceImportance
InternetCodepageInternetCodepage
IsConflictIsConflict
IsRecurringIsRecurring
ItemPropertiesItemProperties
LastModificationTimeLastModificationTime
LocationLocation
MarkForDownloadMarkForDownload
MeetingStatusMeetingStatus
MeetingWorkspaceURLMeetingWorkspaceURL
MessageClassMessageClass
MileageMileage
NoAgingNoAging
OptionalAttendeesOptionalAttendees
OrganizerOrganizer
OutlookInternalVersionOutlookInternalVersion
OutlookVersionOutlookVersion
ParentParent
PropertyAccessorPropertyAccessor
RecipientsRecipients
RecurrenceStateRecurrenceState
ReminderMinutesBeforeStartReminderMinutesBeforeStart
ReminderOverrideDefaultReminderOverrideDefault
ReminderPlaySoundReminderPlaySound
ReminderSetReminderSet
ReminderSoundFileReminderSoundFile
ReplyTimeReplyTime
RequiredAttendeesRequiredAttendees
ResourcesResources
ResponseRequestedResponseRequested
ResponseStatusResponseStatus
RTFBodyRTFBody
SavedSaved
SendUsingAccountSendUsingAccount
SensitivitySensitivity
SessionSession
SizeSize
StartStart
StartInStartTimeZoneStartInStartTimeZone
StartTimeZoneStartTimeZone
StartUTCStartUTC
SubjectSubject
UnReadUnRead
UserPropertiesUserProperties

См. такжеSee also

Справочные материалы по объектной модели Outlook : импорт XML-данных встречи в объекты встречи OutlookAppointmentItem элементы объектаOutlook Object Model Reference How to: Import Appointment XML Data into Outlook Appointment Objects AppointmentItem Object Members

Поддержка и обратная связьSupport and feedback

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи?Have questions or feedback about Office VBA or this documentation? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.