ControlValuePropertyAttribute Klasa

Definicja

Określa domyślną właściwość formantu, który jest powiązany z ControlParameter obiektem w czasie wykonywania.Specifies the default property of a control that a ControlParameter object binds to at run time. Klasa ta nie może być dziedziczona.This class cannot be inherited.

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

Poniższy przykład kodu demonstruje, jak zastosować ControlValuePropertyAttribute atrybut, który określa domyślną właściwość i wartość do kontrolki niestandardowej.The following code example demonstrates how to apply a ControlValuePropertyAttribute attribute that specifies a default property and value to a custom control.


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 zwykle wiąże się z nim właściwość kontrolki przez ustawienie ControlID PropertyName właściwości i.When defining a ControlParameter object, you typically bind a control's property to a parameter by setting both the ControlID and PropertyName properties. Jeśli PropertyName Właściwość nie jest ustawiona, zostanie użyta domyślna właściwość.If the PropertyName property is not set, a default property is used. Ten ControlValuePropertyAttribute atrybut jest stosowany do kontrolki, aby określić jej właściwość domyślną, ControlParameter z którą obiekt jest powiązany w czasie wykonywania.The ControlValuePropertyAttribute attribute is applied to a control to specify its default property that a ControlParameter object binds to at run time.

Aby uzyskać więcej informacji o korzystaniu z atrybutów, zobacz atrybuty.For more information about using attributes, see Attributes.

Aby uzyskać listę początkowych wartości właściwości dla wystąpienia ControlValuePropertyAttribute klasy, zobacz ControlValuePropertyAttribute Konstruktor.For a list of initial property values for an instance of the ControlValuePropertyAttribute class, see the ControlValuePropertyAttribute constructor.

Konstruktory

ControlValuePropertyAttribute(String)

Inicjuje nowe wystąpienie ControlValuePropertyAttribute klasy przy użyciu określonej nazwy właściwości.Initializes a new instance of the ControlValuePropertyAttribute class using the specified property name.

ControlValuePropertyAttribute(String, Object)

Inicjuje nowe wystąpienie ControlValuePropertyAttribute klasy przy użyciu określonej nazwy właściwości i wartości domyślnej.Initializes a new instance of the ControlValuePropertyAttribute class using the specified property name and default value.

ControlValuePropertyAttribute(String, Type, String)

Inicjuje nowe wystąpienie ControlValuePropertyAttribute klasy przy użyciu określonej nazwy właściwości i wartości domyślnej.Initializes a new instance of the ControlValuePropertyAttribute class using the specified property name and default value. Wartość domyślna jest również konwertowana na określony typ danych.The default value is also converted to the specified data type.

Właściwości

DefaultValue

Pobiera wartość domyślną dla domyślnej właściwości kontrolki.Gets the default value for the default property of a control.

Name

Pobiera właściwość domyślną dla kontrolki.Gets the default property for a control.

TypeId

Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego elementu Attribute .When implemented in a derived class, gets a unique identifier for this Attribute.

(Odziedziczone po Attribute)

Metody

Equals(Object)

Określa, czy bieżące wystąpienie ControlValuePropertyAttribute obiektu jest równe podanemu obiektowi.Determines whether the current instance of the ControlValuePropertyAttribute object is equal to the specified object.

GetHashCode()

Zwraca wartość skrótu dla tego wystąpienia.Returns the hash code for this instance.

GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
IsDefaultAttribute()

Gdy jest zastępowany w klasie pochodnej, wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Odziedziczone po Attribute)
Match(Object)

Gdy jest zastępowany w klasie pochodnej, zwraca wartość wskazującą, czy to wystąpienie jest zgodne z określonym obiektem.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Odziedziczone po Attribute)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

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

Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania.Maps a set of names to a corresponding set of dispatch identifiers.

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

Pobiera informacje o typie dla obiektu, którego można użyć do uzyskania informacji o typie dla interfejsu.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1).Retrieves the number of type information interfaces that an object provides (either 0 or 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.Provides access to properties and methods exposed by an object.

(Odziedziczone po Attribute)

Dotyczy

Zobacz też