ControlValuePropertyAttribute Classe

Referência

Definição

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Especifica a propriedade padrão de um controle à qual um objeto ControlParameter se associa no tempo de execução. Essa classe não pode ser herdada.

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

Herança: Object

Attribute
ControlValuePropertyAttribute

Atributos: AttributeUsageAttribute

Exemplos

O exemplo de código a seguir demonstra como aplicar um ControlValuePropertyAttribute atributo que especifica uma propriedade padrão e um valor a um controle personalizado.


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

Comentários

Ao definir um ControlParameter objeto, você normalmente associa a propriedade de um controle a um parâmetro definindo as propriedades e PropertyName as ControlID propriedades. Se a PropertyName propriedade não estiver definida, uma propriedade padrão será usada. O ControlValuePropertyAttribute atributo é aplicado a um controle para especificar sua propriedade padrão à qual um ControlParameter objeto se associa em tempo de execução.

Para obter mais informações sobre como usar atributos, consulte Atributos.

Para obter uma lista de valores de propriedade iniciais para uma instância da ControlValuePropertyAttribute classe, consulte o ControlValuePropertyAttribute construtor.

Construtores

ControlValuePropertyAttribute(String)	Inicializa uma nova instância da classe ControlValuePropertyAttribute usando o nome da propriedade especificado.
ControlValuePropertyAttribute(String, Object)	Inicializa uma nova instância da classe ControlValuePropertyAttribute usando o nome da propriedade e o valor padrão especificados.
ControlValuePropertyAttribute(String, Type, String)	Inicializa uma nova instância da classe ControlValuePropertyAttribute usando o nome da propriedade e o valor padrão especificados. O valor padrão também é convertido para o tipo de dados especificado.

Propriedades

DefaultValue	Obtém o valor padrão para a propriedade padrão de um controle.
Name	Obtém a propriedade padrão para um controle.
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)

Métodos

Equals(Object)	Determina se a instância atual do objeto ControlValuePropertyAttribute é igual ao objeto especificado.
GetHashCode()	Retorna o código hash para a instância.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição. (Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Recupera as informações de tipo para um objeto, que pode ser usado para obter as informações de tipo para uma interface. (Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Retorna o número de interfaces de informações do tipo que um objeto fornece (0 ou 1). (Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fornece acesso a propriedades e métodos expostos por um objeto. (Herdado de Attribute)

Aplica-se a