Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[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]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Collapse]eXpressApp Framework
 [Expand]Fundamentals
 [Expand]Getting Started
 [Collapse]Concepts
  [Expand]Application Solution Components
  [Collapse]Business Model Design
    Business Model Design Basics
    Built-in Business Classes for Most Popular Scenarios
   [Expand]Business Model Design with Entity Framework
   [Expand]Business Model Design with XPO
    Non-Persistent Objects
    PropertyChanged Event in Business Classes
   [Collapse]Data Types Supported by built-in Editors
     Key Properties
    [Expand]String Properties
    [Expand]Numeric Properties
    [Expand]Date and Time Properties
    [Expand]Boolean Properties
    [Expand]BLOB Image Properties
    [Expand]Collection Properties
    [Expand]Reference (Foreign Key, Complex Type) Properties
    [Expand]File Attachment Properties
    [Expand]Type Properties
    [Expand]Enumeration Properties
    [Expand]Criteria Properties
    [Expand]Color Properties
     Geolocation Properties
     Miscellaneous Property Types
    Mapping Complex Types to the Database
   [Expand]Types Info Subsystem
    Connect an XAF Application to a Database Provider
    Data Annotations in Data Model
    Create and Update the Application's Database
  [Expand]Application Model
  [Expand]UI Construction
  [Expand]Extend Functionality
  [Expand]Data Manipulation and Business Logic
  [Expand]Security System
  [Expand]Localization
  [Expand]System Module
  [Expand]Extra Modules
  [Expand]Debugging and Error Handling
  [Expand]Filtering
  [Expand]Application Life Cycle
 [Expand]Design-Time Features
 [Expand]Functional Testing
 [Expand]Deployment
 [Expand]Task-Based Help
  Frequently Asked Questions
 [Expand]API Reference
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Miscellaneous Property Types

Expanded Data Types displayed by WinForms Property Editors

Each WinForms Property Editor has a control that displays a corresponding property in a Detail View, and a repository item that displays a property in a List Editor that supports in-place editing. Both the control and repository item are shown below.

Data Type

Image

Property Editor Type and Description

IAnalysis AnalysisEditorWin

Intended for displaying properties that reference an object implementing the IAnalysis interface.
This Property Editor is supplied with the Pivot Chart Module. Its control represents a user control that contains a tab control with two pages. One page contains a Pivot Grid. The second page contains the Chart Control and two check edits: ShowRowGrandTotalCheckEdit and ShowColumnGrandTotalCheckEdit. When the Analysis class from the Business Class Library has been added, the AnalysisEditorWin allows end-users to build analysis reports on the data of a specified type. For details, refer to the Pivot Chart Module Overview topic.

Control: AnalysisControlWin.

Repository Item: There is no repository item. A textual representation of an Analysis object will be displayed.

IChartDataSourceProvider ChartPropertyEditor

Used to display key performance indicator results supplied by the KPI Module as a chart.
You can see this Property Editor in action by using the Show Chart Action in a KPIScorecard Detail View.

Control: ChartControl.

Repository Item: There is no repository item. A textual representation of an IChartDataSourceProvider object will be displayed.

IEvent.Label SchedulerLabelPropertyEditor

Used to display the Label property of a business class implementing the built-in IEvent interface by default.
This Property Editor is supplied with the Scheduler Module. Its control represents an image combobox. Its items represent the AppointmentLabel objects. These objects are contained in the control's SchedulerStorage, and can be accessed using the AppointmentStorage.Labels collection of the AppointmentStorage, returned by the SchedulerStorage.Appointments property.
To expand the editor's drop-down window, use Alt + Down Arrow.

Control: AppointmentLabelEdit editor from the XtraScheduler Library.

Repository Item: There is no repository item. The Scheduler control displays the Event.Label property in a specific way.

IEvent.Status SchedulerStatusPropertyEditor

Used to display the Status property of a business class implementing the built-in IEvent interface by default.
This Property Editor is supplied with the Scheduler Module. Its control represents an image combobox. Its items represent the AppointmentStatus objects. These objects are contained in the control's SchedulerStorage, and can be accessed via the AppointmentStorage.Statuses collection, returned by the SchedulerStorage.Appointments property.
To expand the editor's drop-down window, use Alt + Down Arrow.

Control: AppointmentStatusEdit editor from the XtraScheduler Library.

Repository Item: There is no repository item. The Scheduler control displays the Event.Label property in a specific way.

ISparklineProvider SparklinePropertyEditor

Used to display a key performance indicator trend supplied by the KPI Module as a sparkline.
You can see this Property Editor in action in a KPIScorecard Detail View.

Control: ChartControl.

Repository Item: A custom SparklineRepositoryItem that uses a ChartControl to display data.

ITrackingRecordVisualizationInfo WorkflowVisualizationPropertyEditor

Used by the WinForms Workflow Module to display the TrackingRecordVisualizationInfo property in the Views displaying information on running workflow instances.

Control: WorkflowVisualizationControl which uses the re-hosted WF designer.

Repository Item: There is no repository item. A textual representation of the bound Activity will be displayed.

ISupportRecurrences.RecurrenceInfoXml SchedulerRecurrenceInfoPropertyEditor

Used to display the RecurrenceInfoXml property of a business class by default implementing the built-in IEvent and ISupportRecurrences interfaces.
This Property Editor is supplied with the Scheduler Module. When clicking or double-clicking the ellipsis button of the ButtonEdit control representing this Property Editor, a form is invoked. This form allows end-users to set the current event's recurrence options or remove the recurrence.

Control: ButtonEdit editor from the XtraEditors Library.

Repository Item: There is no repository item. The Scheduler control displays the ISupportRecurrences.RecurrenceInfoXml property in a specific way.

String RichTextPropertyEditor

Intended for string properties. To use it, set it for the PropertyEditorType property of the required BOModel | <Class> | OwnMembers | <Member> or Views | <DetailView> | Items | <PropertyEditor> node.
The control's height is calculated by multiplying the value set for the corresponding RowCount property and a default height for a row. If the RowCount property is not specified, it is set to 10. If it is set to 0, it is assumed that 15 rows will fit in the control.
The RepositoryItemRtfEditEx repository item is displayed via the RtfEditEx editor, representing a descendant of the BlobBaseEdit editor from the XtraEditors Library. This editor displays the PopupRtfEditExForm form as a pop-up form.

Control: RichTextBoxWithBinding that is a descendant of the System.Windows.Forms.RichTextBox editor.

Repository Item: RepositoryItemRtfEditEx that is a descendant of the RepositoryItemBlobBaseEdit repository item from the XtraEditors Library.

String WorkflowPropertyEditor

Used by the WinForms Workflow Module to display the Xaml property in the Views displaying workflow definitions.

Control: WorkflowDesignerControl uses the re-hosted WF designer.

Repository Item: There is no repository item. A textual representation of the bound Activity will be displayed.

Any data type
or
DefaultPropertyEditor
Important

The DefaultPropertyEditor has a number of limitations and should not be used intentionally in your applications. For instance, this Property Editor does not support the Conditional Appearance functionality.

Used when there is no default Property Editor for the current property's data type and the PropertyEditorType property of the corresponding IModelMember node is not specified.
GridControl is used when the property represents a collection implementing either the IEnumerable or ITypedList interface.
StringEdit is used for the remaining properties. It displays the property's textual representation.
Both the GridControl and StringEdit display data in read-only mode by default.

Control: GridControl editor from the XtraGrid Library or StringEdit editor used by the StringPropertyEditor.

Repository Item: There is no specific repository item.

Any type property that must be protected from viewing ProtectedContentPropertyEditor

Used for properties that are prohibited to be viewed by the current user by the Security System by default.
The "Protected Content" text for the ProtectedContentEdit control is taken from the IModelApplication.ProtectedContentText property of the Application Model's Application node.
This Property Editor is always read-only.
For details on approaches to granting permissions to users, refer to the Security System Overview topic and the Security Demo application.

Control: ProtectedContentEdit that is a descendant of the StringEdit editor used by the IntegerPropertyEditor

Repository Item: RepositoryItemProtectedContentTextEdit that is a descendant of the RepositoryItemTextEdit repository item from the XtraEditors Library

Expanded Data Types displayed by ASP.NET Property Editors

Each ASP.NET Property Editor has controls that display a property in a Detail View's View and Edit mode (see DetailView.ViewEditMode). These controls are listed below.

Data Type

Image

Property Editor Type and Description

Byte[] ASPxByteArrayPropertyEditor

Used for byte[] properties by default.
Represents the ASPxStringPropertyEditor descendant.
Displays the property's value using the UTF8 encoding. If you need to use another encoding, inherit from this Property Editor and override the GetPropertyDisplayValue method.
Note that this Property Editor is always read-only.

View Mode Control: System.Web.UI.WebControls.Label.

Edit Mode Control: ASPxTextBox, or ASPxMemo editor from the ASPxEditors Library.

IAnalysis AnalysisEditorWeb

Intended for displaying properties that reference an object implementing the IAnalysis interface.
This Property Editor is supplied with the Pivot Chart Module. Its control represents a user control that contains a tab control with two pages. One page contains a Pivot Grid. The second page contains the Chart Control. When having the Analysis class from the Business Class Library added, the AnalysisEditorWeb allows end-users to build analysis reports on data of a specified type. For details, refer to the Pivot Chart Module Overview topic.

View Mode Control: AnalysisControlWeb.

Edit Mode Control: AnalysisControlWeb.

IChartDataSourceProvider ChartPropertyEditor

Used to display key performance indicator results supplied by the KPI Module as a chart.
You can see this Property Editor in action by using the Show Chart Action in a KPIScorecard Detail View.

View Mode Control: WebChartControlContainer using the WebChartControl to display data.

Edit Mode Control: WebChartControlContainer using the WebChartControl to display data.

IEvent.Label ASPxSchedulerLabelPropertyEditor

Used to display the Label property of a business class implementing the built-in IEvent interface by default.
This Property Editor is supplied with the Scheduler Module. Its control represents an image combobox. Its items represent the AppointmentLabel objects. These objects are contained in the control's SchedulerStorage, and can be accessed via the AppointmentStorage.Labels collection, returned by the SchedulerStorage.Appointments property.
To expand the editor's drop-down window, use Alt + Down Arrow.

View Mode Control: System.Web.UI.WebControls.Label.

Edit Mode Control: ASPxComboBox editor from the ASPxEditors Library.

IEvent.Status ASPxSchedulerStatusPropertyEditor

Used to display the Status property of a business class implementing the built-in IEvent interface by default.
This Property Editor is supplied with the Scheduler Module. Its control represents an image combobox. Its items represent the AppointmentStatus objects. These objects are contained in the control's SchedulerStorage, and can be accessed using the AppointmentStorage.Statuses collection, returned by the SchedulerStorage.Appointments property.
To expand the editor's drop-down window, use Alt + Down Arrow.

View Mode Control: System.Web.UI.WebControls.Label.

Edit Mode Control: ASPxComboBox editor from the ASPxEditors Library.

ISparklineProvider SparklinePropertyEditor

Used to display a key performance indicator trend supplied by the KPI Module as a sparkline.
You can see this Property Editor in action in a KPIScorecard Detail View.

View Mode Control: WebChartControl.

Edit Mode Control: WebChartControl.

ISupportRecurrences.RecurrenceInfoXml ASPxSchedulerRecurrenceInfoPropertyEditor

Used to display the RecurrenceInfoXml property of a business class implementing the built-in IEvent and ISupportRecurrences interfaces by default.
This Property Editor is supplied with the Scheduler Module. When clicking the ellipsis button of the ASPxButtonEdit control representing this Property Editor, a form is invoked. This form allows end-users to set the current event's recurrence options or remove the recurrence.

View Mode Control: ASPxLabel from the ASPxEditors Library.

Edit Mode Control: ASPxSchedulerRecurrenceInfoEdit based on the ASPxButtonEdit editor from the ASPxEditors Library.

Any data type ASPxDefaultPropertyEditor
Important

The ASPxDefaultPropertyEditor has a number of limitations and should not be used intentionally in your applications. For instance, this Property Editor does not support the Conditional Appearance functionality.

Used when there is no default Property Editor for the current property's data type, and the PropertyEditorType property of the corresponding IModelMember node is not specified.
Inherited from the ASPxStringPropertyEditor class. Displays the property's value in a read-only mode.

View Mode Control: System.Web.UI.WebControls.Label.

Edit Mode Control: ASPxTextBox editor from the ASPxEditors Library.

Any data type property that must be protected from viewing ASPxProtectedContentPropertyEditor

Used for properties that are prohibited to be viewed by the current user by the Security System by default.
Inherited from the ASPxStringPropertyEditor class. However, this Property Editor is always read-only.
The "Protected Content" text for the ProtectedContentEdit control is taken from the IModelApplication.ProtectedContentText property of the Application Model's Application node.
This Property Editor is always read-only.
For details on approaches to granting permissions to users, refer to the Security System Overview topic and the Security Demo application.

View Mode Control: System.Web.UI.WebControls.Label.

Edit Mode Control: ASPxTextBox editor from the ASPxEditors Library.

Expanded See Also

How would you rate this topic?​​​​​​​