ControlValuePropertyAttribute Osztály

Definíció

Névtér:
System.Web.UI
Szerelvény:
System.Web.dll

Megadja annak a vezérlőelemnek az alapértelmezett tulajdonságát, amelyhez egy ControlParameter objektum futásidőben kapcsolódik. Ez az osztály nem örökölhető.

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
Öröklődés
Object
Attribute
ControlValuePropertyAttribute
Attribútumok
AttributeUsageAttribute

Példák

Az alábbi példakód bemutatja, hogyan alkalmazható egy ControlValuePropertyAttribute attribútum, amely egy alapértelmezett tulajdonságot és értéket határoz meg egy egyéni vezérlőre.


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

Megjegyzések

Objektum definiálásakor ControlParameter általában egy vezérlő tulajdonságát egy paraméterhez köti a tulajdonságok és ControlID a PropertyName tulajdonságok beállításával. Ha a PropertyName tulajdonság nincs beállítva, a rendszer egy alapértelmezett tulajdonságot használ. Az ControlValuePropertyAttribute attribútumot egy vezérlőre alkalmazza a rendszer annak az alapértelmezett tulajdonságnak a megadásához, amelyhez egy ControlParameter objektum futásidőben kapcsolódik.

Az attribútumok használatáról további információt az Attribútumok című témakörben talál.

Az osztály egy példányának kezdeti tulajdonságértékeinek ControlValuePropertyAttribute listájáért tekintse meg a konstruktort ControlValuePropertyAttribute .

Konstruktorok

Name Description
ControlValuePropertyAttribute(String, Object)

Inicializálja az osztály új példányát a ControlValuePropertyAttribute megadott tulajdonságnév és alapértelmezett érték használatával.
ControlValuePropertyAttribute(String, Type, String)

Inicializálja az osztály új példányát a ControlValuePropertyAttribute megadott tulajdonságnév és alapértelmezett érték használatával. Az alapértelmezett érték is a megadott adattípusra lesz konvertálva.
ControlValuePropertyAttribute(String)

Inicializálja az osztály új példányát a ControlValuePropertyAttribute megadott tulajdonságnév használatával.

Tulajdonságok

Name Description
DefaultValue

Lekéri egy vezérlőelem alapértelmezett tulajdonságának alapértelmezett értékét.
Name

Lekéri egy vezérlőelem alapértelmezett tulajdonságát.
TypeId

Ha származtatott osztályban implementálják, ehhez egy egyedi azonosítót Attributekap.

(Öröklődés forrása Attribute)

Metódusok

Name Description
Equals(Object)

Meghatározza, hogy az objektum aktuális példánya ControlValuePropertyAttribute egyenlő-e a megadott objektummal.
GetHashCode()

A példány kivonatkódját adja vissza.
GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
IsDefaultAttribute()

Ha egy származtatott osztályban felül van bírálva, azt jelzi, hogy a példány értéke-e a származtatott osztály alapértelmezett értéke.

(Öröklődés forrása Attribute)
Match(Object)

Származtatott osztály felülírásakor egy olyan értéket ad vissza, amely jelzi, hogy ez a példány egy adott objektummal egyenlő-e.

(Öröklődés forrása Attribute)
MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
ToString()

Az aktuális objektumot jelképező sztringet ad vissza.

(Öröklődés forrása Object)

Explicit interfész-implementációk

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

Névkészletet képez le a küldési azonosítók megfelelő készletére.

(Öröklődés forrása Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Lekéri egy objektum típusadatait, amelyek a felület típusadatainak lekérésére használhatók.

(Öröklődés forrása Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Lekéri az objektumok által biztosított típusinformációs felületek számát (0 vagy 1).

(Öröklődés forrása Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Hozzáférést biztosít az objektumok által közzétett tulajdonságokhoz és metódusokhoz.

(Öröklődés forrása Attribute)

A következőre érvényes:

Lásd még