Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]Welcome to DevExpress .NET Documentation
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
   Reporting
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Printing-Exporting
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Diagram Control
  [Collapse]Scheduler (legacy)
   [Expand]Overview
   [Expand]Getting Started
   [Collapse]Fundamentals
    [Expand]Scheduler Elements
    [Expand]Appointments
     Resources
    [Expand]Views
     Pop-up Menus
    [Expand]Data Binding
    [Collapse]Mappings
      Appointment Mappings
      Resource Mappings
      Required Fields
      Custom Fields
      Mapping Converters
    [Expand]Supported Formats
    [Expand]Styles and Templates
     Services
     Time Zones
    [Expand]Printing
     Product Class Structure
     Scheduling Basics
   [Expand]Visual Elements
   [Expand]Examples
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Mapping Converters

Note

You are viewing documentation for the legacy WPF Scheduler control. If you're starting a new project, we strongly recommend that you use a new control declared in the DevExpress.Xpf.Scheduling namespace. If you decide to upgrade an existing project in order to switch to the updated scheduler control, see the Migration Guidelines document.

Mapping converters allow you to apply custom logic to mapping.

Expanded Overview

To associate a value converter with a mapping, create a class that implements the ISchedulerMappingConverter interface and subsequently implement the Convert and ConvertBack methods. Converters can change data from one type to another, translate data based on additional information, or change format in which the data are stored.

The data are propagated forth and back between the property, default mapping method and a data source field. You can insert a converter in place of default mapping method, between the property and the default mapping method or between the default mapping method and the data source field. Converter position in that propagation chain is defined by the MappingConversionBehavior enumeration.

The converter processing order is illustrated in the following image.

Expanded Available Converters

You can assign converters and specify the processing order using the properties listed in the following table.

Mapping

Converter

Behavior

AppointmentMappingInfo.AllDay AppointmentMappingInfo.AllDayConverter AppointmentMappingInfo.AllDayConversionBehavior
AppointmentMappingInfo.AppointmentId AppointmentMappingInfo.AppointmentIdConverter AppointmentMappingInfo.AppointmentIdConversionBehavior
AppointmentMappingInfo.Description AppointmentMappingInfo.DescriptionConverter AppointmentMappingInfo.DescriptionConversionBehavior
AppointmentMappingInfo.End AppointmentMappingInfo.EndConverter AppointmentMappingInfo.EndConversionBehavior
AppointmentMappingInfo.Label AppointmentMappingInfo.LabelConverter AppointmentMappingInfo.LabelConversionBehavior
AppointmentMappingInfo.Location AppointmentMappingInfo.LocationConverter AppointmentMappingInfo.LocationConversionBehavior
AppointmentMappingInfo.OriginalOccurrenceEnd AppointmentMappingInfo.OriginalOccurrenceEndConverter AppointmentMappingInfo.OriginalOccurrenceEndConversionBehavior
AppointmentMappingInfo.OriginalOccurrenceStart AppointmentMappingInfo.OriginalOccurrenceStartConverter AppointmentMappingInfo.OriginalOccurrenceStartConversionBehavior
AppointmentMappingInfo.PercentComplete AppointmentMappingInfo.PercentCompleteConverter AppointmentMappingInfo.PercentCompleteConversionBehavior
AppointmentMappingInfo.RecurrenceInfo AppointmentMappingInfo.RecurrenceInfoConverter AppointmentMappingInfo.RecurrenceInfoConversionBehavior
AppointmentMappingInfo.ReminderInfo AppointmentMappingInfo.ReminderInfoConverter AppointmentMappingInfo.ReminderInfoConversionBehavior
AppointmentMappingInfo.ResourceId AppointmentMappingInfo.ResourceIdConverter AppointmentMappingInfo.ResourceIdConversionBehavior
AppointmentMappingInfo.Start AppointmentMappingInfo.StartConverter AppointmentMappingInfo.StartConversionBehavior
AppointmentMappingInfo.Status AppointmentMappingInfo.StatusConverter AppointmentMappingInfo.StatusConversionBehavior
AppointmentMappingInfo.Subject AppointmentMappingInfo.SubjectConverter AppointmentMappingInfo.SubjectConversionBehavior
AppointmentMappingInfo.TimeZoneId AppointmentMappingInfo.TimeZoneIdConverter AppointmentMappingInfo.TimeZoneIdConversionBehavior
AppointmentMappingInfo.Type AppointmentMappingInfo.TypeConverter AppointmentMappingInfo.TypeConversionBehavior
ResourceMappingInfo.Caption ResourceMappingInfo.CaptionConverter ResourceMappingInfo.CaptionConversionBehavior
ResourceMappingInfo.Color ResourceMappingInfo.ColorConverter ResourceMappingInfo.ColorConversionBehavior
ResourceMappingInfo.Id ResourceMappingInfo.IdConverter ResourceMappingInfo.IdConversionBehavior
ResourceMappingInfo.Image ResourceMappingInfo.ImageConverter ResourceMappingInfo.ImageConversionBehavior
ResourceMappingInfo.ParentId ResourceMappingInfo.ParentIdConverter ResourceMappingInfo.ParentIdConversionBehavior

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