Exportar (0) Imprimir
Expandir todo

ControlValuePropertyAttribute (Clase)

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

Espacio de nombres: System.Web.UI
Ensamblado: System.Web (en system.web.dll)

[AttributeUsageAttribute(AttributeTargets.Class)] 
public sealed class ControlValuePropertyAttribute : Attribute
/** @attribute AttributeUsageAttribute(AttributeTargets.Class) */ 
public final class ControlValuePropertyAttribute extends Attribute
AttributeUsageAttribute(AttributeTargets.Class) 
public final class ControlValuePropertyAttribute extends Attribute
No aplicable.

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

Para obtener más información acerca del uso de atributos, vea Extender metadatos mediante atributos.

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

En el ejemplo de código siguiente se muestra cómo puede aplicar un atributo ControlValuePropertyAttribute que especifica una 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);
        }
    }
}


System.Object
   System.Attribute
    System.Web.UI.ControlValuePropertyAttribute

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar:
© 2014 Microsoft