ControlValuePropertyAttribute Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menentukan properti default kontrol yang diikat objek ControlParameter pada waktu proses. Kelas ini tidak dapat diwariskan.
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
- Warisan
- Atribut
Contoh
Contoh kode berikut menunjukkan cara menerapkan ControlValuePropertyAttribute atribut yang menentukan properti dan nilai default ke kontrol kustom.
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
Keterangan
Saat menentukan ControlParameter objek, Anda biasanya mengikat properti kontrol ke parameter dengan mengatur ControlID properti dan PropertyName . PropertyName Jika properti tidak diatur, properti default akan digunakan. Atribut ControlValuePropertyAttribute diterapkan ke kontrol untuk menentukan properti default yang ControlParameter diikat objek pada waktu proses.
Untuk informasi selengkapnya tentang menggunakan atribut, lihat Atribut.
Untuk daftar nilai properti awal untuk instans kelas ControlValuePropertyAttribute, lihat konstruktor ControlValuePropertyAttribute.
Konstruktor
| Nama | Deskripsi |
|---|---|
| ControlValuePropertyAttribute(String, Object) |
Menginisialisasi instans ControlValuePropertyAttribute baru kelas menggunakan nama properti dan nilai default yang ditentukan. |
| ControlValuePropertyAttribute(String, Type, String) |
Menginisialisasi instans ControlValuePropertyAttribute baru kelas menggunakan nama properti dan nilai default yang ditentukan. Nilai default juga dikonversi ke jenis data yang ditentukan. |
| ControlValuePropertyAttribute(String) |
Menginisialisasi instans ControlValuePropertyAttribute baru kelas menggunakan nama properti yang ditentukan. |
Properti
| Nama | Deskripsi |
|---|---|
| DefaultValue |
Mendapatkan nilai default untuk properti default kontrol. |
| Name |
Mendapatkan properti default untuk kontrol. |
| TypeId |
Ketika diimplementasikan dalam kelas turunan, mendapatkan pengidentifikasi unik untuk Attributeini. (Diperoleh dari Attribute) |
Metode
| Nama | Deskripsi |
|---|---|
| Equals(Object) |
Menentukan apakah instans ControlValuePropertyAttribute objek saat ini sama dengan objek yang ditentukan. |
| GetHashCode() |
Mengembalikan kode hash untuk instans ini. |
| GetType() |
Mendapatkan Type instans saat ini. (Diperoleh dari Object) |
| IsDefaultAttribute() |
Ketika ditimpa dalam kelas turunan, menunjukkan apakah nilai instans ini adalah nilai default untuk kelas turunan. (Diperoleh dari Attribute) |
| Match(Object) |
Saat ditimpa dalam kelas turunan, mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute) |
| MemberwiseClone() |
Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object) |
| ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
Implementasi Antarmuka Eksplisit
| Nama | Deskripsi |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
Memetakan sekumpulan nama ke sekumpulan pengidentifikasi pengiriman yang sesuai. (Diperoleh dari Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
Mengambil informasi jenis untuk objek, yang dapat digunakan untuk mendapatkan informasi jenis untuk antarmuka. (Diperoleh dari Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
Mengambil jumlah antarmuka informasi jenis yang disediakan objek (baik 0 atau 1). (Diperoleh dari Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
Menyediakan akses ke properti dan metode yang diekspos oleh objek. (Diperoleh dari Attribute) |