ControlValuePropertyAttribute Classe

Definição

public ref class ControlValuePropertyAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class ControlValuePropertyAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class)>]
type ControlValuePropertyAttribute = class
    inherit Attribute

Public NotInheritable Class ControlValuePropertyAttribute
Inherits Attribute

Herança

Object

Attribute

ControlValuePropertyAttribute

Atributos

AttributeUsageAttribute

Exemplos

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

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);
        }
    }
}

Imports System.ComponentModel
Imports System.Web.UI

Namespace Samples.AspNet.VB.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", "DefaultText")> Public Class SimpleCustomControl
        Inherits System.Web.UI.WebControls.WebControl

        Dim _text As String

        <Bindable(True), Category("Appearance"), DefaultValue("")> Property [Text]() As String
            Get
                Return _text
            End Get

            Set(ByVal Value As String)
                _text = Value
            End Set
        End Property

        Protected Overrides Sub Render(ByVal output As System.Web.UI.HtmlTextWriter)
            output.Write([Text])
        End Sub

    End Class

End Namespace

Comentários

Ao definir um ControlParameter objeto, você normalmente associa a propriedade de um controle a um parâmetro definindo as propriedades e PropertyName as ControlID propriedades. Se a PropertyName propriedade não estiver definida, uma propriedade padrão será usada. O ControlValuePropertyAttribute atributo é aplicado a um controle para especificar sua propriedade padrão à qual um ControlParameter objeto se associa em tempo de execução.

Para obter mais informações sobre como usar atributos, consulte Atributos.

Para obter uma lista de valores de propriedade iniciais para uma instância da ControlValuePropertyAttribute classe, consulte o ControlValuePropertyAttribute construtor.

Confira também

• Attribute
• ControlParameter
• ControlID
• PropertyName
• Name
• DefaultValue