[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Collapse]Cross-Platform Core Libraries
  Core Library Assemblies
 [Expand]DevExpress Data Library
 [Expand]DevExpress Pivot Grid Core Library
 [Expand]Miscellaneous
 [Collapse]API Reference
  [Expand]DevExpress.Data
  [Expand]DevExpress.Data.Browsing
  [Expand]DevExpress.Data.Browsing.Design
  [Expand]DevExpress.Data.Camera
  [Expand]DevExpress.Data.Controls
  [Expand]DevExpress.Data.Controls.ExpressionEditor
  [Expand]DevExpress.Data.Entity
  [Expand]DevExpress.Data.Filtering
  [Expand]DevExpress.Data.Filtering.Exceptions
  [Expand]DevExpress.Data.Filtering.Helpers
  [Expand]DevExpress.Data.Linq
  [Expand]DevExpress.Data.ODataLinq
  [Expand]DevExpress.Data.PivotGrid
  [Expand]DevExpress.Data.PLinq
  [Expand]DevExpress.Data.TreeList
  [Expand]DevExpress.Data.Utils
  [Expand]DevExpress.Data.Utils.ServiceModel
  [Expand]DevExpress.Data.WcfLinq
  [Expand]DevExpress.Data.WizardFramework
  [Expand]DevExpress.Data.XtraReports.DataProviders
  [Expand]DevExpress.Data.XtraReports.Labels
  [Expand]DevExpress.Data.XtraReports.ServiceModel
  [Expand]DevExpress.Data.XtraReports.ServiceModel.DataContracts
  [Expand]DevExpress.Data.XtraReports.Wizard
  [Expand]DevExpress.Data.XtraReports.Wizard.Presenters
  [Expand]DevExpress.Data.XtraReports.Wizard.Views
  [Expand]DevExpress.DataAccess
  [Expand]DevExpress.DataAccess.ConnectionParameters
  [Expand]DevExpress.DataAccess.DataFederation
  [Expand]DevExpress.DataAccess.EntityFramework
  [Expand]DevExpress.DataAccess.Excel
  [Expand]DevExpress.DataAccess.ExpressionEditor
  [Expand]DevExpress.DataAccess.Json
  [Expand]DevExpress.DataAccess.Localization
  [Expand]DevExpress.DataAccess.ObjectBinding
  [Expand]DevExpress.DataAccess.Sql
  [Expand]DevExpress.DataAccess.Sql.DataApi
  [Expand]DevExpress.DataAccess.UI
  [Expand]DevExpress.DataAccess.UI.Design
  [Expand]DevExpress.DataAccess.UI.EntityFramework
  [Expand]DevExpress.DataAccess.UI.Excel
  [Expand]DevExpress.DataAccess.UI.Localization
  [Expand]DevExpress.DataAccess.UI.ObjectBinding
  [Expand]DevExpress.DataAccess.UI.Sql
  [Expand]DevExpress.DataAccess.UI.Wizard
  [Expand]DevExpress.DataAccess.UI.Wizard.Services
  [Expand]DevExpress.DataAccess.UI.Wizard.Views
  [Expand]DevExpress.DataAccess.Web
  [Expand]DevExpress.DataAccess.Wizard
  [Expand]DevExpress.DataAccess.Wizard.Model
  [Expand]DevExpress.DataAccess.Wizard.Presenters
  [Expand]DevExpress.DataAccess.Wizard.Services
  [Expand]DevExpress.DataAccess.Wizard.Views
  [Expand]DevExpress.Diagram.Core
  [Expand]DevExpress.Diagram.Core.Layout
  [Expand]DevExpress.Diagram.Core.Localization
  [Expand]DevExpress.Diagram.Core.Shapes
  [Expand]DevExpress.Diagram.Core.Themes
  [Expand]DevExpress.DocumentServices.ServiceModel
  [Expand]DevExpress.DocumentServices.ServiceModel.Client
  [Expand]DevExpress.DocumentServices.ServiceModel.DataContracts
  [Expand]DevExpress.DocumentView
  [Expand]DevExpress.Entity.Model
  [Expand]DevExpress.Entity.ProjectModel
  [Expand]DevExpress.Export
  [Expand]DevExpress.Export.Xl
  [Expand]DevExpress.Map
  [Expand]DevExpress.Mvvm
  [Expand]DevExpress.Mvvm.DataAnnotations
  [Expand]DevExpress.Mvvm.DataModel
  [Expand]DevExpress.Mvvm.Gantt
  [Expand]DevExpress.Mvvm.ModuleInjection
  [Expand]DevExpress.Mvvm.UI
  [Expand]DevExpress.Mvvm.Utils
  [Expand]DevExpress.Mvvm.ViewModel
  [Expand]DevExpress.Office.Crypto
  [Expand]DevExpress.PivotGrid.DataBinding
  [Expand]DevExpress.PivotGrid.Printing
  [Expand]DevExpress.Printing
  [Expand]DevExpress.Printing.Core
  [Expand]DevExpress.Printing.ExportHelpers
  [Expand]DevExpress.ReportServer.Printing
  [Expand]DevExpress.ReportServer.Printing.Services
  [Expand]DevExpress.ReportServer.ServiceModel.Client
  [Expand]DevExpress.ReportServer.ServiceModel.ConnectionProviders
  [Expand]DevExpress.ReportServer.ServiceModel.DataContracts
  [Expand]DevExpress.Schedule
  [Expand]DevExpress.Security.Resources
  [Expand]DevExpress.Services
  [Expand]DevExpress.Sparkline
  [Expand]DevExpress.TreeMap
  [Expand]DevExpress.Utils
  [Expand]DevExpress.Utils.Commands
  [Expand]DevExpress.Utils.Controls
  [Expand]DevExpress.Utils.Filtering
  [Expand]DevExpress.Utils.Filtering.Internal
  [Expand]DevExpress.Utils.IoC
  [Expand]DevExpress.Utils.Localization
  [Expand]DevExpress.Utils.Serializing.Helpers
  [Expand]DevExpress.Utils.Svg
  [Expand]DevExpress.WebUtils
  [Expand]DevExpress.Xpf.Core
  [Expand]DevExpress.Xpf.Printing
  [Expand]DevExpress.Xpo
  [Expand]DevExpress.Xpo.DB
  [Expand]DevExpress.Xpo.DB.Exceptions
  [Expand]DevExpress.Xpo.DB.Helpers
  [Expand]DevExpress.Xpo.Helpers
  [Expand]DevExpress.XtraCharts
  [Expand]DevExpress.XtraCharts.Localization
  [Expand]DevExpress.XtraCharts.Native
  [Expand]DevExpress.XtraCharts.Printing
  [Expand]DevExpress.XtraEditors
  [Expand]DevExpress.XtraEditors.DXErrorProvider
  [Expand]DevExpress.XtraExport.Csv
  [Expand]DevExpress.XtraGauges.Base
  [Expand]DevExpress.XtraGauges.Core
  [Expand]DevExpress.XtraGauges.Core.Base
  [Expand]DevExpress.XtraGauges.Core.Drawing
  [Expand]DevExpress.XtraGauges.Core.Localization
  [Expand]DevExpress.XtraGauges.Core.Model
  [Expand]DevExpress.XtraGauges.Core.Primitive
  [Expand]DevExpress.XtraGrid
  [Expand]DevExpress.XtraPivotGrid
  [Expand]DevExpress.XtraPivotGrid.Customization
  [Expand]DevExpress.XtraPivotGrid.Data
  [Expand]DevExpress.XtraPivotGrid.Localization
  [Expand]DevExpress.XtraPivotGrid.Selection
  [Expand]DevExpress.XtraPrinting
  [Expand]DevExpress.XtraPrinting.BarCode
  [Expand]DevExpress.XtraPrinting.Caching
  [Expand]DevExpress.XtraPrinting.DataNodes
  [Expand]DevExpress.XtraPrinting.Drawing
  [Expand]DevExpress.XtraPrinting.Export
  [Expand]DevExpress.XtraPrinting.Export.Web
  [Expand]DevExpress.XtraPrinting.Localization
  [Expand]DevExpress.XtraPrinting.Native
  [Expand]DevExpress.XtraPrinting.Shape
  [Expand]DevExpress.XtraPrinting.Shape.Native
  [Expand]DevExpress.XtraPrinting.WebClientUIControl.DataContracts
  [Expand]DevExpress.XtraPrinting.XamlExport
  [Expand]DevExpress.XtraPrintingLinks
  [Expand]DevExpress.XtraReports
  [Expand]DevExpress.XtraReports.Design
  [Expand]DevExpress.XtraReports.Expressions
  [Expand]DevExpress.XtraReports.Parameters
  [Expand]DevExpress.XtraReports.ReportGeneration
  [Expand]DevExpress.XtraReports.UI
  [Collapse]DevExpress.XtraScheduler
   [Expand]AdditionalAppointmentsDragEventArgs Class
   [Expand]AgendaViewAppointmentDisplayOptions Class
    AllowDisplayAppointmentDependencyForm Enumeration
    AllowDisplayAppointmentForm Enumeration
   [Collapse]Appointment Interface
     Appointment Members
    [Expand]Appointment Properties
    [Collapse]Appointment Methods
     [Expand]Assign Method
      Copy Method
      CreateException Method
      CreateNewReminder Method
      DeleteExceptions Method
      FindException Method
      GetExceptions Method
      GetOccurrence Method
      RestoreOccurrence Method
   [Expand]AppointmentBaseCollection Class
   [Expand]AppointmentCancelEventArgs Class
   [Expand]AppointmentCollection Class
   [Expand]AppointmentConflictEventArgs Class
    AppointmentConflictEventHandler Delegate
    AppointmentConflictsMode Enumeration
    AppointmentContinueArrowDisplayType Enumeration
   [Expand]AppointmentCustomFieldMapping Class
   [Expand]AppointmentCustomFieldMappingCollection Class
   [Expand]AppointmentDependency Interface
   [Expand]AppointmentDependencyBaseCollection Class
   [Expand]AppointmentDependencyCollection Class
   [Expand]AppointmentDependencyCustomFieldMapping Class
   [Expand]AppointmentDependencyCustomFieldMappingCollection Class
   [Expand]AppointmentDependencyMappingInfo Class
    AppointmentDependencySelectionChangeAction Enumeration
    AppointmentDependencyType Enumeration
   [Expand]AppointmentDisplayOptions Class
   [Expand]AppointmentDisplayTextEventArgs Class
    AppointmentDisplayTextEventHandler Delegate
   [Expand]AppointmentDragDropOptionsBase Class
   [Expand]AppointmentDragEventArgs Class
    AppointmentDragEventHandler Delegate
   [Expand]AppointmentDragInfo Class
   [Expand]AppointmentEventArgs Class
    AppointmentEventHandler Delegate
   [Expand]AppointmentExportedEventArgs Class
    AppointmentExportedEventHandler Delegate
   [Expand]AppointmentExportingEventArgs Class
    AppointmentExportingEventHandler Delegate
   [Expand]AppointmentImportedEventArgs Class
    AppointmentImportedEventHandler Delegate
   [Expand]AppointmentImportingEventArgs Class
    AppointmentImportingEventHandler Delegate
   [Expand]AppointmentMappingInfo Class
   [Expand]AppointmentOperationEventArgs Class
    AppointmentOperationEventHandler Delegate
   [Expand]AppointmentResizeEventArgs Class
    AppointmentResizeEventHandler Delegate
   [Expand]AppointmentResourceIdCollection Class
    AppointmentSelectionChangeAction Enumeration
    AppointmentSnapToCellsMode Enumeration
    AppointmentStatusDisplayType Enumeration
    AppointmentStatusType Enumeration
   [Expand]AppointmentStorageBase Class
   [Expand]AppointmentSynchronizedEventArgs Class
    AppointmentSynchronizedEventHandler Delegate
   [Expand]AppointmentSynchronizingEventArgs Class
    AppointmentSynchronizingEventHandler Delegate
    AppointmentTimeDisplayType Enumeration
    AppointmentTimeVisibility Enumeration
    AppointmentType Enumeration
   [Expand]CancelListChangedEventArgs Class
    CancelListChangedEventHandler Delegate
   [Expand]CellsAutoHeightOptions Class
    ColorSavingType Enumeration
   [Expand]CustomFieldCollection Class
   [Expand]CustomFieldMappingBase<T> Class
   [Expand]CustomFieldMappingCollectionBase<T> Class
   [Expand]CustomizeMessageBoxCaptionEventArgs Class
    CustomizeMessageBoxCaptionEventHandler Delegate
   [Expand]DateNavigatorQueryActiveViewTypeEventArgs Class
    DateNavigatorQueryActiveViewTypeHandler Delegate
    DateTimeSavingMode Enumeration
   [Expand]DayIntervalCollection Class
   [Expand]DayViewAppointmentDisplayOptions Class
    DstBehaviorType Enumeration
   [Expand]EmptyResourceId Class
   [Expand]ExchangeAppointmentEventArgs Class
    ExchangeAppointmentEventHandler Delegate
   [Expand]ExchangeExceptionEventArgs Class
    ExchangeExceptionEventHandler Delegate
   [Expand]FetchAppointmentsEventArgs Class
    FetchAppointmentsEventHandler Delegate
    FieldValueType Enumeration
    FirstDayOfWeek Enumeration
   [Expand]FixedDurationIntervalCollection Class
   [Expand]GanttViewAppointmentDisplayOptions Class
    HeaderImageAlign Enumeration
    HeaderImageSizeMode Enumeration
   [Expand]IAppointmentDependencyFactory Interface
   [Expand]IAppointmentDependencyStorage Interface
   [Expand]IAppointmentFactory Interface
   [Expand]IAppointmentLabel Interface
   [Expand]IAppointmentLabelStorage Interface
   [Expand]IAppointmentStatus Interface
   [Expand]IAppointmentStatusStorage Interface
   [Expand]IAppointmentStorageBase Interface
   [Expand]IIdProvider Interface
   [Expand]IPersistentObject Interface
   [Expand]IPersistentObjectStorage<T> Interface
   [Expand]IRecurrenceInfo Interface
   [Expand]IResourceFactory Interface
   [Expand]IResourceStorageBase Interface
   [Expand]ISchedulerColorSchemaCollection<T> Interface
   [Expand]ISchedulerInplaceEditorEx Interface
   [Expand]ISchedulerMappingConverter Interface
   [Expand]ISchedulerStorageBase Interface
   [Expand]MappingBase Class
   [Expand]MappingCollection Class
    MappingConversionBehavior Enumeration
   [Expand]MappingInfoBase<T> Class
   [Expand]MonthIntervalCollection Class
   [Expand]MonthViewAppointmentDisplayOptions Class
   [Expand]MoreButtonClickedEventArgs Class
    MoreButtonClickedEventHandler Delegate
    MouseWheelScrollAction Enumeration
    NavigationButtonVisibility Enumeration
   [Expand]OccurrenceCalculator Class
   [Expand]OptionsSelectionBehavior Class
   [Expand]OriginalOccurrenceDateHelper Class
    PercentCompleteDisplayType Enumeration
   [Expand]PersistentObject Class
   [Expand]PersistentObjectCancelEventArgs Class
    PersistentObjectCancelEventHandler Delegate
   [Expand]PersistentObjectEventArgs Class
    PersistentObjectEventHandler Delegate
   [Expand]PersistentObjectsEventArgs Class
    PersistentObjectsEventHandler Delegate
   [Expand]PersistentObjectStorage<T> Class
    QueryDeleteAppointmentResult Enumeration
   [Expand]QueryResourceColorSchemaEventArgs Class
    QueryResourceColorSchemaEventHandler Delegate
   [Expand]QueryWorkTimeEventArgs Class
    QueryWorkTimeEventHandler Delegate
   [Expand]RangeControlAdjustEventArgs Class
    RangeControlAdjustEventHandler Delegate
    RangeControlDataDisplayType Enumeration
   [Expand]RecurrenceInfo Class
    RecurrenceRange Enumeration
    RecurrenceType Enumeration
    RecurrentAppointmentAction Enumeration
   [Expand]RecurringReminder Class
   [Expand]Reminder Class
   [Expand]ReminderAlertNotification Class
   [Expand]ReminderAlertNotificationCollection Class
   [Expand]ReminderBase Class
   [Expand]ReminderBaseAlertNotification Class
   [Expand]ReminderBaseAlertNotificationCollection Class
   [Expand]ReminderBaseEventArgs Class
   [Expand]ReminderCancelEventArgs Class
   [Expand]ReminderCollection Class
   [Expand]ReminderEventArgs Class
    ReminderEventHandler Delegate
    RemindersFormDefaultAction Enumeration
   [Expand]RemindersFormDefaultActionEventArgs Class
    RemindersFormDefaultActionEventHandler Delegate
    ResizedSide Enumeration
   [Expand]Resource Interface
   [Expand]ResourceBaseCollection Class
   [Expand]ResourceCollection Class
   [Expand]ResourceCustomFieldMapping Class
   [Expand]ResourceCustomFieldMappingCollection Class
   [Expand]ResourceEmpty Class
   [Expand]ResourceIdCollection Class
   [Expand]ResourceMappingInfo Class
    ResourceNavigatorVisibility Enumeration
   [Expand]ResourceStorageBase Class
   [Expand]SchedulerColumnPadding Class
   [Expand]SchedulerCompatibility Class
   [Expand]SchedulerControlCompatibility Class
   [Expand]SchedulerDragData Class
    SchedulerGroupType Enumeration
    SchedulerMenuItemId Enumeration
   [Expand]SchedulerNavigationButtonOptions Class
   [Expand]SchedulerNotificationOptions Class
   [Expand]SchedulerOptionsBehaviorBase Class
   [Expand]SchedulerOptionsCustomization Class
   [Expand]SchedulerOptionsViewBase Class
   [Expand]SchedulerResourceHeaderOptionsBase Class
    SchedulerScrollBarVisibility Enumeration
   [Expand]SchedulerStorageBase Class
   [Expand]SchedulerUnhandledExceptionEventArgs Class
    SchedulerUnhandledExceptionEventHandler Delegate
    SchedulerViewType Enumeration
   [Expand]SelectionBarOptions Class
    SynchronizeOperation Enumeration
   [Expand]TimeIndicatorDisplayOptionsBase Class
    TimeIndicatorVisibility Enumeration
   [Expand]TimeInterval Class
   [Expand]TimeIntervalCollection Class
   [Expand]TimeIntervalCollectionEx Class
   [Expand]TimeIntervalEventArgs Class
    TimeIntervalEventHandler Delegate
   [Expand]TimelineViewAppointmentDisplayOptions Class
    TimeMarkerVisibility Enumeration
   [Expand]TimeOfDayInterval Class
   [Expand]TimeOfDayIntervalCollection Class
   [Expand]TimeRuler Class
   [Expand]TimeRulerCollection Class
    TimeRulerHorizontalAlignment Enumeration
   [Expand]TimeScale Class
   [Expand]TimeScale15Minutes Class
   [Expand]TimeScaleCollection Class
   [Expand]TimeScaleDay Class
   [Expand]TimeScaleFixedInterval Class
   [Expand]TimeScaleHour Class
   [Expand]TimeScaleMonth Class
   [Expand]TimeScaleQuarter Class
   [Expand]TimeScaleWeek Class
   [Expand]TimeScaleYear Class
   [Expand]TimeSlot Class
   [Expand]TimeSlotCollection Class
   [Expand]TimeZoneHelper Class
    ToolTipVisibility Enumeration
    UpdateSelectionDurationAction Enumeration
    UsedAppointmentType Enumeration
   [Expand]UserInterfaceObject Class
   [Expand]UserInterfaceObjectCollection<T> Class
   [Expand]VisibleResourcesChangedEventArgs Class
    VisibleResourcesChangedEventHandler Delegate
    WeekDays Enumeration
   [Expand]WeekDaysWorkDay Class
   [Expand]WeekIntervalCollection Class
    WeekOfMonth Enumeration
   [Expand]WeekViewAppointmentDisplayOptions Class
   [Expand]WorkDaysCollection Class
   [Expand]WorkTimeInterval Class
  [Expand]DevExpress.XtraScheduler.Compatibility
  [Expand]DevExpress.XtraScheduler.Drawing
  [Expand]DevExpress.XtraScheduler.Exchange
  [Expand]DevExpress.XtraScheduler.iCalendar
  [Expand]DevExpress.XtraScheduler.iCalendar.Components
  [Expand]DevExpress.XtraScheduler.Localization
  [Expand]DevExpress.XtraScheduler.Native
  [Expand]DevExpress.XtraScheduler.Outlook
  [Expand]DevExpress.XtraScheduler.Outlook.Interop
  [Expand]DevExpress.XtraScheduler.Reporting
  [Expand]DevExpress.XtraScheduler.Services
  [Expand]DevExpress.XtraScheduler.Services.Implementation
  [Expand]DevExpress.XtraScheduler.Tools
  [Expand]DevExpress.XtraScheduler.UI
  [Expand]DevExpress.XtraScheduler.Xml
  [Expand]DevExpress.XtraSpellChecker
  [Expand]DevExpress.XtraSpellChecker.Rules
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Appointment.CreateException Method

Creates an exceptional appointment within a chain of recurring appointments.

Namespace:DevExpress.XtraScheduler
Assembly:DevExpress.XtraScheduler.v19.2.Core.dll

Expanded Syntax

Parameters

type
Type: AppointmentType
An AppointmentType value that specifies the type of the exceptional appointment.
recurrenceIndex
Type: Int32
A zero-based integer which identifies the index in the chain of recurring appointments at which the new exceptional appointment will be created.

Return value

Type: Appointment
An Appointment object which is the newly created exceptional appointment.

Expanded Remarks

To create a recurring appointment you should create a pattern appointment (its Type property should be set to AppointmentType.Pattern) and specify the recurrence rule using the RecurrenceInfo property. At run time, each pattern appointment generates a series of appointments, which is called a "recurrence chain". A recurrence chain is a series of regular occurrences (individual appointments) which will occur one after another at specified time intervals. An individual appointment (regular occurrence) in the chain has its Type property set to AppointmentType.Occurrence. Each occurrence in the chain is identified by a zero-based recurrence index specified by the RecurrenceIndex property.

The CreateException method allows you to modify an appointment (individual occurrence) in the chain when you have to change its location or start time. Also, you can delete an individual occurrence so it is excluded from the recurrence chain.

To modify a regular occurrence, call the CreateException method with the type parameter set to AppointmentType.ChangedOccurrence. As a result, a new appointment will be created based upon the pattern, and it will replace the specified regular occurrence. You can then change the settings of the new appointment as required.

To delete a regular occurrence, call the CreateException method with the type parameter set to AppointmentType.DeletedOccurrence. A new hidden appointment will be created so it replaces the regular occurrence at the specified recurrence index.

Use the RestoreOccurrence method to restore the default state and settings of the individual occurrence.

The code below illustrates how to fix a different time for the recurring "Dinner" appointment that occurs on December 24.

Expanded See Also

Is this topic helpful?​​​​​​​