ControlValuePropertyAttribute Classe

Référence

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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. Cette classe ne peut pas être héritée.

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: Object

Attribute
ControlValuePropertyAttribute

Attributs: AttributeUsageAttribute

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é.


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 propriétés et PropertyName les ControlID propriétés. Si la PropertyName propriété n’est pas définie, une propriété par défaut est utilisée. L’attribut ControlValuePropertyAttribute 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.

Pour plus d’informations sur l’utilisation d’attributs, consultez Attributs.

Pour obtenir la liste des valeurs de propriété initiales d'une instance de la classe ControlValuePropertyAttribute, consultez le constructeur ControlValuePropertyAttribute.

Constructeurs

ControlValuePropertyAttribute(String)	Initialise une nouvelle instance de la classe ControlValuePropertyAttribute à l'aide du nom de propriété spécifié.
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é.
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é. La valeur par défaut est également convertie en type de données spécifié.

Propriétés

DefaultValue	Reçoit la valeur par défaut pour la propriété par défaut d'un contrôle.
Name	Obtient la propriété par défaut d'un contrôle.
TypeId	Lors de l'implémentation dans une classe dérivée, obtient un identificateur unique pour l'objet 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é.
GetHashCode()	Retourne le code de hachage de cette instance.
GetType()	Obtient le Type de l'instance actuelle. (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. (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é. (Hérité de Attribute)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (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. (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. (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). (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. (Hérité de Attribute)

S’applique à