Classe ControlValuePropertyAttribute

Ao definir um ControlParameter de objeto, você normalmente acoplar a propriedade do controle a um parâmetro, definindo ambos o ControlID e PropertyName propriedades. Se a PropertyName propriedade não está definida, uma propriedade padrão é usada. O ControlValuePropertyAttribute atributo é aplicado a um controle para especificar a sua propriedade padrão que um ControlParameter objeto vincula em tempo de execução.

Para obter mais informações sobre como usar os atributos, consulte Estendendo metadados usando atributos.

Para obter uma lista dos valores de propriedade inicial de uma instância da ControlValuePropertyAttribute da classe, consulte a ControlValuePropertyAttribute construtor.

O exemplo de código a seguir demonstra como aplicar um ControlValuePropertyAttribute atributo que especifica um valor para um controle personalizado e a propriedade padrão.

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", "Default 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

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

Referência