ControlValuePropertyAttribute Sınıf

Tanım

Ad Alanı:

System.Web.UI

Bütünleştirilmiş Kod:

System.Web.dll

ControlParameter nesnesinin çalışma zamanında bağlanacakları denetimin varsayılan özelliğini belirtir. Bu sınıf devralınamaz.

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

Devralma

Object

Attribute

ControlValuePropertyAttribute

Öznitelikler

AttributeUsageAttribute

Örnekler

Aşağıdaki kod örneği, bir özel denetime varsayılan özellik ve değer belirten bir özniteliğin nasıl uygulanacağını ControlValuePropertyAttribute gösterir.

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

Açıklamalar

Bir ControlParameter nesneyi tanımlarken, hem hem PropertyName de özelliklerini ayarlayarak genellikle bir denetimin özelliğini bir parametreye ControlID bağlarsınız. PropertyName Özellik ayarlanmadıysa, varsayılan bir özellik kullanılır. ControlValuePropertyAttribute özniteliği, bir nesnenin çalışma zamanında bağlanacağı varsayılan özelliğini belirtmek için bir ControlParameter denetime uygulanır.

Öznitelikleri kullanma hakkında daha fazla bilgi için bkz . Öznitelikler.

Sınıfının bir örneğinin ilk özellik değerlerinin ControlValuePropertyAttribute listesi için oluşturucuya ControlValuePropertyAttribute bakın.

Oluşturucular

Name	Description
ControlValuePropertyAttribute(String, Object)	Belirtilen özellik adını ve varsayılan değeri kullanarak sınıfın yeni bir örneğini ControlValuePropertyAttribute başlatır.
ControlValuePropertyAttribute(String, Type, String)	Belirtilen özellik adını ve varsayılan değeri kullanarak sınıfın yeni bir örneğini ControlValuePropertyAttribute başlatır. Varsayılan değer de belirtilen veri türüne dönüştürülür.
ControlValuePropertyAttribute(String)	Belirtilen özellik adını kullanarak sınıfının yeni bir örneğini ControlValuePropertyAttribute başlatır.

Özellikler

Name	Description
DefaultValue	Denetimin varsayılan özelliği için varsayılan değeri alır.
Name	Denetimin varsayılan özelliğini alır.
TypeId	Türetilmiş bir sınıfta uygulandığında, bu Attributeiçin benzersiz bir tanımlayıcı alır. (Devralındığı yer: Attribute)

Yöntemler

Name	Description
Equals(Object)	Nesnenin geçerli örneğinin ControlValuePropertyAttribute belirtilen nesneye eşit olup olmadığını belirler.
GetHashCode()	Bu örneğin karma kodunu döndürür.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
IsDefaultAttribute()	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin değerinin türetilmiş sınıf için varsayılan değer olup olmadığını gösterir. (Devralındığı yer: Attribute)
Match(Object)	Türetilmiş bir sınıfta geçersiz kılındığında, bu örneğin belirtilen bir nesneye eşit olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: Attribute)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Belirtik Arabirim Kullanımları

Name	Description
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Bir ad kümesini karşılık gelen bir dağıtma tanımlayıcısı kümesine eşler. (Devralındığı yer: Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Bir arabirimin tür bilgilerini almak için kullanılabilecek bir nesnenin tür bilgilerini alır. (Devralındığı yer: Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Bir nesnenin sağladığı tür bilgisi arabirimlerinin sayısını alır (0 ya da 1). (Devralındığı yer: Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Bir nesne tarafından kullanıma sunulan özelliklere ve yöntemlere erişim sağlar. (Devralındığı yer: Attribute)

Ayrıca bkz.

• Attribute
• ControlParameter
• ControlID
• PropertyName
• Name
• DefaultValue