Sdílet prostřednictvím

ControlValuePropertyAttribute Třída

Definice

Obor názvů:
System.Web.UI
Sestavení:
System.Web.dll

Určuje výchozí vlastnost ovládacího prvku, ke kterému ControlParameter objekt vytvoří vazbu za běhu. Tuto třídu nelze zdědit.

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
Object
Attribute
ControlValuePropertyAttribute
Atributy
AttributeUsageAttribute

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.


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í objektu ControlParameter obvykle svážete vlastnost ovládacího prvku s parametrem nastavením vlastnosti ControlID i PropertyName vlastnosti. Pokud vlastnost PropertyName není nastavená, použije se výchozí vlastnost. Atribut ControlValuePropertyAttribute se použije u ovládacího prvku k určení jeho výchozí vlastnosti, ke které ControlParameter objekt vytvoří vazbu za běhu.

Další informace o používání atributů naleznete v tématu Atributy.

Seznam počátečních hodnot vlastností pro instanci ControlValuePropertyAttribute třídy naleznete v konstruktoru ControlValuePropertyAttribute .

Konstruktory

Name Description
ControlValuePropertyAttribute(String, Object)

Inicializuje novou instanci třídy pomocí zadaného ControlValuePropertyAttribute názvu vlastnosti a výchozí hodnoty.
ControlValuePropertyAttribute(String, Type, String)

Inicializuje novou instanci třídy pomocí zadaného ControlValuePropertyAttribute názvu vlastnosti a výchozí hodnoty. Výchozí hodnota je také převedena na zadaný datový typ.
ControlValuePropertyAttribute(String)

Inicializuje novou instanci třídy pomocí zadaného ControlValuePropertyAttribute názvu vlastnosti.

Vlastnosti

Name Description
DefaultValue

Získá výchozí hodnotu pro výchozí vlastnost ovládacího prvku.
Name

Získá výchozí vlastnost ovládacího prvku.
TypeId

Při implementaci v odvozené třídě získá jedinečný identifikátor pro tento Attribute.

(Zděděno od Attribute)

Metody

Name Description
Equals(Object)

Určuje, zda aktuální instance objektu ControlValuePropertyAttribute je rovna zadanému objektu.
GetHashCode()

Vrátí kód hash pro tuto instanci.
GetType()

Získá Type aktuální instance.

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

Při přepsání v odvozené třídě určuje, zda hodnota této instance je výchozí hodnotou pro odvozenou třídu.

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

Při přepsání v odvozené třídě vrátí hodnotu, která určuje, zda se tato instance rovná zadanému objektu.

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

Vytvoří mělkou kopii aktuálního Object.

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

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Explicitní implementace rozhraní

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

Mapuje sadu názvů na odpovídající sadu identifikátorů pro rozesílání.

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

Načte informace o typu objektu, který lze použít k získání informací o typu pro rozhraní.

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

Získá počet rozhraní typu informací, které objekt poskytuje (0 nebo 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.

(Zděděno od Attribute)

Platí pro

Viz také