ControlValuePropertyAttribute Třída

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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: 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 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 ControlID PropertyName . 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