ControlValuePropertyAttribute Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Specifica la proprietà predefinita di un controllo alla quale viene associato un oggetto ControlParameter in fase di esecuzione. La 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 ControlParameter oggetto, in genere si associa la proprietà di un 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 associata a un ControlParameter oggetto in fase di esecuzione.

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

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

Costruttori

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

Proprietà

DefaultValue	Ottiene il valore predefinito della proprietà predefinita di un controllo.
Name	Ottiene la proprietà predefinita di un controllo.
TypeId	Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute. (Ereditato da Attribute)

Metodi

Equals(Object)	Determina se l'istanza corrente dell'oggetto ControlValuePropertyAttribute è uguale all'oggetto specificato.
GetHashCode()	Restituisce il codice hash per l'istanza.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsDefaultAttribute()	In caso di 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 equivale a un oggetto specificato. (Ereditato da Attribute)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

_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 relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a 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 a proprietà e metodi esposti da un oggetto. (Ereditato da Attribute)

Si applica a