Udostępnij za pośrednictwem


ControlValuePropertyAttribute Klasa

Definicja

Określa domyślną właściwość kontrolki, z którą ControlParameter obiekt jest powiązany w czasie wykonywania. Klasa ta nie może być dziedziczona.

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
Dziedziczenie
ControlValuePropertyAttribute
Atrybuty

Przykłady

W poniższym przykładzie kodu pokazano, jak zastosować ControlValuePropertyAttribute atrybut, który określa właściwość domyślną i wartość kontrolki niestandardowej.


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

Uwagi

Podczas definiowania ControlParameter obiektu zazwyczaj tworzy się powiązanie właściwości kontrolki z parametrem przez ustawienie właściwości ControlID i PropertyName . Jeśli właściwość nie jest ustawiona PropertyName , zostanie użyta właściwość domyślna. Atrybut ControlValuePropertyAttribute jest stosowany do kontrolki w celu określenia jej właściwości domyślnej ControlParameter , z którą obiekt jest powiązany w czasie wykonywania.

Aby uzyskać więcej informacji na temat używania atrybutów, zobacz Atrybuty.

Aby uzyskać listę początkowych wartości właściwości dla wystąpienia ControlValuePropertyAttribute klasy, zobacz ControlValuePropertyAttribute konstruktor.

Konstruktory

ControlValuePropertyAttribute(String)

Inicjuje ControlValuePropertyAttribute nowe wystąpienie klasy przy użyciu określonej nazwy właściwości.

ControlValuePropertyAttribute(String, Object)

Inicjuje ControlValuePropertyAttribute nowe wystąpienie klasy przy użyciu określonej nazwy właściwości i wartości domyślnej.

ControlValuePropertyAttribute(String, Type, String)

Inicjuje ControlValuePropertyAttribute nowe wystąpienie klasy przy użyciu określonej nazwy właściwości i wartości domyślnej. Wartość domyślna jest również konwertowana na określony typ danych.

Właściwości

DefaultValue

Pobiera wartość domyślną dla właściwości domyślnej kontrolki.

Name

Pobiera właściwość domyślną kontrolki.

TypeId

Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attributeelementu .

(Odziedziczone po Attribute)

Metody

Equals(Object)

Określa, czy bieżące wystąpienie ControlValuePropertyAttribute obiektu jest równe określonemu obiektowi.

GetHashCode()

Zwraca wartość skrótu dla tego wystąpienia.

GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
IsDefaultAttribute()

W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej.

(Odziedziczone po Attribute)
Match(Object)

Po przesłonięciu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi.

(Odziedziczone po Attribute)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Jawne implementacje interfejsu

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

Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania.

(Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Pobiera informacje o typie dla obiektu, który może służyć do pobierania informacji o typie dla interfejsu.

(Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1).

(Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt.

(Odziedziczone po Attribute)

Dotyczy

Zobacz też