ControlValuePropertyAttribute Classe

Définition

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

Héritage

Object

Attribute

ControlValuePropertyAttribute

Attributs

AttributeUsageAttribute

Exemples

L’exemple de code suivant montre comment appliquer un ControlValuePropertyAttribute attribut qui spécifie une propriété et une valeur par défaut à un contrôle personnalisé.

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

Remarques

Lors de la définition d’un objet, vous liez généralement la propriété d’un ControlParameter contrôle à un paramètre en définissant à la fois les propriétés et PropertyName les ControlID propriétés. Si la PropertyName propriété n’est pas définie, une propriété par défaut est utilisée. L’attribut ControlValuePropertyAttribute est appliqué à un contrôle pour spécifier sa propriété par défaut qu’un ControlParameter objet lie au moment de l’exécution.

Pour plus d’informations sur l’utilisation d’attributs, consultez Attributs.

Pour obtenir la liste des valeurs de propriété initiales d’une instance de la ControlValuePropertyAttribute classe, consultez le ControlValuePropertyAttribute constructeur.

Voir aussi

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