# Mappings | WPF Controls | DevExpress Documentation ## Overview When you bind the Scheduler to a data source, you need to map [appointments](/WPF/119211/controls-and-libraries/scheduler/appointments), [resources](/WPF/119219/controls-and-libraries/scheduler/resources), [labels](/WPF/119214/controls-and-libraries/scheduler/appointments/labels) and [statuses](/WPF/119215/controls-and-libraries/scheduler/appointments/statuses) properties to data source fields. The names of the database fields are usually fixed, and you cannot change them. Mappings are used to adjust the Scheduler data model to the existing data model. The SchedulerControl uses [Mapping](/WPF/DevExpress.Xpf.Scheduling.Mapping) instances to connect the object properties with the corresponding data fields. Use the [Mapping.Converter](/WPF/DevExpress.Xpf.Scheduling.Mapping.Converter) property to register a value converter for a custom storage format. Review the [Mapping Converters](/WPF/119833/controls-and-libraries/scheduler/data-binding/mapping-converters) topic for more information. You can define **Custom Mappings** - any number of mappings to data source fields that are not used by the Scheduler itself. The content of these fields is available using the [SourceObjectContainer.CustomFields](/WPF/DevExpress.Xpf.Scheduling.SourceObjectContainer.CustomFields) property of the [AppointmentItem](/WPF/DevExpress.Xpf.Scheduling.AppointmentItem), [ResourceItem](/WPF/DevExpress.Xpf.Scheduling.ResourceItem), [AppointmentLabelItem](/WPF/DevExpress.Xpf.Scheduling.AppointmentLabelItem) and [AppointmentStatusItem](/WPF/DevExpress.Xpf.Scheduling.AppointmentStatusItem) objects. To specify a custom mapping, create a [CustomFieldMapping](/WPF/DevExpress.Xpf.Scheduling.CustomFieldMapping) instance and add it to the [MappingsBase.CustomFieldMappings](/WPF/DevExpress.Xpf.Scheduling.MappingsBase.CustomFieldMappings) collection. To learn more, see the [Custom Fields](/WPF/119962/controls-and-libraries/scheduler/data-binding/custom-fields) document. ## Appointment Mappings | Mapping | Description | | --- | --- | | [SchedulerItemBaseMappings.AllDay](/WPF/DevExpress.Xpf.Scheduling.SchedulerItemBaseMappings.AllDay) | Specifies the mapping that binds the appointment’s [AllDay](/WPF/DevExpress.Xpf.Scheduling.SchedulerItemBase.AllDay) property to the data source field. | | [AppointmentMappings.Description](/WPF/DevExpress.Xpf.Scheduling.AppointmentMappings.Description) | Specifies the mapping that binds the appointment’s [AppointmentItem.Description](/WPF/DevExpress.Xpf.Scheduling.AppointmentItem.Description) property to the data source field. | | [AppointmentMappings.End](/WPF/DevExpress.Xpf.Scheduling.SchedulerItemBaseMappings.End) **(required mapping)** | Specifies the mapping that binds the appointment’s [SchedulerItemBase.End](/WPF/DevExpress.Xpf.Scheduling.SchedulerItemBase.End) property to the data source field. | | [AppointmentMappings.Id](/WPF/DevExpress.Xpf.Scheduling.SchedulerItemBaseMappings.Id) | Gets or sets the mapping that binds the appointment’s [SourceObjectContainer.Id](/WPF/DevExpress.Xpf.Scheduling.SourceObjectContainer.Id) property to the data source field. | | [AppointmentMappings.Location](/WPF/DevExpress.Xpf.Scheduling.AppointmentMappings.Location) | Specifies the mapping that binds the appointment’s [AppointmentItem.Location](/WPF/DevExpress.Xpf.Scheduling.AppointmentItem.Location) property to the data source field. | | [AppointmentMappings.LabelId](/WPF/DevExpress.Xpf.Scheduling.AppointmentMappings.LabelId) | Specifies the mapping that binds the appointment’s [AppointmentItem.LabelId](/WPF/DevExpress.Xpf.Scheduling.AppointmentItem.LabelId) property to the data source field. | | [AppointmentMappings.QueryStart](/WPF/DevExpress.Xpf.Scheduling.SchedulerItemBaseMappings.QueryStart) | Specifies the mapping that binds the appointment’s [SchedulerItemBase.QueryStart](/WPF/DevExpress.Xpf.Scheduling.SchedulerItemBase.QueryStart) property to the data source field. | | [AppointmentMappings.QueryEnd](/WPF/DevExpress.Xpf.Scheduling.SchedulerItemBaseMappings.QueryEnd) | Specifies the mapping that binds the appointment’s [SchedulerItemBase.QueryEnd](/WPF/DevExpress.Xpf.Scheduling.SchedulerItemBase.QueryEnd) property to the data source field. | | [AppointmentMappings.RecurrenceInfo](/WPF/DevExpress.Xpf.Scheduling.SchedulerItemBaseMappings.RecurrenceInfo) **(required mapping for recurring appointments)** | Gets or sets the mapping that binds the appointment’s [AppointmentItem.RecurrenceInfo](/WPF/DevExpress.Xpf.Scheduling.SchedulerItemBase.RecurrenceInfo) property to the data source field. | | [AppointmentMappings.Reminder](/WPF/DevExpress.Xpf.Scheduling.AppointmentMappings.Reminder) | Gets or sets the mapping that binds the appointment’s [AppointmentItem.Reminder](/WPF/DevExpress.Xpf.Scheduling.AppointmentItem.Reminder) property to the data source field. | | [AppointmentMappings.ResourceId](/WPF/DevExpress.Xpf.Scheduling.SchedulerItemBaseMappings.ResourceId) | Specifies the mapping that binds the appointment’s [SchedulerItemBase.ResourceId](/WPF/DevExpress.Xpf.Scheduling.SchedulerItemBase.ResourceId) and [AppointmentItem.ResourceIds](/WPF/DevExpress.Xpf.Scheduling.SchedulerItemBase.ResourceIds) properties to the data source field. | | [AppointmentMappings.Start](/WPF/DevExpress.Xpf.Scheduling.SchedulerItemBaseMappings.Start) **(required mapping)** | Specifies the mapping that binds the appointment’s [SchedulerItemBase.Start](/WPF/DevExpress.Xpf.Scheduling.SchedulerItemBase.Start) property to the data source field. | | [AppointmentMappings.StatusId](/WPF/DevExpress.Xpf.Scheduling.AppointmentMappings.StatusId) | Gets or sets the mapping that binds the appointment’s [AppointmentItem.StatusId](/WPF/DevExpress.Xpf.Scheduling.AppointmentItem.StatusId) property to the data source field. | | [AppointmentMappings.Subject](/WPF/DevExpress.Xpf.Scheduling.AppointmentMappings.Subject) | Specifies the mapping that binds the appointment’s [AppointmentItem.Subject](/WPF/DevExpress.Xpf.Scheduling.AppointmentItem.Subject) property to the data source field. | | [AppointmentMappings.TimeZoneId](/WPF/DevExpress.Xpf.Scheduling.SchedulerItemBaseMappings.TimeZoneId) | Specifies the mapping that binds the appointment’s [SchedulerItemBase.TimeZoneId](/WPF/DevExpress.Xpf.Scheduling.SchedulerItemBase.TimeZoneId) property to the data source field. | | [AppointmentMappings.Type](/WPF/DevExpress.Xpf.Scheduling.AppointmentMappings.Type) **(required mapping for recurring appointments)** | Gets or sets the mapping that binds the appointment’s [AppointmentItem.Type](/WPF/DevExpress.Xpf.Scheduling.AppointmentItem.Type) property to the data source field. | ## Appointment Label Mappings | Mapping | Description | | --- | --- | | [AppointmentLabelMappings.Brush](/WPF/DevExpress.Xpf.Scheduling.AppointmentLabelMappings.Brush) | Gets or sets the mapping that binds the appointment label’s [AppointmentLabelItem.Brush](/WPF/DevExpress.Xpf.Scheduling.AppointmentLabelItem.Brush) property to the data source field. | | [AppointmentLabelMappings.BrushName](/WPF/DevExpress.Xpf.Scheduling.AppointmentLabelMappings.BrushName) | Gets or sets the mapping that binds the appointment label’s [AppointmentLabelItem.BrushName](/WPF/DevExpress.Xpf.Scheduling.AppointmentLabelItem.BrushName) property to the data source field. | | [AppointmentLabelMappings.BrushSavingType](/WPF/DevExpress.Xpf.Scheduling.AppointmentLabelMappings.BrushSavingType) | Specifies the format type used to store the brush information. | | [AppointmentLabelMappings.Caption](/WPF/DevExpress.Xpf.Scheduling.AppointmentLabelMappings.Caption) | Gets or sets the mapping that binds the appointment label’s [AppointmentLabelItem.Caption](/WPF/DevExpress.Xpf.Scheduling.AppointmentLabelItem.Caption) property to the data source. | | [AppointmentLabelMappings.Id](/WPF/DevExpress.Xpf.Scheduling.AppointmentLabelMappings.Id) | Gets or sets the mapping that binds the appointment label’s [SourceObjectContainer.Id](/WPF/DevExpress.Xpf.Scheduling.SourceObjectContainer.Id) property to the data source. | ## Appointment Status Mappings | Mapping | Description | | --- | --- | | [AppointmentStatusMappings.Brush](/WPF/DevExpress.Xpf.Scheduling.AppointmentStatusMappings.Brush) | Specifies the mapping that binds the appointment label’s [AppointmentStatusItem.Brush](/WPF/DevExpress.Xpf.Scheduling.AppointmentStatusItem.Brush) property to the data source field. | | [AppointmentStatusMappings.BrushName](/WPF/DevExpress.Xpf.Scheduling.AppointmentStatusMappings.BrushName) | Gets or sets the mapping that binds the appointment label’s [AppointmentStatusItem.BrushName](/WPF/DevExpress.Xpf.Scheduling.AppointmentStatusItem.BrushName) property to the data source field. | | [AppointmentStatusMappings.BrushSavingType](/WPF/DevExpress.Xpf.Scheduling.AppointmentStatusMappings.BrushSavingType) | Specifies the type of format used to store the brush information. | | [AppointmentStatusMappings.Caption](/WPF/DevExpress.Xpf.Scheduling.AppointmentStatusMappings.Caption) | Specifies the mapping that binds the appointment status’s [AppointmentStatusItem.Caption](/WPF/DevExpress.Xpf.Scheduling.AppointmentStatusItem.Caption) property to the data source field. | | [AppointmentStatusMappings.Id](/WPF/DevExpress.Xpf.Scheduling.AppointmentStatusMappings.Id) | Specifies the mapping that binds the appointment status’s [SourceObjectContainer.Id](/WPF/DevExpress.Xpf.Scheduling.SourceObjectContainer.Id) property to the data source field. | ## Resource Mappings | Mapping | Description | | --- | --- | | [ResourceMappings.Brush](/WPF/DevExpress.Xpf.Scheduling.ResourceMappings.Brush) | Specifies the mapping that binds the resource’s [ResourceItem.Brush](/WPF/DevExpress.Xpf.Scheduling.ResourceItem.Brush) property to the data source field. | | [ResourceMappings.BrushName](/WPF/DevExpress.Xpf.Scheduling.ResourceMappings.BrushName) | Specifies the mapping that binds the resource’s [ResourceItem.BrushName](/WPF/DevExpress.Xpf.Scheduling.ResourceItem.BrushName) property to the data source field. | | [ResourceMappings.BrushSavingType](/WPF/DevExpress.Xpf.Scheduling.ResourceMappings.BrushSavingType) | Specifies the format type used to store the brush information. | | [ResourceMappings.Caption](/WPF/DevExpress.Xpf.Scheduling.ResourceMappings.Caption) | Specifies the mapping that binds the resource’s [ResourceItem.Caption](/WPF/DevExpress.Xpf.Scheduling.ResourceItem.Caption) property to the data source field. | | [ResourceMappings.Id](/WPF/DevExpress.Xpf.Scheduling.ResourceMappings.Id) | Specifies the mapping that binds the resource’s [SourceObjectContainer.Id](/WPF/DevExpress.Xpf.Scheduling.SourceObjectContainer.Id) property to the data source field. | | [ResourceMappings.Visible](/WPF/DevExpress.Xpf.Scheduling.ResourceMappings.Visible) | Gets or sets the mapping that binds the appointment’s [ResourceItem.Visible](/WPF/DevExpress.Xpf.Scheduling.ResourceItem.Visible) property to the data source field. | ## Time Region Mappings | Mapping | Description | | --- | --- | | [TimeRegionMappings.Brush](/WPF/DevExpress.Xpf.Scheduling.TimeRegionMappings.Brush) | Gets or sets the mapping that binds the time region’s [TimeRegionItem.Brush](/WPF/DevExpress.Xpf.Scheduling.TimeRegionItem.Brush) property to the data source. | | [TimeRegionMappings.BrushName](/WPF/DevExpress.Xpf.Scheduling.TimeRegionMappings.BrushName) | Gets or sets the mapping that binds the time region’s [TimeRegionItem.BrushName](/WPF/DevExpress.Xpf.Scheduling.TimeRegionItem.BrushName) property to the data source. | | [TimeRegionMappings.BrushSavingType](/WPF/DevExpress.Xpf.Scheduling.TimeRegionMappings.BrushSavingType) | Specifies the type of format used to store the brush information. | | [TimeRegionMappings.Type](/WPF/DevExpress.Xpf.Scheduling.TimeRegionMappings.Type) | Gets or sets the mapping that binds the time region’s [TimeRegionItem.Type](/WPF/DevExpress.Xpf.Scheduling.TimeRegionItem.Type) property to the data source. |