Edit this page

Data Annotations

This article will show you how to use Data Annotations with RadPropertyGrid.

We will discuss the following attributes:

They allow you to categorize different properties into separate groups, set some of them as read-only or define description for each one of them.

Creating RadPropertyGrid Application

First, for the purpose of this article, we will create a new Employee class with a couple of properties:

Example 1: Creating the Employee class

public class Employee
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public string PhoneNum { get; set; }
    public int Salary { get; set; }
    public string Occupation { get; set; }
    public DateTime StartingDate { get; set; }
}
Public Class Employee
    Public Property FirstName() As String
    Public Property LastName() As String
    Public Property PhoneNum() As String
    Public Property Salary() As Integer
    Public Property Occupation() As String
    Public Property StartingDate() As Date
End Class

The declaration of RadPropertyGrid control inside the Grid:

Example 2: Declaring RadPropertyGrid

<telerik:RadPropertyGrid x:Name="propertyGrid1" />

Once the class Employee is defined, you may use it for creating an object of this type and bind it to RadPropertyGrid:

Example 3: Binding Employee instance to RadPropertyGrid

this.propertyGrid1.Item = new Employee()
{
    FirstName = "Sarah",
    LastName = "Blake",
    PhoneNum = "(555) 943-231",
    Occupation = "Supplies Manager",
    Salary = 3500,
    StartingDate = new DateTime(2005, 12, 4)
};
Me.propertyGrid1.Item = New Employee() With {
  .FirstName = "Sarah",
  .LastName = "Blake",
  .Occupation = "Supplied Manager",
  .StartingDate = New DateTime(2005, 4, 12),
  .Salary = 3500
}

After you run the application you should see the following:

Figure 1: RadPropertyGrid bound to an Employee instance

RadPropertyGrid bound to an Employee instance

If you want to use Data Annotations in your application, you have to add a reference to the System.ComponentModel.DataAnnotations assembly.

Display

The Display attribute specifies localizable strings for data types and members that are used in the user interface. You can use its following properties:

  • Name: The value to be displayed instead of the property name.

  • Description: A description of the property. This will be shown in RadPropertyGrid's DescriptionPanel.

  • GroupName: Used when you want to categorize different properties into separate groups.

  • Order: Used when you want to set a property's display order.

Example 4 demonstrates how you can specify a Display attribute for a property:

Example 4: Setting Display attribute

//Rename the StartingDate property to Year in the UI
[Display(Name = "Year")]
public DateTime StartingDate { get; set; }
//Set a description to the FirstName property and categorize it to be from the group "Personal Information"
[Display(Description = "Employee's first name.", GroupName = "Personal Information")]
public string FirstName { get; set; }
//Set a description to the LastName property and categorize it to be from the group "Personal Information"
[Display(Description = "Employee's last name.", GroupName = "Personal Information")]
public string LastName { get; set; }
'Rename the StartingDate property to Year in the UI
<Display(Name:="Year")>
Public Property StartingDate() As Date
'Set a description to the FirstName property and categorize it to be from the group "Personal Information"
<Display(Description:="Employee's first name.", GroupName:="Personal Information")>
Public Property FirstName() As String
'Set a description to the LastName property and categorize it to be from the group "Personal Information"
<Display(Description:="Employee's last name.", GroupName:="Personal Information")>
Public Property LastName() As String

Browsable

The Browsable attribute specifies whether a property should be displayed or not.

Example 5: Setting Browsable attribute

//Hide StartingDate from the UI
[Browsable(false)]
public DateTime StartingDate { get; set; }
'Hide StartingDate from the UI
<Browsable(False)>
Public Property StartingDate() As Date

ReadOnly

The ReadOnly attribute specifies whether the property this attribute is bound to is read-only or read/write.

Example 6: Setting ReadOnly attribute

//Set StartingDate as Read-Only
[ReadOnly(true)]
public DateTime StartingDate { get; set; }
'Set StartingDate as Read-Only
<ReadOnly>
Public Property StartingDate() As Date

To see these attributes in action, let's modify the Employee class and see the result in RadPropertGrid.

Example 7: Modifying sample data

[Display(Description = "Employee's first name.", GroupName = "Personal Information")]
public string FirstName { get; set; }
[Display(Description = "Employee's last name.", GroupName = "Personal Information")]
public string LastName { get; set; }
[Display(Name = "Occupation", GroupName = "Job Description")]
public string Occupation { get; set; }
[Browsable(false)]
public int Salary { get; set; }
[Display(Name = "Number", GroupName = "Job Description")]
public string PhoneNum { get; set; }
[ReadOnly(true)]
public DateTime StartingDate { get; set; }
<Display(Description:="Employee's first name.", GroupName:="Personal Information")>
Public Property FirstName() As String
<Display(Description:="Employee's last name.", GroupName:="Personal Information")>
Public Property LastName() As String
<Display(Name:="Occupation", GroupName:="Job Description")>
Public Property Occupation() As String
<Browsable(False)>
Public Property Salary() As Integer
<Display(Name:="Number", GroupName:="Job Description")>
Public Property PhoneNum() As String
<ReadOnly>
Public Property StartingDate() As Date

Here's the resulting RadPropertyGrid sorted alphabetically and in grouped mode:

Figure 2: RadPropertyGrid with data annotations sorted alphabetically

RadPropertyGrid with data annotations sorted alphabetically

Figure 3: RadPropertyGrid with data annotations in grouped mode

Rad Property Grid Data Annotations 5

See also