ControlValuePropertyAttribute.Name Property

 

Gets the default property for a control.

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

Public ReadOnly Property Name As String

Property Value

Type: System.String

The default property for a control.

When a ControlParameter object is defined without its PropertyName property set, use the Name property to determine the default property that is bound to the ControlParameter object at run time.

The following code example demonstrates how to set the Name property by applying a ControlValuePropertyAttribute attribute to a custom control.


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

.NET Framework
Available since 2.0
Return to top
Show: