Поделиться через


ControlValuePropertyAttribute Класс

Определение

Определяет используемое по умолчанию свойство элемента управления, к которому во время выполнения привязывается объект ControlParameter. Этот класс не наследуется.

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
Наследование
ControlValuePropertyAttribute
Атрибуты

Примеры

В следующем примере кода показано, как применить ControlValuePropertyAttribute атрибут, указывающий свойство и значение по умолчанию, к пользовательскому элементу управления.


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

Комментарии

При определении ControlParameter объекта обычно свойство элемента управления привязывается к параметру, задавая ControlID свойства и PropertyName . PropertyName Если свойство не задано, используется свойство по умолчанию. Атрибут ControlValuePropertyAttribute применяется к элементу управления для указания его свойства по умолчанию, к которому ControlParameter привязывается объект во время выполнения.

Дополнительные сведения об использовании атрибутов см. в разделе Атрибуты.

Список начальных значений свойств для экземпляра класса ControlValuePropertyAttribute см. в описании конструктора ControlValuePropertyAttribute.

Конструкторы

ControlValuePropertyAttribute(String)

Инициализирует новый экземпляр класса ControlValuePropertyAttribute с помощью указанного имени свойства.

ControlValuePropertyAttribute(String, Object)

Выполняет инициализацию нового экземпляр класса ControlValuePropertyAttribute с заданными именем свойства и значением по умолчанию.

ControlValuePropertyAttribute(String, Type, String)

Выполняет инициализацию нового экземпляр класса ControlValuePropertyAttribute с заданными именем свойства и значением по умолчанию. Используемое по умолчанию значение преобразовывается в указанный тип данных.

Свойства

DefaultValue

Возвращает значение по умолчанию для используемого по умолчанию свойства элемента управления.

Name

Возвращает свойство, используемое по умолчанию для элемента управления.

TypeId

В случае реализации в производном классе возвращает уникальный идентификатор для этого атрибута Attribute.

(Унаследовано от Attribute)

Методы

Equals(Object)

Определяет равенство текущего экземпляра объекта ControlValuePropertyAttribute с указанным объектом.

GetHashCode()

Возвращает хэш-код данного экземпляра.

GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
IsDefaultAttribute()

При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса.

(Унаследовано от Attribute)
Match(Object)

При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту.

(Унаследовано от Attribute)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Явные реализации интерфейса

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

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.

(Унаследовано от Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Возвращает сведения о типе объекта, которые можно использовать для получения сведений о типе интерфейса.

(Унаследовано от Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1).

(Унаследовано от Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Предоставляет доступ к открытым свойствам и методам объекта.

(Унаследовано от Attribute)

Применяется к

См. также раздел