Sdílet prostřednictvím


ControlValuePropertyAttribute Třída

Definice

Určuje výchozí vlastnost ovládacího prvku, se kterým se ControlParameter objekt váže za běhu. Tuto třídu nelze dě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
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 na 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 vlastností a ControlIDPropertyName . Pokud vlastnost PropertyName není nastavená, použije se výchozí vlastnost. Atribut ControlValuePropertyAttribute je použit u ovládacího prvku k určení jeho výchozí vlastnosti, se kterou se ControlParameter objekt váže za běhu.

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

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

Konstruktory

ControlValuePropertyAttribute(String)

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

ControlValuePropertyAttribute(String, Object)

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

ControlValuePropertyAttribute(String, Type, String)

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

Vlastnosti

DefaultValue

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

Name

Získá výchozí vlastnost pro ovládací prvek.

TypeId

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

(Zděděno od Attribute)

Metody

Equals(Object)

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

GetHashCode()

Vrátí hodnotu hash pro tuto instanci.

GetType()

Type Získá z aktuální 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.

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

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

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

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

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

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

(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í.

(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é