ControlValuePropertyAttribute Classe

Definizione

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

Ereditarietà

Object

Attribute

ControlValuePropertyAttribute

Attributi

AttributeUsageAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come applicare un ControlValuePropertyAttribute attributo che specifica una proprietà e un valore predefiniti a un controllo personalizzato.

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

Commenti

Quando si definisce un oggetto, in genere si associa la proprietà di un ControlParameter controllo a un parametro impostando entrambe le ControlID proprietà e PropertyName . Se la PropertyName proprietà non è impostata, viene utilizzata una proprietà predefinita. L'attributo ControlValuePropertyAttribute viene applicato a un controllo per specificare la proprietà predefinita a cui un ControlParameter oggetto viene associato in fase di esecuzione.

Per altre informazioni sull'uso degli attributi, vedere Attributi.

Per un elenco dei valori iniziali delle proprietà per un'istanza della ControlValuePropertyAttribute classe , vedere il ControlValuePropertyAttribute costruttore .

Vedi anche

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