ControlValuePropertyAttribute Classe

Définition

Spécifie la propriété par défaut d'un contrôle à laquelle se rattache un contrôle ControlParameter au moment de l'exécution.Specifies the default property of a control that a ControlParameter object binds to at run time. Cette classe ne peut pas être héritée.This class cannot be inherited.

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
Héritage
ControlValuePropertyAttribute
Attributs

Exemples

L’exemple de code suivant montre comment appliquer un ControlValuePropertyAttribute attribut qui spécifie une propriété et une valeur par défaut à un contrôle personnalisé.The 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

Remarques

Lors de la définition d’un ControlParameter objet, vous liez généralement la propriété d’un contrôle à un paramètre en définissant à la fois les ControlID PropertyName Propriétés et.When defining a ControlParameter object, you typically bind a control's property to a parameter by setting both the ControlID and PropertyName properties. Si la PropertyName propriété n’est pas définie, une propriété par défaut est utilisée.If the PropertyName property is not set, a default property is used. L' ControlValuePropertyAttribute attribut est appliqué à un contrôle pour spécifier sa propriété par défaut à laquelle un ControlParameter objet est lié au moment de l’exécution.The ControlValuePropertyAttribute attribute is applied to a control to specify its default property that a ControlParameter object binds to at run time.

Pour plus d’informations sur l’utilisation d’attributs, consultez attributs.For more information about using attributes, see Attributes.

Pour obtenir la liste des valeurs de propriété initiales d'une instance de la classe ControlValuePropertyAttribute, consultez le constructeur ControlValuePropertyAttribute.For a list of initial property values for an instance of the ControlValuePropertyAttribute class, see the ControlValuePropertyAttribute constructor.

Constructeurs

ControlValuePropertyAttribute(String)

Initialise une nouvelle instance de la classe ControlValuePropertyAttribute à l'aide du nom de propriété spécifié.Initializes a new instance of the ControlValuePropertyAttribute class using the specified property name.

ControlValuePropertyAttribute(String, Object)

Initialise une nouvelle instance de la classe ControlValuePropertyAttribute avec la valeur par défaut et le nom de propriété spécifié.Initializes a new instance of the ControlValuePropertyAttribute class using the specified property name and default value.

ControlValuePropertyAttribute(String, Type, String)

Initialise une nouvelle instance de la classe ControlValuePropertyAttribute avec la valeur par défaut et le nom de propriété spécifié.Initializes a new instance of the ControlValuePropertyAttribute class using the specified property name and default value. La valeur par défaut est également convertie en type de données spécifié.The default value is also converted to the specified data type.

Propriétés

DefaultValue

Reçoit la valeur par défaut pour la propriété par défaut d'un contrôle.Gets the default value for the default property of a control.

Name

Obtient la propriété par défaut d'un contrôle.Gets the default property for a control.

TypeId

Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Hérité de Attribute)

Méthodes

Equals(Object)

Détermine si l'instance actuelle de l'objet ControlValuePropertyAttribute est égale à l'objet spécifié.Determines whether the current instance of the ControlValuePropertyAttribute object is equal to the specified object.

GetHashCode()

Retourne le code de hachage de cette instance.Returns the hash code for this instance.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
IsDefaultAttribute()

En cas de substitution dans une classe dérivée, indique si la valeur de cette instance est la valeur par défaut pour la classe dérivée.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Hérité de Attribute)
Match(Object)

En cas de substitution dans une classe dérivée, retourne une valeur indiquant si cette instance équivaut à un objet spécifié.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Hérité de Attribute)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)

Implémentations d’interfaces explicites

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

Mappe un jeu de noms avec un jeu correspondant d'identificateurs de dispatch.Maps a set of names to a corresponding set of dispatch identifiers.

(Hérité de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Récupère les informations de type pour un objet, qui peuvent être utilisées pour obtenir les informations de type d'une interface.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Hérité de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Récupère le nombre d'interfaces d'informations de type fourni par un objet (0 ou 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Hérité de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fournit l'accès aux propriétés et aux méthodes exposées par un objet.Provides access to properties and methods exposed by an object.

(Hérité de Attribute)

S’applique à

Voir aussi