CustomValidator 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.
Melakukan validasi yang ditentukan pengguna pada kontrol input.
public ref class CustomValidator : System::Web::UI::WebControls::BaseValidatorpublic class CustomValidator : System.Web.UI.WebControls.BaseValidatortype CustomValidator = class
inherit BaseValidatorPublic Class CustomValidator
Inherits BaseValidator- Warisan
Contoh
Contoh kode berikut menunjukkan cara membuat kontrol sisi CustomValidator server.
Penting
Contoh ini memiliki kotak teks yang menerima input pengguna, yang merupakan potensi ancaman keamanan. Secara default, ASP.NET halaman Web memvalidasi bahwa input pengguna tidak menyertakan elemen skrip atau HTML. Untuk informasi selengkapnya, lihat Gambaran Umum Eksploitasi Skrip.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>CustomValidator ServerValidate Example</title>
<script runat="server">
void ValidateBtn_OnClick(object sender, EventArgs e)
{
// Display whether the page passed validation.
if (Page.IsValid)
{
Message.Text = "Page is valid.";
}
else
{
Message.Text = "Page is not valid!";
}
}
void ServerValidation(object source, ServerValidateEventArgs args)
{
try
{
// Test whether the value entered into the text box is even.
int i = int.Parse(args.Value);
args.IsValid = ((i%2) == 0);
}
catch(Exception ex)
{
args.IsValid = false;
}
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>CustomValidator ServerValidate Example</h3>
<asp:Label id="Message"
Text="Enter an even number:"
Font-Names="Verdana"
Font-Size="10pt"
runat="server"
AssociatedControlID="Text1"/>
<br />
<asp:TextBox id="Text1"
runat="server" />
<asp:CustomValidator id="CustomValidator1"
ControlToValidate="Text1"
Display="Static"
ErrorMessage="Not an even number!"
ForeColor="green"
Font-Names="verdana"
Font-Size="10pt"
OnServerValidate="ServerValidation"
runat="server"/>
<br />
<asp:Button id="Button1"
Text="Validate"
OnClick="ValidateBtn_OnClick"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>CustomValidator ServerValidate Example</title>
<script runat="server">
Sub ValidateBtn_OnClick(sender As Object, e As EventArgs)
' Display whether the page passed validation.
If Page.IsValid Then
Message.Text = "Page is valid."
Else
Message.Text = "Page is not valid!"
End If
End Sub
Sub ServerValidation(source As Object, args As ServerValidateEventArgs)
Try
' Test whether the value entered into the text box is even.
Dim num As Integer = Integer.Parse(args.Value)
args.IsValid = ((num mod 2) = 0)
Catch ex As Exception
args.IsValid = false
End Try
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>CustomValidator ServerValidate Example</h3>
<asp:Label id="Message"
Text="Enter an even number:"
Font-Names="Verdana"
Font-Size="10pt"
runat="server"
AssociatedControlID="Text1" />
<br />
<asp:TextBox id="Text1"
runat="server" />
<asp:CustomValidator id="CustomValidator1"
ControlToValidate="Text1"
Display="Static"
ErrorMessage="Not an even number!"
ForeColor="green"
Font-Names="verdana"
Font-Size="10pt"
OnServerValidate="ServerValidation"
runat="server"/>
<br />
<asp:Button id="Button1"
Text="Validate"
OnClick="ValidateBtn_OnClick"
runat="server"/>
</form>
</body>
</html>
Contoh kode berikut menunjukkan cara membuat kontrol sisi CustomValidator klien.
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
void ValidateBtn_OnClick(object sender, EventArgs e)
{
// Display whether the page passed validation.
if (Page.IsValid)
{
Message.Text = "Page is valid.";
}
else
{
Message.Text = "Page is not valid!";
}
}
void ServerValidation(object source, ServerValidateEventArgs args)
{
try
{
// Test whether the value entered into the text box is even.
int i = int.Parse(args.Value);
args.IsValid = ((i%2) == 0);
}
catch(Exception ex)
{
args.IsValid = false;
}
}
</script>
</head>
<body>
<form id="Form1" runat="server">
<h3>CustomValidator ServerValidate Example</h3>
<asp:Label id="Message"
Text="Enter an even number:"
Font-Name="Verdana"
Font-Size="10pt"
runat="server"/>
<p>
<asp:TextBox id="Text1"
runat="server" />
<asp:CustomValidator id="CustomValidator1"
ControlToValidate="Text1"
ClientValidationFunction="ClientValidate"
OnServerValidate="ServerValidation"
Display="Static"
ErrorMessage="Not an even number!"
ForeColor="green"
Font-Name="verdana"
Font-Size="10pt"
runat="server"/>
<p>
<asp:Button id="Button1"
Text="Validate"
OnClick="ValidateBtn_OnClick"
runat="server"/>
</form>
</body>
</html>
<script language="javascript">
function ClientValidate(source, arguments)
{
if (arguments.Value % 2 == 0 ){
arguments.IsValid = true;
} else {
arguments.IsValid = false;
}
}
</script>
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
Sub ValidateBtn_OnClick(sender As Object, e As EventArgs)
' Display whether the page passed validation.
If Page.IsValid Then
Message.Text = "Page is valid."
Else
Message.Text = "Page is not valid!"
End If
End Sub
Sub ServerValidation(source As Object, args As ServerValidateEventArgs)
Try
' Test whether the value entered into the text box is even.
Dim num As Integer = Integer.Parse(args.Value)
args.IsValid = ((num Mod 2) = 0)
Catch ex As Exception
args.IsValid = False
End Try
End Sub
</script>
</head>
<body>
<form id="Form1" runat="server">
<h3>CustomValidator ServerValidate Example</h3>
<asp:Label id="Message"
Text="Enter an even number:"
Font-Name="Verdana"
Font-Size="10pt"
runat="server"/>
<p>
<asp:TextBox id="Text1"
runat="server" />
<asp:CustomValidator id="CustomValidator1"
ControlToValidate="Text1"
ClientValidationFunction="ClientValidate"
OnServerValidate="ServerValidation"
Display="Static"
ErrorMessage="Not an even number!"
ForeColor="green"
Font-Name="verdana"
Font-Size="10pt"
runat="server"/>
<p>
<asp:Button id="Button1"
Text="Validate"
OnClick="ValidateBtn_OnClick"
runat="server"/>
</form>
</body>
</html>
<script language="javascript">
function ClientValidate(source, arguments)
{
if (arguments.Value % 2 == 0 ){
arguments.IsValid = true;
} else {
arguments.IsValid = false;
}
}
</script>
Keterangan
CustomValidator Gunakan kontrol untuk menyediakan fungsi validasi yang ditentukan pengguna untuk kontrol input. Kontrol CustomValidator adalah kontrol terpisah dari kontrol input yang divalidasinya, yang memungkinkan Anda mengontrol tempat pesan validasi ditampilkan.
Kontrol validasi selalu melakukan validasi pada server. Mereka juga memiliki implementasi sisi klien lengkap yang memungkinkan browser yang mendukung skrip (seperti Microsoft Internet Explorer 4.0 dan yang lebih baru) untuk melakukan validasi pada klien. Validasi sisi klien meningkatkan proses validasi dengan memeriksa input pengguna sebelum dikirim ke server. Ini memungkinkan kesalahan terdeteksi pada klien sebelum formulir dikirimkan, sehingga menghindari perjalanan pulang pergi informasi yang diperlukan untuk validasi sisi server.
Untuk membuat fungsi validasi sisi server, berikan handler untuk ServerValidate peristiwa yang melakukan validasi. String dari kontrol input untuk memvalidasi dapat diakses dengan menggunakan Value properti objek yang ServerValidateEventArgs diteruskan ke penanganan aktivitas sebagai parameter. Hasil validasi kemudian disimpan dalam IsValid properti ServerValidateEventArgs objek .
Untuk membuat fungsi validasi sisi klien, pertama-tama tambahkan fungsi validasi sisi server yang dijelaskan sebelumnya. Selanjutnya, tambahkan fungsi skrip validasi sisi klien ke halaman ASP.NET (.aspx).
Jika Anda menggunakan Visual Basic Scripting Edition (VBScript), fungsi harus dalam formulir ini:
Sub ValidationFunctionName(source, arguments)
Jika Anda menggunakan JScript, fungsi harus dalam formulir ini:
function ValidationFunctionName(source, arguments)
Parameter source adalah referensi ke <elemen rentang> yang dirender untuk CustomValidator kontrol. Ini memungkinkan Anda mengontrol tag rentang> secara terprogram<, seperti memodifikasi InnerHtml atribut. Parameter arguments adalah objek dengan dua properti: Nilai dan IsValid. Parameter ini memungkinkan Anda mendapatkan nilai kontrol untuk memvalidasi dan menunjukkan apakah nilai valid berdasarkan rutinitas validasi kustom Anda.
ClientValidationFunction Gunakan properti untuk menentukan nama fungsi skrip validasi sisi klien yang CustomValidator terkait dengan kontrol. Karena fungsi skrip dijalankan pada klien, fungsi harus dalam bahasa yang didukung browser target, seperti VBScript atau JScript.
Catatan
Saat Anda menggunakan CustomValidator kontrol di dalam UpdatePanel kontrol, pastikan kontrol validator dan kontrol yang terkait dengannya berada di panel yang sama. Untuk informasi selengkapnya tentang menggunakan UpdatePanel kontrol untuk pembaruan halaman parsial, lihat Gambaran Umum Penyajian Halaman Parsial.
Seperti validasi sisi server, string dari kontrol input untuk memvalidasi diakses dengan menggunakan Value properti arguments parameter . Mengembalikan hasil validasi dengan mengatur IsValid properti arguments parameter.
Perhatian
Saat menggunakan kontrol validator, Anda harus selalu memeriksa hasil validasi sisi server sebelum melakukan pemrosesan apa pun. Setelah postback tetapi sebelum metode peristiwa Anda dipanggil, halaman memanggil kontrol validator dan menggabungkan hasilnya ke Page.IsValid dalam properti . (Anda juga dapat memanggil kontrol validator secara eksplisit menggunakan metode . Validate ) Dalam kode Anda sendiri, Anda harus memeriksa apakah Page.IsValid properti kembali true sebelum memproses input. Meskipun browser yang mendukung skrip mungkin mencegah terjadinya postback pada klien jika pemeriksaan validasi gagal, Anda juga harus selalu memeriksa Page.IsValid kode server sebelum memproses data yang divalidasi.
Beberapa kontrol validasi dapat digunakan dengan kontrol input individual untuk memvalidasi kriteria yang berbeda. Misalnya, Anda dapat menerapkan beberapa kontrol validasi pada TextBox kontrol yang memungkinkan pengguna memasukkan jumlah item untuk ditambahkan ke keranjang belanja. Anda dapat menggunakan CustomValidator kontrol untuk memastikan bahwa nilai yang ditentukan kurang dari jumlah inventori dan RequiredFieldValidator kontrol untuk memastikan bahwa pengguna memasukkan nilai ke dalam TextBox kontrol.
Catatan
Jika kontrol input kosong, tidak ada fungsi validasi yang dipanggil dan validasi berhasil. RequiredFieldValidator Gunakan kontrol untuk mengharuskan pengguna memasukkan data dalam kontrol input.
Dimungkinkan untuk menggunakan CustomValidator kontrol tanpa mengatur ControlToValidate properti . Ini biasanya dilakukan ketika Anda memvalidasi beberapa kontrol input atau memvalidasi kontrol input yang tidak dapat digunakan dengan kontrol validasi, seperti CheckBox kontrol. Dalam hal ini, Value properti parameter yang arguments diteruskan ke penanganan aktivitas untuk ServerValidate peristiwa dan ke fungsi validasi sisi klien selalu berisi string kosong (""). Namun, fungsi validasi ini masih dipanggil, jika sesuai, untuk menentukan validitas pada server dan klien. Untuk mengakses nilai yang akan divalidasi, Anda harus mereferensikan kontrol input yang ingin Anda validasi secara terprogram lalu mengambil nilai dari properti yang sesuai. Misalnya, untuk memvalidasi CheckBox kontrol di server, jangan atur ControlToValidate properti kontrol validasi dan gunakan kode berikut untuk handler untuk peristiwa tersebut ServerValidate .
Sub ServerValidation (source As object, args As ServerValidateEventArgs)
args.IsValid = (CheckBox1.Checked = True)
End Sub
void ServerValidation (object source, ServerValidateEventArgs args)
{
args.IsValid = (CheckBox1.Checked == true);
}
Untuk informasi selengkapnya tentang kontrol validasi, lihat BaseValidator.
Aksesibilitas
Untuk informasi tentang cara mengonfigurasi kontrol ini sehingga menghasilkan markup yang sesuai dengan standar aksesibilitas, lihat Aksesibilitas di Visual Studio dan ASP.NET serta Kontrol dan Aksesibilitas ASP.NET.
Konstruktor
| CustomValidator() |
Menginisialisasi instans baru kelas CustomValidator. |
Properti
| AccessKey |
Mendapatkan atau mengatur kunci akses yang memungkinkan Anda menavigasi dengan cepat ke kontrol server Web. (Diperoleh dari WebControl) |
| Adapter |
Mendapatkan adaptor khusus browser untuk kontrol. (Diperoleh dari Control) |
| AppRelativeTemplateSourceDirectory |
Mendapatkan atau mengatur direktori virtual relatif aplikasi dari Page objek atau UserControl yang berisi kontrol ini. (Diperoleh dari Control) |
| AssociatedControlID |
Properti ini tidak didukung. (Diperoleh dari BaseValidator) |
| Attributes |
Mendapatkan kumpulan atribut arbitrer (hanya untuk penyajian) yang tidak sesuai dengan properti pada kontrol. (Diperoleh dari WebControl) |
| BackColor |
Mendapatkan atau mengatur warna latar belakang kontrol server Web. (Diperoleh dari WebControl) |
| BindingContainer |
Mendapatkan kontrol yang berisi pengikatan data kontrol ini. (Diperoleh dari Control) |
| BorderColor |
Mendapatkan atau mengatur warna batas kontrol Web. (Diperoleh dari WebControl) |
| BorderStyle |
Mendapatkan atau mengatur gaya batas kontrol server Web. (Diperoleh dari WebControl) |
| BorderWidth |
Mendapatkan atau mengatur lebar batas kontrol server Web. (Diperoleh dari WebControl) |
| ChildControlsCreated |
Mendapatkan nilai yang menunjukkan apakah kontrol anak kontrol server telah dibuat. (Diperoleh dari Control) |
| ClientID |
Mendapatkan ID kontrol untuk markup HTML yang dihasilkan oleh ASP.NET. (Diperoleh dari Control) |
| ClientIDMode |
Mendapatkan atau mengatur algoritma yang digunakan untuk menghasilkan nilai ClientID properti. (Diperoleh dari Control) |
| ClientIDSeparator |
Mendapatkan nilai karakter yang mewakili karakter pemisah yang digunakan dalam ClientID properti . (Diperoleh dari Control) |
| ClientValidationFunction |
Mendapatkan atau mengatur nama fungsi skrip sisi klien kustom yang digunakan untuk validasi. |
| Context |
Mendapatkan objek yang HttpContext terkait dengan kontrol server untuk permintaan Web saat ini. (Diperoleh dari Control) |
| Controls |
ControlCollection Mendapatkan objek yang mewakili kontrol anak untuk kontrol server tertentu dalam hierarki UI. (Diperoleh dari Control) |
| ControlStyle |
Mendapatkan gaya kontrol server Web. Properti ini digunakan terutama oleh pengembang kontrol. (Diperoleh dari WebControl) |
| ControlStyleCreated |
Mendapatkan nilai yang menunjukkan apakah Style objek telah dibuat untuk ControlStyle properti . Properti ini terutama digunakan oleh pengembang kontrol. (Diperoleh dari WebControl) |
| ControlToValidate |
Mendapatkan atau mengatur kontrol input untuk memvalidasi. (Diperoleh dari BaseValidator) |
| CssClass |
Mendapatkan atau mengatur kelas Cascading Style Sheet (CSS) yang dirender oleh kontrol server Web pada klien. (Diperoleh dari WebControl) |
| DataItemContainer |
Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan mengimplementasikan IDataItemContainer. (Diperoleh dari Control) |
| DataKeysContainer |
Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan mengimplementasikan IDataKeysControl. (Diperoleh dari Control) |
| DesignMode |
Mendapatkan nilai yang menunjukkan apakah kontrol sedang digunakan pada permukaan desain. (Diperoleh dari Control) |
| Display |
Mendapatkan atau mengatur perilaku tampilan pesan kesalahan dalam kontrol validasi. (Diperoleh dari BaseValidator) |
| EnableClientScript |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah validasi sisi klien diaktifkan. (Diperoleh dari BaseValidator) |
| Enabled |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol validasi diaktifkan. (Diperoleh dari BaseValidator) |
| EnableTheming |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah tema berlaku untuk kontrol ini. (Diperoleh dari WebControl) |
| EnableViewState |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server mempertahankan status tampilannya, dan status tampilan setiap kontrol anak yang dikandungnya, ke klien yang meminta. (Diperoleh dari Control) |
| ErrorMessage |
Mendapatkan atau mengatur teks untuk pesan kesalahan yang ValidationSummary ditampilkan dalam kontrol saat validasi gagal. (Diperoleh dari BaseValidator) |
| Events |
Mendapatkan daftar delegasi penanganan aktivitas untuk kontrol. Properti ini bersifat hanya baca. (Diperoleh dari Control) |
| Font |
Mendapatkan properti font yang terkait dengan kontrol server Web. (Diperoleh dari WebControl) |
| ForeColor |
Mendapatkan atau mengatur warna pesan yang ditampilkan saat validasi gagal. (Diperoleh dari BaseValidator) |
| HasAttributes |
Mendapatkan nilai yang menunjukkan apakah kontrol memiliki atribut yang ditetapkan. (Diperoleh dari WebControl) |
| HasChildViewState |
Mendapatkan nilai yang menunjukkan apakah kontrol anak kontrol server saat ini memiliki pengaturan status tampilan yang disimpan. (Diperoleh dari Control) |
| Height |
Mendapatkan atau mengatur tinggi kontrol server Web. (Diperoleh dari WebControl) |
| ID |
Mendapatkan atau mengatur pengidentifikasi terprogram yang ditetapkan ke kontrol server. (Diperoleh dari Control) |
| IdSeparator |
Mendapatkan karakter yang digunakan untuk memisahkan pengidentifikasi kontrol. (Diperoleh dari Control) |
| IsChildControlStateCleared |
Mendapatkan nilai yang menunjukkan apakah kontrol yang terkandung dalam kontrol ini memiliki status kontrol. (Diperoleh dari Control) |
| IsEnabled |
Mendapatkan nilai yang menunjukkan apakah kontrol diaktifkan. (Diperoleh dari WebControl) |
| IsTrackingViewState |
Mendapatkan nilai yang menunjukkan apakah kontrol server menyimpan perubahan pada status tampilannya. (Diperoleh dari Control) |
| IsUnobtrusive |
Mendapatkan nilai yang menunjukkan apakah kontrol menghasilkan JavaScript yang tidak mengganggu. (Diperoleh dari BaseValidator) |
| IsValid |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol input terkait lolos validasi. (Diperoleh dari BaseValidator) |
| IsViewStateEnabled |
Mendapatkan nilai yang menunjukkan apakah status tampilan diaktifkan untuk kontrol ini. (Diperoleh dari Control) |
| LoadViewStateByID |
Mendapatkan nilai yang menunjukkan apakah kontrol berpartisipasi dalam memuat status tampilannya dengan ID bukan indeks. (Diperoleh dari Control) |
| NamingContainer |
Mendapatkan referensi ke kontainer penamaan kontrol server, yang membuat namespace unik untuk membedakan antara kontrol server dengan nilai properti yang sama ID . (Diperoleh dari Control) |
| Page |
Mendapatkan referensi ke Page instans yang berisi kontrol server. (Diperoleh dari Control) |
| Parent |
Mendapatkan referensi ke kontrol induk kontrol server dalam hierarki kontrol halaman. (Diperoleh dari Control) |
| PropertiesValid |
Mendapatkan nilai yang menunjukkan apakah kontrol yang ditentukan oleh ControlToValidate properti adalah kontrol yang valid. (Diperoleh dari BaseValidator) |
| RenderingCompatibility |
Mendapatkan nilai yang menentukan versi ASP.NET yang akan kompatibel dengan HTML yang dirender. (Diperoleh dari Control) |
| RenderUplevel |
Mendapatkan nilai yang menunjukkan apakah browser klien mendukung penyajian "uplevel". (Diperoleh dari BaseValidator) |
| SetFocusOnError |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah fokus diatur ke kontrol yang ditentukan oleh ControlToValidate properti saat validasi gagal. (Diperoleh dari BaseValidator) |
| Site |
Mendapatkan informasi tentang kontainer yang menghosting kontrol saat ini saat dirender pada permukaan desain. (Diperoleh dari Control) |
| SkinID |
Mendapatkan atau mengatur kulit untuk diterapkan pada kontrol. (Diperoleh dari WebControl) |
| Style |
Mendapatkan kumpulan atribut teks yang akan dirender sebagai atribut gaya pada tag luar kontrol server Web. (Diperoleh dari WebControl) |
| SupportsDisabledAttribute |
Mendapatkan nilai yang menunjukkan apakah kontrol harus mengatur |
| TabIndex |
Mendapatkan atau mengatur indeks tab kontrol server Web. (Diperoleh dari WebControl) |
| TagKey |
Mendapatkan tag HTML yang digunakan untuk merender Label kontrol. (Diperoleh dari Label) |
| TagName |
Mendapatkan nama tag kontrol. Properti ini digunakan terutama oleh pengembang kontrol. (Diperoleh dari WebControl) |
| TemplateControl |
Mendapatkan atau mengatur referensi ke templat yang berisi kontrol ini. (Diperoleh dari Control) |
| TemplateSourceDirectory |
Mendapatkan direktori Page virtual atau UserControl yang berisi kontrol server saat ini. (Diperoleh dari Control) |
| Text |
Mendapatkan atau mengatur teks yang ditampilkan dalam kontrol validasi saat validasi gagal. (Diperoleh dari BaseValidator) |
| ToolTip |
Mendapatkan atau mengatur teks yang ditampilkan saat penunjuk mouse mengarah ke kontrol server Web. (Diperoleh dari WebControl) |
| UniqueID |
Mendapatkan pengidentifikasi unik yang memenuhi syarat secara hierarkis untuk kontrol server. (Diperoleh dari Control) |
| ValidateEmptyText |
Mendapatkan atau mengatur nilai Boolean yang menunjukkan apakah teks kosong harus divalidasi. |
| ValidateRequestMode |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol memeriksa input klien dari browser untuk nilai yang berpotensi berbahaya. (Diperoleh dari Control) |
| ValidationGroup |
Mendapatkan atau mengatur nama grup validasi tempat kontrol validasi ini berada. (Diperoleh dari BaseValidator) |
| ViewState |
Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status tampilan kontrol server di beberapa permintaan untuk halaman yang sama. (Diperoleh dari Control) |
| ViewStateIgnoresCase |
Mendapatkan nilai yang menunjukkan apakah StateBag objek tidak peka huruf besar/kecil. (Diperoleh dari Control) |
| ViewStateMode |
Mendapatkan atau mengatur mode view-state kontrol ini. (Diperoleh dari Control) |
| Visible |
Mendapatkan atau mengatur nilai yang menunjukkan apakah kontrol server dirender sebagai UI di halaman. (Diperoleh dari Control) |
| Width |
Mendapatkan atau mengatur lebar kontrol server Web. (Diperoleh dari WebControl) |
Metode
| AddAttributesToRender(HtmlTextWriter) |
Menambahkan properti CustomValidator kontrol ke aliran output untuk penyajian pada klien. |
| AddedControl(Control, Int32) |
Dipanggil setelah kontrol anak ditambahkan ke Controls koleksi Control objek. (Diperoleh dari Control) |
| AddParsedSubObject(Object) |
Memberi tahu kontrol bahwa elemen diurai dan menambahkan elemen ke Label kontrol. (Diperoleh dari Label) |
| ApplyStyle(Style) |
Menyalin elemen tidak kosong dari gaya yang ditentukan ke kontrol Web, menimpa elemen gaya kontrol yang ada. Metode ini terutama digunakan oleh pengembang kontrol. (Diperoleh dari WebControl) |
| ApplyStyleSheetSkin(Page) |
Menerapkan properti gaya yang ditentukan dalam lembar gaya halaman ke kontrol. (Diperoleh dari Control) |
| BeginRenderTracing(TextWriter, Object) |
Memulai pelacakan waktu desain untuk merender data. (Diperoleh dari Control) |
| BuildProfileTree(String, Boolean) |
Mengumpulkan informasi tentang kontrol server dan mengirimkannya ke properti yang Trace akan ditampilkan saat pelacakan diaktifkan untuk halaman. (Diperoleh dari Control) |
| CheckControlValidationProperty(String, String) |
Memverifikasi apakah kontrol yang ditentukan ada di halaman dan berisi properti validasi. (Diperoleh dari BaseValidator) |
| ClearCachedClientID() |
Mengatur nilai yang di-cache ClientID ke |
| ClearChildControlState() |
Menghapus informasi status-kontrol untuk kontrol anak kontrol server. (Diperoleh dari Control) |
| ClearChildState() |
Menghapus informasi status-tampilan dan status-kontrol untuk semua kontrol turunan kontrol server. (Diperoleh dari Control) |
| ClearChildViewState() |
Menghapus informasi status tampilan untuk semua kontrol anak kontrol server. (Diperoleh dari Control) |
| ClearEffectiveClientIDMode() |
Mengatur properti instans ClientIDMode kontrol saat ini dan kontrol turunan apa pun ke Inherit. (Diperoleh dari Control) |
| ControlPropertiesValid() |
Memeriksa properti kontrol untuk nilai yang valid. |
| CopyBaseAttributes(WebControl) |
Menyalin properti yang tidak dienkapsulasi oleh Style objek dari kontrol server Web yang ditentukan ke kontrol server Web tempat metode ini dipanggil. Metode ini digunakan terutama oleh pengembang kontrol. (Diperoleh dari WebControl) |
| CreateChildControls() |
Dipanggil oleh kerangka kerja halaman ASP.NET untuk memberi tahu kontrol server yang menggunakan implementasi berbasis komposisi untuk membuat kontrol anak apa pun yang dikandungnya sebagai persiapan untuk memposting kembali atau merender. (Diperoleh dari Control) |
| CreateControlCollection() |
Membuat objek baru ControlCollection untuk menahan kontrol anak (baik literal maupun server) dari kontrol server. (Diperoleh dari Control) |
| CreateControlStyle() |
Membuat objek gaya yang digunakan secara internal oleh WebControl kelas untuk mengimplementasikan semua properti terkait gaya. Metode ini digunakan terutama oleh pengembang kontrol. (Diperoleh dari WebControl) |
| DataBind() |
Mengikat sumber data ke kontrol server yang dipanggil dan semua kontrol turunannya. (Diperoleh dari Control) |
| DataBind(Boolean) |
Mengikat sumber data ke kontrol server yang dipanggil dan semua kontrol turunannya dengan opsi untuk menaikkan DataBinding peristiwa. (Diperoleh dari Control) |
| DataBindChildren() |
Mengikat sumber data ke kontrol anak kontrol server. (Diperoleh dari Control) |
| DetermineRenderUplevel() |
Menentukan apakah kontrol validasi dapat melakukan validasi sisi klien. (Diperoleh dari BaseValidator) |
| Dispose() |
Memungkinkan kontrol server untuk melakukan pembersihan akhir sebelum dilepaskan dari memori. (Diperoleh dari Control) |
| EndRenderTracing(TextWriter, Object) |
Mengakhiri pelacakan waktu desain penyajian data. (Diperoleh dari Control) |
| EnsureChildControls() |
Menentukan apakah kontrol server memuat kontrol turunan. Jika tidak, ia membuat kontrol anak. (Diperoleh dari Control) |
| EnsureID() |
Membuat pengidentifikasi untuk kontrol yang tidak memiliki pengidentifikasi yang ditetapkan. (Diperoleh dari Control) |
| Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
| EvaluateIsValid() |
Mengambil alih EvaluateIsValid() metode . |
| FindControl(String) |
Mencari kontainer penamaan saat ini untuk kontrol server dengan parameter yang ditentukan |
| FindControl(String, Int32) |
Mencari kontainer penamaan saat ini untuk kontrol server dengan bilangan bulat dan yang ditentukan |
| Focus() |
Mengatur fokus input ke kontrol. (Diperoleh dari Control) |
| GetControlRenderID(String) |
Mendapatkan ID klien dari kontrol yang ditentukan. (Diperoleh dari BaseValidator) |
| GetControlValidationValue(String) |
Mendapatkan nilai yang terkait dengan kontrol input yang ditentukan. (Diperoleh dari BaseValidator) |
| GetDesignModeState() |
Mendapatkan data waktu desain untuk kontrol. (Diperoleh dari Control) |
| GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetRouteUrl(Object) |
Mendapatkan URL yang sesuai dengan sekumpulan parameter rute. (Diperoleh dari Control) |
| GetRouteUrl(RouteValueDictionary) |
Mendapatkan URL yang sesuai dengan sekumpulan parameter rute. (Diperoleh dari Control) |
| GetRouteUrl(String, Object) |
Mendapatkan URL yang sesuai dengan sekumpulan parameter rute dan nama rute. (Diperoleh dari Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Mendapatkan URL yang sesuai dengan sekumpulan parameter rute dan nama rute. (Diperoleh dari Control) |
| GetType() |
Mendapatkan dari instans Type saat ini. (Diperoleh dari Object) |
| GetUniqueIDRelativeTo(Control) |
Mengembalikan bagian awalan dari UniqueID properti kontrol yang ditentukan. (Diperoleh dari Control) |
| HasControls() |
Menentukan apakah kontrol server berisi kontrol anak apa pun. (Diperoleh dari Control) |
| HasEvents() |
Mengembalikan nilai yang menunjukkan apakah peristiwa terdaftar untuk kontrol atau kontrol turunan apa pun. (Diperoleh dari Control) |
| IsLiteralContent() |
Menentukan apakah kontrol server hanya menyimpan konten harfiah. (Diperoleh dari Control) |
| LoadControlState(Object) |
Memulihkan informasi status kontrol dari permintaan halaman sebelumnya yang disimpan oleh SaveControlState() metode . (Diperoleh dari Control) |
| LoadViewState(Object) |
Memuat status yang disimpan sebelumnya untuk kontrol. (Diperoleh dari Label) |
| MapPathSecure(String) |
Mengambil jalur fisik tempat jalur virtual, baik absolut atau relatif, dipetakan. (Diperoleh dari Control) |
| MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
| MergeStyle(Style) |
Menyalin elemen tidak kosong dari gaya yang ditentukan ke kontrol Web, tetapi tidak akan menimpa elemen gaya kontrol yang ada. Metode ini digunakan terutama oleh pengembang kontrol. (Diperoleh dari WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Menentukan apakah peristiwa untuk kontrol server diteruskan ke hierarki kontrol server UI halaman. (Diperoleh dari Control) |
| OnDataBinding(EventArgs) |
Memunculkan kejadian DataBinding. (Diperoleh dari Control) |
| OnInit(EventArgs) |
Memunculkan kejadian Init. (Diperoleh dari BaseValidator) |
| OnLoad(EventArgs) |
Memunculkan kejadian Load. (Diperoleh dari Control) |
| OnPreRender(EventArgs) |
Memunculkan kejadian PreRender. (Diperoleh dari BaseValidator) |
| OnServerValidate(String) |
Menaikkan ServerValidate peristiwa untuk CustomValidator kontrol. |
| OnUnload(EventArgs) |
Memunculkan kejadian Unload. (Diperoleh dari BaseValidator) |
| OpenFile(String) |
Stream Terbiasa membaca file. (Diperoleh dari Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Menetapkan sumber peristiwa apa pun dan informasinya ke induk kontrol. (Diperoleh dari Control) |
| RegisterValidatorCommonScript() |
Mendaftarkan kode di halaman untuk validasi sisi klien. (Diperoleh dari BaseValidator) |
| RegisterValidatorDeclaration() |
Mendaftarkan deklarasi array ECMAScript menggunakan nama |
| RemovedControl(Control) |
Dipanggil setelah kontrol anak dihapus dari Controls koleksi Control objek. (Diperoleh dari Control) |
| Render(HtmlTextWriter) |
Menampilkan kontrol pada klien. (Diperoleh dari BaseValidator) |
| RenderBeginTag(HtmlTextWriter) |
Merender tag pembuka HTML kontrol ke penulis yang ditentukan. Metode ini digunakan terutama oleh pengembang kontrol. (Diperoleh dari WebControl) |
| RenderChildren(HtmlTextWriter) |
Menghasilkan konten turunan kontrol server ke objek yang disediakan HtmlTextWriter , yang menulis konten yang akan dirender pada klien. (Diperoleh dari Control) |
| RenderContents(HtmlTextWriter) |
Merender konten Label ke dalam penulis yang ditentukan. (Diperoleh dari Label) |
| RenderControl(HtmlTextWriter) |
Output konten kontrol server ke objek yang disediakan HtmlTextWriter dan menyimpan informasi pelacakan tentang kontrol jika pelacakan diaktifkan. (Diperoleh dari Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Output konten kontrol server ke objek yang disediakan HtmlTextWriter menggunakan objek yang disediakan ControlAdapter . (Diperoleh dari Control) |
| RenderEndTag(HtmlTextWriter) |
Merender tag penutup HTML kontrol ke penulis yang ditentukan. Metode ini digunakan terutama oleh pengembang kontrol. (Diperoleh dari WebControl) |
| ResolveAdapter() |
Mendapatkan adaptor kontrol yang bertanggung jawab untuk merender kontrol yang ditentukan. (Diperoleh dari Control) |
| ResolveClientUrl(String) |
Mendapatkan URL yang dapat digunakan oleh browser. (Diperoleh dari Control) |
| ResolveUrl(String) |
Mengonversi URL menjadi URL yang dapat digunakan pada klien yang meminta. (Diperoleh dari Control) |
| SaveControlState() |
Menyimpan perubahan status kontrol server apa pun yang telah terjadi sejak halaman diposting kembali ke server. (Diperoleh dari Control) |
| SaveViewState() |
Menyimpan status apa pun yang dimodifikasi setelah TrackViewState() metode dipanggil. (Diperoleh dari WebControl) |
| SetDesignModeState(IDictionary) |
Mengatur data waktu desain untuk kontrol. (Diperoleh dari Control) |
| SetRenderMethodDelegate(RenderMethod) |
Menetapkan delegasi penanganan aktivitas untuk merender kontrol server dan kontennya ke dalam kontrol induknya. (Diperoleh dari Control) |
| SetTraceData(Object, Object) |
Mengatur data pelacakan untuk pelacakan waktu desain data penyajian, menggunakan kunci data pelacakan dan nilai data pelacakan. (Diperoleh dari Control) |
| SetTraceData(Object, Object, Object) |
Mengatur data pelacakan untuk pelacakan waktu desain data penyajian, menggunakan objek yang dilacak, kunci data pelacakan, dan nilai data pelacakan. (Diperoleh dari Control) |
| ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
| TrackViewState() |
Menyebabkan kontrol melacak perubahan pada status tampilannya sehingga dapat disimpan di properti objek ViewState . (Diperoleh dari WebControl) |
| Validate() |
Melakukan validasi pada kontrol input terkait dan memperbarui IsValid properti . (Diperoleh dari BaseValidator) |
Acara
| DataBinding |
Terjadi ketika kontrol server mengikat ke sumber data. (Diperoleh dari Control) |
| Disposed |
Terjadi ketika kontrol server dilepaskan dari memori, yang merupakan tahap terakhir dari siklus hidup kontrol server ketika halaman ASP.NET diminta. (Diperoleh dari Control) |
| Init |
Terjadi ketika kontrol server diinisialisasi, yang merupakan langkah pertama dalam siklus hidupnya. (Diperoleh dari Control) |
| Load |
Terjadi ketika kontrol server dimuat ke Page dalam objek. (Diperoleh dari Control) |
| PreRender |
Terjadi setelah Control objek dimuat tetapi sebelum penyajian. (Diperoleh dari Control) |
| ServerValidate |
Terjadi ketika validasi dilakukan pada server. |
| Unload |
Terjadi ketika kontrol server dibongkar dari memori. (Diperoleh dari Control) |
Implementasi Antarmuka Eksplisit
Metode Ekstensi
| FindDataSourceControl(Control) |
Mengembalikan sumber data yang terkait dengan kontrol data untuk kontrol yang ditentukan. |
| FindFieldTemplate(Control, String) |
Mengembalikan templat bidang untuk kolom yang ditentukan dalam kontainer penamaan kontrol yang ditentukan. |
| FindMetaTable(Control) |
Mengembalikan objek metatable untuk kontrol data yang berisi. |
Berlaku untuk
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk