Freigeben über


ControlValuePropertyAttribute Konstruktoren

Definition

Initialisiert eine neue Instanz der ControlValuePropertyAttribute-Klasse.

Überlädt

ControlValuePropertyAttribute(String)

Initialisiert eine neue Instanz der ControlValuePropertyAttribute-Klasse unter Verwendung des angegebenen Eigenschaftsnamens.

ControlValuePropertyAttribute(String, Object)

Initialisiert eine neue Instanz der ControlValuePropertyAttribute-Klasse unter Verwendung des angegebenen Eigenschaftennamens und Standardwerts.

ControlValuePropertyAttribute(String, Type, String)

Initialisiert eine neue Instanz der ControlValuePropertyAttribute-Klasse unter Verwendung des angegebenen Eigenschaftennamens und Standardwerts. Der Standardwert wird außerdem in den angegebenen Datentyp konvertiert.

ControlValuePropertyAttribute(String)

Initialisiert eine neue Instanz der ControlValuePropertyAttribute-Klasse unter Verwendung des angegebenen Eigenschaftsnamens.

public:
 ControlValuePropertyAttribute(System::String ^ name);
public ControlValuePropertyAttribute (string name);
new System.Web.UI.ControlValuePropertyAttribute : string -> System.Web.UI.ControlValuePropertyAttribute
Public Sub New (name As String)

Parameter

name
String

Die Standardeigenschaft für das Steuerelement.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein ControlValuePropertyAttribute Attribut angewendet wird, das eine Standardeigenschaft auf ein benutzerdefiniertes Steuerelement angibt. Dieser Konstruktor wird intern von ASP.NET aufgerufen, um ein ControlValuePropertyAttribute Objekt zu erstellen, das das Attribut darstellt.


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")]
    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")> 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

Verwenden Sie diesen Konstruktor, um eine neue Instanz der ControlValuePropertyAttribute Klasse mithilfe des angegebenen Eigenschaftennamens zu erstellen. Die folgende Tabelle zeigt den anfänglichen Eigenschaftswert für eine Instanz der ControlValuePropertyAttribute Klasse.

Eigenschaft Anfangswert
Name Der Wert des name-Parameters.

Siehe auch

Gilt für

ControlValuePropertyAttribute(String, Object)

Initialisiert eine neue Instanz der ControlValuePropertyAttribute-Klasse unter Verwendung des angegebenen Eigenschaftennamens und Standardwerts.

public:
 ControlValuePropertyAttribute(System::String ^ name, System::Object ^ defaultValue);
public ControlValuePropertyAttribute (string name, object defaultValue);
new System.Web.UI.ControlValuePropertyAttribute : string * obj -> System.Web.UI.ControlValuePropertyAttribute
Public Sub New (name As String, defaultValue As Object)

Parameter

name
String

Die Standardeigenschaft für das Steuerelement.

defaultValue
Object

Der Standardwert der Standardeigenschaft.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein ControlValuePropertyAttribute Attribut angewendet wird, das eine Standardeigenschaft und einen Wert auf ein benutzerdefiniertes Steuerelement angibt. Dieser Konstruktor wird intern von ASP.NET aufgerufen, um ein ControlValuePropertyAttribute Objekt zu erstellen, das das Attribut darstellt.


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

Verwenden Sie diesen Konstruktor, um eine neue Instanz der ControlValuePropertyAttribute Klasse mithilfe des angegebenen Eigenschaftennamens und des Standardwerts zu erstellen. In der folgenden Tabelle werden anfängliche Eigenschaftswerte für eine Instanz der ControlValuePropertyAttribute-Klasse aufgeführt.

Eigenschaft Anfangswert
Name Der Wert des name-Parameters.
DefaultValue Der Wert des defaultValue-Parameters.

Siehe auch

Gilt für

ControlValuePropertyAttribute(String, Type, String)

Initialisiert eine neue Instanz der ControlValuePropertyAttribute-Klasse unter Verwendung des angegebenen Eigenschaftennamens und Standardwerts. Der Standardwert wird außerdem in den angegebenen Datentyp konvertiert.

public:
 ControlValuePropertyAttribute(System::String ^ name, Type ^ type, System::String ^ defaultValue);
public ControlValuePropertyAttribute (string name, Type type, string defaultValue);
new System.Web.UI.ControlValuePropertyAttribute : string * Type * string -> System.Web.UI.ControlValuePropertyAttribute
Public Sub New (name As String, type As Type, defaultValue As String)

Parameter

name
String

Die Standardeigenschaft für das Steuerelement.

type
Type

Der Type, in den der Standardwert konvertiert wird.

defaultValue
String

Der Standardwert der Standardeigenschaft.

Hinweise

Verwenden Sie diesen Konstruktor, um eine neue Instanz der ControlValuePropertyAttribute Klasse mithilfe des angegebenen Eigenschaftennamens und des Standardwerts zu erstellen. Diese Version des Konstruktors versucht auch, den Standardwert in den vom Parameter angegebenen type Datentyp zu konvertieren. Wenn der Standardwert nicht konvertiert werden kann, wird die DefaultValue Eigenschaft nicht festgelegt. In der folgenden Tabelle werden anfängliche Eigenschaftswerte für eine Instanz der ControlValuePropertyAttribute-Klasse aufgeführt.

Eigenschaft Anfangswert
Name Der Wert des name-Parameters.
DefaultValue Der Wert des defaultValue Parameters, wenn der Wert in den durch den type Parameter angegebenen Datentyp konvertiert werden kann.

Siehe auch

Gilt für