デフォルトでは、PropertyGrid コントロールには、実行時にユーザーが編集できるプロパティの説明は表示されません。ただし、編集されるプロパティに関する情報を表示したい場合もあります。Visual Studio の［プロパティ］ウィンドウの［説明］ペインと同様に、PropertyGrid コントロールでは各プロパティの説明を表示できます。C1PropertyGridクラスのShowDescriptionプロパティをTrueに設定すると、プロパティの説明を表示できます。これにより、PropertyGrid コントロールの下部に説明の領域が追加され、現在フォーカスがあるプロパティの説明が表示され、次の図のように表示されます。

PropertyGrid showing property descriptions

Set Property Description using Attributes

PropertyGrid allows you to add property descriptions programmatically by using the Description property. You can use the following code to add property descriptions:

C#	コードのコピー
public partial class PropertyDescription: Window { public ClassBinding() { InitializeComponent(); // 参照するオブジェクトを作成します var customer = new Customerdescription(); // Customer プロパティを表示します propertyGrid.SelectedObject = customer; propertyGrid.ShowDescription = true; } } public class Customerdescription { [Display(Name = "Customer Name", Description = "Stores the name of customer")] public string Name { get; set; } [Display(Name = "e-Mail address", Description = "Unique email address of the customer")] public string EMail { get; set; } [Display(Name = "Customer Address", Description = "Residence Address of the customer")] public string Address { get; set; } [Display(Name = "Customer Since", Description = "Customer's signup date")] public DateTime CustomerSince { get; set; } [Display(Name = "Point Balance", Description = "Balance of the loyalty points")] public int? PointBalance { get; set; } [Display(Name = "Send Newsletter", Description = "Send news letter to the customer")] public bool SendNewsletter { get; set; } }

コードのコピー

public partial class PropertyDescription: Window
{
    public ClassBinding()
    {
        InitializeComponent();

        // 参照するオブジェクトを作成します
        var customer = new Customerdescription();

        // Customer プロパティを表示します
        propertyGrid.SelectedObject = customer;
        propertyGrid.ShowDescription = true;
    }
}

public class Customerdescription
{
    [Display(Name = "Customer Name", Description = "Stores the name of customer")]
     public string Name { get; set; }

    [Display(Name = "e-Mail address", Description = "Unique email address of the customer")]
     public string EMail { get; set; }

    [Display(Name = "Customer Address", Description = "Residence Address of the customer")]
     public string Address { get; set; }

    [Display(Name = "Customer Since", Description = "Customer's signup date")]
     public DateTime CustomerSince { get; set; }

    [Display(Name = "Point Balance", Description = "Balance of the loyalty points")]
     public int? PointBalance { get; set; }

    [Display(Name = "Send Newsletter", Description = "Send news letter to the customer")]
     public bool SendNewsletter { get; set; }
}