ControlValuePropertyAttribute.Name Eigenschaft

Definition

Ruft die Standardeigenschaft für ein Steuerelement ab.

public:
 property System::String ^ Name { System::String ^ get(); };
public string Name { get; }
member this.Name : string
Public ReadOnly Property Name As String

Eigenschaftswert

Die Standardeigenschaft für ein Steuerelement.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Name Eigenschaft festgelegt wird, indem ein ControlValuePropertyAttribute Attribut auf ein benutzerdefiniertes Steuerelement angewendet wird.


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

Wenn ein ControlParameter Objekt ohne seinen PropertyName Eigenschaftensatz definiert ist, verwenden Sie die Name -Eigenschaft, um die Standardeigenschaft zu bestimmen, die zur Laufzeit an das ControlParameter Objekt gebunden ist.

Gilt für:

Weitere Informationen