ControlValuePropertyAttribute Clase

  • Referencia

Definición

Espacio de nombres:
System.Web.UI
Ensamblado:
System.Web.dll

Especifica la propiedad predeterminada de un control al que se enlaza un objeto ControlParameter en tiempo de ejecución. Esta clase no puede heredarse.

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
Herencia
Object
Attribute
ControlValuePropertyAttribute
Atributos
AttributeUsageAttribute

Ejemplos

En el ejemplo de código siguiente se muestra cómo aplicar un atributo que especifica una ControlValuePropertyAttribute propiedad y un valor predeterminados a un control 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

Comentarios

Al definir un ControlParameter objeto, normalmente se enlaza la propiedad de un control a un parámetro estableciendo las ControlID propiedades y PropertyName . Si la PropertyName propiedad no está establecida, se usa una propiedad predeterminada. El ControlValuePropertyAttribute atributo se aplica a un control para especificar su propiedad predeterminada a la que un ControlParameter objeto se enlaza en tiempo de ejecución.

Para obtener más información sobre el uso de atributos, vea Atributos.

Para obtener una lista con los valores de propiedad iniciales de una instancia de la clase ControlValuePropertyAttribute, vea el constructor ControlValuePropertyAttribute.

Constructores

ControlValuePropertyAttribute(String)

Inicializa una nueva instancia de la clase ControlValuePropertyAttribute con el nombre de propiedad especificado.
ControlValuePropertyAttribute(String, Object)

Inicializa una instancia nueva de la clase ControlValuePropertyAttribute con el nombre de propiedad especificado y el valor predeterminado.
ControlValuePropertyAttribute(String, Type, String)

Inicializa una instancia nueva de la clase ControlValuePropertyAttribute con el nombre de propiedad especificado y el valor predeterminado. El valor predeterminado también se convierte al tipo de datos especificado.

Propiedades

DefaultValue

Obtiene el valor predeterminado de la propiedad predeterminada de un control.
Name

Obtiene la propiedad predeterminada de un control.
TypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.

(Heredado de Attribute)

Métodos

Equals(Object)

Determina si la instancia actual del objeto ControlValuePropertyAttribute es igual al objeto especificado.
GetHashCode()

Devuelve el código hash de esta instancia.
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
IsDefaultAttribute()

Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.

(Heredado de Attribute)
Match(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado.

(Heredado de Attribute)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Implementaciones de interfaz explícitas

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

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.

(Heredado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz.

(Heredado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1).

(Heredado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.

(Heredado de Attribute)

Se aplica a

Consulte también