ControlValuePropertyAttribute Klasse

Definition

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

Vererbung

Object

Attribute

ControlValuePropertyAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein ControlValuePropertyAttribute Attribut angewendet wird, das eine Standardeigenschaft und einen Wert auf ein benutzerdefiniertes Steuerelement angibt.

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

Hinweise

Beim Definieren eines Objekts binden Sie in der Regel die Eigenschaft eines ControlParameter Steuerelements an einen Parameter, indem Sie sowohl die Eigenschaften als PropertyName auch die ControlID Eigenschaften festlegen. Wenn die PropertyName Eigenschaft nicht festgelegt ist, wird eine Standardeigenschaft verwendet. Das ControlValuePropertyAttribute Attribut wird auf ein Steuerelement angewendet, um seine Standardeigenschaft anzugeben, an die ein ControlParameter Objekt zur Laufzeit gebunden wird.

Weitere Informationen zur Verwendung von Attributen finden Sie unter "Attribute".

Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz der ControlValuePropertyAttribute Klasse finden Sie im ControlValuePropertyAttribute Konstruktor.

Weitere Informationen

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