ControlValuePropertyAttribute Constructor (String)

 

Initializes a new instance of the ControlValuePropertyAttribute class using the specified property name.

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

public ControlValuePropertyAttribute(
	string name
)

Parameters

name
Type: System.String

The default property for the control.

Use this constructor to create a new instance of the ControlValuePropertyAttribute class using the specified property name. The following table shows the initial property value for an instance of the ControlValuePropertyAttribute class.

Property

Initial value

Name

The value of the name parameter.

The following code example demonstrates how to apply a ControlValuePropertyAttribute attribute that specifies a default property to a custom control. This constructor is called internally by ASP.NET to create a ControlValuePropertyAttribute object that represents the attribute.


using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Text;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace Samples.AspNet.CS.Controls
{
    // Set ControlValueProperty attribute to specify the default
    // property of this control that a ControlParameter object 
    // binds to at run time.
    [DefaultProperty("Text")]
    [ControlValueProperty("Text")]
    public class SimpleCustomControl : WebControl
    {
        private string text;

        [Bindable(true)]
        [Category("Appearance")]
        [DefaultValue("")]
        public string Text
        {
            get
            {
                return text;
            }
            set
            {
                text = value;
            }
        }

        protected override void Render(HtmlTextWriter output)
        {
            output.Write(Text);
        }
    }
}

.NET Framework
Available since 2.0
Return to top
Show: