ControlValuePropertyAttribute Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Określa domyślną właściwość kontrolki, z którą ControlParameter obiekt jest powiązany w czasie wykonywania. Klasa ta nie może być dziedziczona.

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

Dziedziczenie: Object

Attribute
ControlValuePropertyAttribute

Atrybuty: AttributeUsageAttribute

Przykłady

W poniższym przykładzie kodu pokazano, jak zastosować ControlValuePropertyAttribute atrybut, który określa właściwość domyślną i wartość kontrolki niestandardowej.


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

Uwagi

Podczas definiowania ControlParameter obiektu zazwyczaj tworzy się powiązanie właściwości kontrolki z parametrem przez ustawienie właściwości ControlID i PropertyName . Jeśli właściwość nie jest ustawiona PropertyName , zostanie użyta właściwość domyślna. Atrybut ControlValuePropertyAttribute jest stosowany do kontrolki w celu określenia jej właściwości domyślnej ControlParameter , z którą obiekt jest powiązany w czasie wykonywania.

Aby uzyskać więcej informacji na temat używania atrybutów, zobacz Atrybuty.

Aby uzyskać listę początkowych wartości właściwości dla wystąpienia ControlValuePropertyAttribute klasy, zobacz ControlValuePropertyAttribute konstruktor.

Konstruktory

ControlValuePropertyAttribute(String)	Inicjuje ControlValuePropertyAttribute nowe wystąpienie klasy przy użyciu określonej nazwy właściwości.
ControlValuePropertyAttribute(String, Object)	Inicjuje ControlValuePropertyAttribute nowe wystąpienie klasy przy użyciu określonej nazwy właściwości i wartości domyślnej.
ControlValuePropertyAttribute(String, Type, String)	Inicjuje ControlValuePropertyAttribute nowe wystąpienie klasy przy użyciu określonej nazwy właściwości i wartości domyślnej. Wartość domyślna jest również konwertowana na określony typ danych.

Właściwości

DefaultValue	Pobiera wartość domyślną dla właściwości domyślnej kontrolki.
Name	Pobiera właściwość domyślną kontrolki.
TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego Attributeelementu . (Odziedziczone po Attribute)

Metody

Equals(Object)	Określa, czy bieżące wystąpienie ControlValuePropertyAttribute obiektu jest równe określonemu obiektowi.
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsDefaultAttribute()	W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	Po przesłonięciu w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Zestaw nazw jest mapowany na odpowiedni zestaw identyfikatorów wysyłania. (Odziedziczone po Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Pobiera informacje o typie dla obiektu, który może służyć do pobierania informacji o typie dla interfejsu. (Odziedziczone po Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Pobiera informację o liczbie typów interfejsów, jakie zawiera obiekt (0 lub 1). (Odziedziczone po Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Umożliwia dostęp do właściwości i metod udostępnianych przez obiekt. (Odziedziczone po Attribute)

Dotyczy