ControlValuePropertyAttribute Klasse

Definition

Gibt die Standardeigenschaft eines Steuerelements an, an das zur Laufzeit ein ControlParameter-Objekt gebunden wird.Specifies the default property of a control that a ControlParameter object binds to at run time. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class ControlValuePropertyAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class ControlValuePropertyAttribute : Attribute
type ControlValuePropertyAttribute = class
    inherit Attribute
Public NotInheritable Class ControlValuePropertyAttribute
Inherits Attribute
Vererbung
ControlValuePropertyAttribute
Attribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein ControlValuePropertyAttribute -Attribut angewendet wird, das eine Standard Eigenschaft und einen Standardwert für ein benutzerdefiniertes Steuerelement angibtThe following code example demonstrates how to apply a ControlValuePropertyAttribute attribute that specifies a default property and value to a custom control.


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 Sie ein ControlParameter -Objekt definieren, binden Sie in der Regel die-Eigenschaft eines Steuer Elements an ControlID einen PropertyName -Parameter, indem Sie die Eigenschaften und festlegen.When defining a ControlParameter object, you typically bind a control's property to a parameter by setting both the ControlID and PropertyName properties. Wenn die PropertyName -Eigenschaft nicht festgelegt ist, wird eine Default-Eigenschaft verwendet.If the PropertyName property is not set, a default property is used. Das ControlValuePropertyAttribute -Attribut wird auf ein Steuerelement angewendet, um dessen Standard Eigenschaft ControlParameter anzugeben, an die ein-Objekt zur Laufzeit gebunden wird.The ControlValuePropertyAttribute attribute is applied to a control to specify its default property that a ControlParameter object binds to at run time.

Weitere Informationen zum Verwenden von Attributen finden Sie unter Attribute.For more information about using attributes, see Attributes.

Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz der ControlValuePropertyAttribute-Klasse finden Sie im ControlValuePropertyAttribute-Konstruktor.For a list of initial property values for an instance of the ControlValuePropertyAttribute class, see the ControlValuePropertyAttribute constructor.

Konstruktoren

ControlValuePropertyAttribute(String)

Initialisiert eine neue Instanz der ControlValuePropertyAttribute-Klasse unter Verwendung des angegebenen Eigenschaftennamens.Initializes a new instance of the ControlValuePropertyAttribute class using the specified property name.

ControlValuePropertyAttribute(String, Object)

Initialisiert eine neue Instanz der ControlValuePropertyAttribute-Klasse unter Verwendung des angegebenen Eigenschaftennamens und Standardwerts.Initializes a new instance of the ControlValuePropertyAttribute class using the specified property name and default value.

ControlValuePropertyAttribute(String, Type, String)

Initialisiert eine neue Instanz der ControlValuePropertyAttribute-Klasse unter Verwendung des angegebenen Eigenschaftennamens und Standardwerts.Initializes a new instance of the ControlValuePropertyAttribute class using the specified property name and default value. Der Standardwert wird außerdem in den angegebenen Datentyp konvertiert.The default value is also converted to the specified data type.

Eigenschaften

DefaultValue

Ruft den Standardwert für die Standardeigenschaft eines Steuerelements ab.Gets the default value for the default property of a control.

Name

Ruft die Standardeigenschaft für ein Steuerelement ab.Gets the default property for a control.

TypeId

Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.When implemented in a derived class, gets a unique identifier for this Attribute.

(Geerbt von Attribute)

Methoden

Equals(Object)

Bestimmt, ob die aktuelle Instanz des ControlValuePropertyAttribute-Objekts gleich dem angegebenen Objekt ist.Determines whether the current instance of the ControlValuePropertyAttribute object is equal to the specified object.

GetHashCode()

Gibt den Hashcode für diese Instanz zurück.Returns the hash code for this instance.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
IsDefaultAttribute()

Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Geerbt von Attribute)
Match(Object)

Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Geerbt von Attribute)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.Maps a set of names to a corresponding set of dispatch identifiers.

(Geerbt von Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Geerbt von Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Geerbt von Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.Provides access to properties and methods exposed by an object.

(Geerbt von Attribute)

Gilt für:

Siehe auch