Condividi tramite

ControlValuePropertyAttribute Classe

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.dll

Specifica la proprietà predefinita di un controllo a cui un oggetto ControlParameter viene associato in fase di esecuzione. Questa classe non può essere ereditata.

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
Ereditarietà
Object
Attribute
ControlValuePropertyAttribute
Attributi
AttributeUsageAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come applicare un ControlValuePropertyAttribute attributo che specifica una proprietà e un valore predefiniti a un controllo personalizzato.


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

Commenti

Quando si definisce un oggetto, in genere si associa la proprietà di un ControlParameter controllo a un parametro impostando entrambe le ControlID proprietà e PropertyName . Se la PropertyName proprietà non è impostata, viene utilizzata una proprietà predefinita. L'attributo ControlValuePropertyAttribute viene applicato a un controllo per specificare la proprietà predefinita a cui un ControlParameter oggetto viene associato in fase di esecuzione.

Per altre informazioni sull'uso degli attributi, vedere Attributi.

Per un elenco dei valori iniziali delle proprietà per un'istanza della ControlValuePropertyAttribute classe , vedere il ControlValuePropertyAttribute costruttore .

Costruttori

Nome Descrizione
ControlValuePropertyAttribute(String, Object)

Inizializza una nuova istanza della ControlValuePropertyAttribute classe utilizzando il nome della proprietà e il valore predefinito specificati.
ControlValuePropertyAttribute(String, Type, String)

Inizializza una nuova istanza della ControlValuePropertyAttribute classe utilizzando il nome della proprietà e il valore predefinito specificati. Il valore predefinito viene convertito anche nel tipo di dati specificato.
ControlValuePropertyAttribute(String)

Inizializza una nuova istanza della ControlValuePropertyAttribute classe utilizzando il nome della proprietà specificato.

Proprietà

Nome Descrizione
DefaultValue

Ottiene il valore predefinito per la proprietà predefinita di un controllo .
Name

Ottiene la proprietà predefinita per un controllo .
TypeId

Se implementato in una classe derivata, ottiene un identificatore univoco per questo Attribute.

(Ereditato da Attribute)

Metodi

Nome Descrizione
Equals(Object)

Determina se l'istanza corrente dell'oggetto ControlValuePropertyAttribute è uguale all'oggetto specificato.
GetHashCode()

Restituisce il codice hash per questa istanza.
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
IsDefaultAttribute()

Quando sottoposto a override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.

(Ereditato da Attribute)
Match(Object)

Quando sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.

(Ereditato da Attribute)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

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

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.

(Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo per un oggetto, che può essere utilizzato per ottenere le informazioni sul tipo per un'interfaccia.

(Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).

(Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso alle proprietà e ai metodi esposti da un oggetto .

(Ereditato da Attribute)

Si applica a

Vedi anche