ControlValuePropertyAttribute Třída

Definice

Určuje výchozí vlastnost ovládacího prvku, ke kterému se ControlParameter objekt váže v době běhu.Specifies the default property of a control that a ControlParameter object binds to at run time. Tuto třídu nelze zdědit.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
Dědičnost
ControlValuePropertyAttribute
Atributy

Příklady

Následující příklad kódu ukazuje, jak použít ControlValuePropertyAttribute atribut, který určuje výchozí vlastnost a hodnotu pro vlastní ovládací prvek.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

Poznámky

Při definování ControlParameter objektu je obvykle navázána vlastnost ovládacího prvku na parametr nastavením ControlID PropertyName vlastností a.When defining a ControlParameter object, you typically bind a control's property to a parameter by setting both the ControlID and PropertyName properties. Pokud PropertyName vlastnost není nastavena, je použita výchozí vlastnost.If the PropertyName property is not set, a default property is used. ControlValuePropertyAttributeAtribut se aplikuje na ovládací prvek, který určuje jeho výchozí vlastnost, ControlParameter na kterou se objekt váže za běhu.The ControlValuePropertyAttribute attribute is applied to a control to specify its default property that a ControlParameter object binds to at run time.

Další informace o použití atributů naleznete v tématu Attributes.For more information about using attributes, see Attributes.

Seznam počátečních hodnot vlastností pro instanci ControlValuePropertyAttribute třídy naleznete v ControlValuePropertyAttribute konstruktoru.For a list of initial property values for an instance of the ControlValuePropertyAttribute class, see the ControlValuePropertyAttribute constructor.

Konstruktory

ControlValuePropertyAttribute(String)

Inicializuje novou instanci ControlValuePropertyAttribute třídy pomocí zadaného názvu vlastnosti.Initializes a new instance of the ControlValuePropertyAttribute class using the specified property name.

ControlValuePropertyAttribute(String, Object)

Inicializuje novou instanci ControlValuePropertyAttribute třídy pomocí zadaného názvu vlastnosti a výchozí hodnoty.Initializes a new instance of the ControlValuePropertyAttribute class using the specified property name and default value.

ControlValuePropertyAttribute(String, Type, String)

Inicializuje novou instanci ControlValuePropertyAttribute třídy pomocí zadaného názvu vlastnosti a výchozí hodnoty.Initializes a new instance of the ControlValuePropertyAttribute class using the specified property name and default value. Výchozí hodnota je také převedena na zadaný datový typ.The default value is also converted to the specified data type.

Vlastnosti

DefaultValue

Získá výchozí hodnotu pro výchozí vlastnost ovládacího prvku.Gets the default value for the default property of a control.

Name

Získá výchozí vlastnost ovládacího prvku.Gets the default property for a control.

TypeId

Při implementaci v odvozené třídě získá jedinečný identifikátor Attribute .When implemented in a derived class, gets a unique identifier for this Attribute.

(Zděděno od Attribute)

Metody

Equals(Object)

Určuje, zda je aktuální instance ControlValuePropertyAttribute objektu rovna zadanému objektu.Determines whether the current instance of the ControlValuePropertyAttribute object is equal to the specified object.

GetHashCode()

Vrátí hodnotu hash pro tuto instanci.Returns the hash code for this instance.

GetType()

Získá Type aktuální instanci.Gets the Type of the current instance.

(Zděděno od Object)
IsDefaultAttribute()

Při přepsání v odvozené třídě označuje, zda je hodnota této instance výchozí hodnotou pro odvozenou třídu.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Zděděno od Attribute)
Match(Object)

Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda je tato instance rovna zadanému objektu.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Zděděno od Attribute)
MemberwiseClone()

Vytvoří kopii aktuálního seznamu Object .Creates a shallow copy of the current Object.

(Zděděno od Object)
ToString()

Vrátí řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

(Zděděno od Object)

Explicitní implementace rozhraní

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

Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání.Maps a set of names to a corresponding set of dispatch identifiers.

(Zděděno od Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Načte informace o typu pro objekt, který lze použít k získání informací o typu pro rozhraní.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Zděděno od Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Zděděno od Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Poskytuje přístup k vlastnostem a metodám vystaveným objektem.Provides access to properties and methods exposed by an object.

(Zděděno od Attribute)

Platí pro

Viz také