Button 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.
Menampilkan kontrol tombol tekan pada halaman Web.
public ref class Button : System::Web::UI::WebControls::WebControl, System::Web::UI::IPostBackEventHandlerpublic ref class Button : System::Web::UI::WebControls::WebControl, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::IButtonControlpublic class Button : System.Web.UI.WebControls.WebControl, System.Web.UI.IPostBackEventHandlerpublic class Button : System.Web.UI.WebControls.WebControl, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.IButtonControltype Button = class
inherit WebControl
interface IPostBackEventHandlertype Button = class
inherit WebControl
interface IButtonControl
interface IPostBackEventHandlerPublic Class Button
Inherits WebControl
Implements IPostBackEventHandlerPublic Class Button
Inherits WebControl
Implements IButtonControl, IPostBackEventHandler- Warisan
- Penerapan
Contoh
Contoh kode berikut menunjukkan cara membuat kontrol Kirim Button yang memposting konten halaman Web kembali ke server.
<%@ 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>Button Example</title>
<script language="C#" runat="server">
void SubmitBtn_Click(Object sender, EventArgs e)
{
Message.Text="Hello World!!";
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Button Example</h3>
Click on the submit button.<br /><br />
<asp:Button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server"/>
<br />
<asp:label id="Message" 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>Button Example</title>
<script language="VB" runat="server">
Sub SubmitBtn_Click(sender As Object, e As EventArgs)
Message.Text = "Hello World!!"
End Sub 'SubmitBtn_Click
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Button Example</h3>
Click on the submit button.<br /><br />
<asp:Button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server"/>
<br />
<asp:label id="Message" runat="server"/>
</form>
</body>
</html>
Contoh kode berikut menunjukkan cara membuat kontrol Perintah Button yang mengurutkan daftar.
<%@ 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 runat="server">
<title>Button CommandName Example</title>
<script runat="server">
void CommandBtn_Click(Object sender, CommandEventArgs e)
{
switch(e.CommandName)
{
case "Sort":
// Call the method to sort the list.
Sort_List((String)e.CommandArgument);
break;
case "Submit":
// Display a message for the Submit button being clicked.
Message.Text = "You clicked the Submit button";
// Test whether the command argument is an empty string ("").
if((String)e.CommandArgument == "")
{
// End the message.
Message.Text += ".";
}
else
{
// Display an error message for the command argument.
Message.Text += ", however the command argument is not recogized.";
}
break;
default:
// The command name is not recognized. Display an error message.
Message.Text = "Command name not recogized.";
break;
}
}
void Sort_List(string commandArgument)
{
switch(commandArgument)
{
case "Ascending":
// Insert code to sort the list in ascending order here.
Message.Text = "You clicked the Sort Ascending button.";
break;
case "Descending":
// Insert code to sort the list in descending order here.
Message.Text = "You clicked the Sort Descending button.";
break;
default:
// The command argument is not recognized. Display an error message.
Message.Text = "Command argument not recogized.";
break;
}
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Button CommandName Example</h3>
Click on one of the command buttons.
<br /><br />
<asp:Button id="Button1"
Text="Sort Ascending"
CommandName="Sort"
CommandArgument="Ascending"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button2"
Text="Sort Descending"
CommandName="Sort"
CommandArgument="Descending"
OnCommand="CommandBtn_Click"
runat="server"/>
<br /><br />
<asp:Button id="Button3"
Text="Submit"
CommandName="Submit"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button4"
Text="Unknown Command Name"
CommandName="UnknownName"
CommandArgument="UnknownArgument"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button5"
Text="Submit Unknown Command Argument"
CommandName="Submit"
CommandArgument="UnknownArgument"
OnCommand="CommandBtn_Click"
runat="server"/>
<br /><br />
<asp:Label id="Message" 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 runat="server">
<title>Button CommandName Example</title>
<script runat="server">
Sub CommandBtn_Click(sender As Object, e As CommandEventArgs)
Select e.CommandName
Case "Sort"
' Call the method to sort the list.
Sort_List(CType(e.CommandArgument, String))
Case "Submit"
' Display a message for the Submit button being clicked.
Message.Text = "You clicked the Submit button"
' Test whether the command argument is an empty string ("").
If CType(e.CommandArgument , String) = "" Then
' End the message.
Message.Text &= "."
Else
' Display an error message for the command argument.
Message.Text &= ", however the command argument is not recogized."
End If
Case Else
' The command name is not recognized. Display an error message.
Message.Text = "Command name not recogized."
End Select
End Sub
Sub Sort_List(commandArgument As String)
Select commandArgument
Case "Ascending"
' Insert code to sort the list in ascending order here.
Message.Text = "You clicked the Sort Ascending button."
Case "Descending"
' Insert code to sort the list in descending order here.
Message.Text = "You clicked the Sort Descending button."
Case Else
' The command argument is not recognized. Display an error message.
Message.Text = "Command argument not recogized."
End Select
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Button CommandName Example</h3>
Click on one of the command buttons.
<br /><br />
<asp:Button id="Button1"
Text="Sort Ascending"
CommandName="Sort"
CommandArgument="Ascending"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button2"
Text="Sort Descending"
CommandName="Sort"
CommandArgument="Descending"
OnCommand="CommandBtn_Click"
runat="server"/>
<br /><br />
<asp:Button id="Button3"
Text="Submit"
CommandName="Submit"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button4"
Text="Unknown Command Name"
CommandName="UnknownName"
CommandArgument="UnknownArgument"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button5"
Text="Submit Unknown Command Argument"
CommandName="Submit"
CommandArgument="UnknownArgument"
OnCommand="CommandBtn_Click"
runat="server"/>
<br /><br />
<asp:Label id="Message" runat="server"/>
</form>
</body>
</html>
Keterangan
Dalam topik ini:
Pengantar
Button Gunakan kontrol untuk membuat tombol tekan di halaman Web yang memungkinkan pengguna memposting halaman ke server. Kontrol memicu peristiwa dalam kode server yang dapat Anda tangani untuk merespons postback. Ini juga dapat menaikkan peristiwa dalam skrip klien yang dapat Anda tangani sebelum halaman diposting atau yang dapat berjalan lalu membatalkan pengiriman halaman.
Catatan
ASP.NET menyertakan beberapa jenis kontrol tombol, yang masing-masing muncul secara berbeda di halaman Web. Mereka adalah Button kontrol, yang dirender sebagai tombol tekan; LinkButton kontrol, yang dirender sebagai tautan; dan ImageButton kontrol, yang dirender sebagai gambar; dan ImageMap kontrol, yang memungkinkan Anda membuat grafik yang memiliki hotspot yang dapat diklik pengguna. Secara default, semua kontrol tombol mengirimkan halaman saat diklik. Anda juga dapat menggunakan HtmlButton kontrol dan HtmlInputButton untuk membuat tombol di halaman yang dapat diprogram dalam kode server. Untuk detail tentang perbedaan antara kontrol HTML dan server Web, lihat Gambaran Umum Kontrol Server Web ASP.NET.
Secara default, Button kontrol adalah tombol Kirim. Tombol Kirim tidak memiliki nama perintah (ditentukan oleh CommandName properti ) yang terkait dengan tombol dan cukup memposting halaman Web kembali ke server. Anda dapat menyediakan penanganan aktivitas untuk Click peristiwa guna mengontrol tindakan yang dilakukan secara terprogram saat tombol Kirim diklik.
Tombol Perintah memiliki nama perintah yang terkait dengan tombol , seperti Sort, dengan mengatur CommandName properti . Ini memungkinkan Anda membuat beberapa Button kontrol pada halaman Web dan secara terprogram menentukan kontrol mana yang Button diklik. Anda juga dapat menggunakan CommandArgument properti dengan tombol perintah untuk memberikan informasi tambahan tentang perintah yang akan dilakukan, seperti Ascending. Anda dapat menyediakan penanganan aktivitas untuk Command peristiwa guna mengontrol tindakan yang dilakukan secara terprogram saat tombol Perintah diklik.
Perilaku Postback Tombol dan Peristiwa Server
Ketika pengguna mengklik tombol kontrol server Web apa pun, halaman dikirim ke server. Ini menyebabkan halaman Web diproses dan peristiwa yang tertunda dinaikkan dalam kode berbasis server. Ketika semua pemrosesan halaman dan kontrol telah selesai, halaman merender dirinya sendiri ke browser lagi.
Tombol dapat meningkatkan peristiwa atau Command peristiwa mereka sendiriClick, yang dapat Anda tangani dengan menggunakan kode berbasis server. Ini berbeda dari peristiwa di halaman HTML tradisional atau di aplikasi Web berbasis klien, di mana peristiwa tombol onclick ditangani dengan menggunakan JavaScript yang berjalan di klien. Untuk informasi selengkapnya, lihat ASP.NET Model Peristiwa Kontrol Server Formulir Web.
Saat pengguna mengklik kontrol tombol, halaman diposting kembali ke server. Secara default, halaman diposting kembali ke dirinya sendiri,
Anda dapat mengonfigurasi tombol untuk memposting halaman saat ini ke halaman lain. Ini dapat berguna untuk membuat formulir multi-halaman. Untuk detailnya, lihat Postingan Lintas Halaman di Formulir Web ASP.NET.
Menangani Peristiwa Tombol di Skrip Klien
Kontrol tombol dapat meningkatkan peristiwa server dan peristiwa klien. Peristiwa server terjadi setelah postback, dan ditangani dalam kode sisi server yang Anda tulis untuk halaman tersebut. Peristiwa klien ditangani dalam skrip klien, biasanya ECMAScript (JavaScript), dan dinaikkan sebelum halaman dikirimkan. Dengan menambahkan peristiwa sisi klien ke kontrol tombol ASP.NET, Anda dapat melakukan tugas seperti menampilkan kotak dialog konfirmasi sebelum mengirimkan halaman, dan berpotensi membatalkan pengiriman. Untuk detailnya, lihat Skrip Klien di Halaman Web ASP.NET dan Cara: Merespons Peristiwa Kontrol Server Web Tombol di Skrip Klien.
Anda mungkin juga ingin Button kontrol juga menggunakan skrip klien untuk melakukan postback (alih-alih hanya melakukan operasi HTTP POST). Ini dapat berguna jika Anda ingin memanipulasi postback secara terprogram, seperti melampirkannya ke elemen lain di halaman. Anda dapat mengatur Button properti kontrol UseSubmitBehavior untuk true menyebabkan Button kontrol menggunakan postback berbasis skrip klien.
Kontrol dan Validasi Tombol
Jika halaman berisi kontrol validator ASP.NET, secara default, mengklik kontrol tombol menyebabkan kontrol validator melakukan pemeriksaannya. Jika validasi sisi klien diaktifkan untuk kontrol validator, halaman tidak dikirimkan jika pemeriksaan validasi gagal.
Tabel berikut ini menjelaskan properti yang didukung oleh kontrol tombol yang memungkinkan Anda mengontrol proses validasi dengan lebih tepat.
| Properti | Deskripsi |
|---|---|
| CausesValidation | Menentukan apakah mengklik tombol juga melakukan pemeriksaan validasi. Atur properti ini ke false untuk mencegah pemeriksaan validasi. |
| ValidationGroup | Memungkinkan Anda menentukan validator mana pada halaman yang dipanggil ketika tombol diklik. Jika tidak ada grup validasi yang dibuat, klik tombol akan memanggil semua validator yang ada di halaman. |
Untuk informasi selengkapnya, lihat Memvalidasi Input Pengguna di Halaman Web ASP.NET.
Tombol dalam Kontrol Data
Kontrol server Button Web sering digunakan dalam kontrol data, seperti di DataListkontrol daftar , , GridViewdan Repeater . Dalam kasus tersebut, Anda biasanya tidak merespons langsung ke peristiwa klik tombol. Sebaliknya, tombol dalam kontrol data memunculkan peristiwa yang khusus untuk kontrol data. Misalnya, dalam DataList kontrol, tombol mungkin menaikkan DataList peristiwa kontrol ItemCommand alih-alih menaikkan Button peristiwa kontrol Click .
Karena kontrol daftar terikat data dapat berisi banyak tombol, Anda dapat mengatur properti tombol CommandArgument untuk menentukan nilai yang akan diteruskan sebagai bagian dari peristiwa. Anda kemudian dapat menguji argumen ini untuk melihat tombol mana yang diklik.
Mengikat Data ke Kontrol
Anda dapat mengikat tombol Kontrol server web ke sumber data untuk mengontrol pengaturan propertinya secara dinamis. Misalnya, Anda dapat mengatur properti tombol Text dengan menggunakan pengikatan data.
Menggunakan Tombol dengan Kontrol UpdatePanel
Penyajian sebagian halaman memungkinkan untuk merefresh bagian halaman tanpa postback. UpdatePanel kontrol memungkinkan Anda menandai bagian halaman yang berpartisipasi dalam penyajian halaman parsial. Secara default, perilaku kontrol di dalam UpdatePanel kontrol, termasuk Button kontrol, adalah melakukan postback asinkron alih-alih postback. Ini hanya me-refresh konten UpdatePanel kontrol dari mana postback berasal.
Selain skenario Button kontrol yang berada di dalam UpdatePanel kontrol, Anda dapat menggunakan Button kontrol dengan UpdatePanel kontrol dalam skenario berikut:
Menentukan Button kontrol yang berada di luar UpdatePanel kontrol sebagai AsyncPostBackTrigger kontrol untuk panel tersebut. Ketika tombol diklik, tombol melakukan postback asinkron dan merefresh konten panel.
Menentukan Button kontrol yang berada di dalam UpdatePanel kontrol sebagai PostBackTrigger untuk panel. Ketika tombol diklik, tombol melakukan postback meskipun berada di dalam UpdatePanel kontrol.
Untuk informasi selengkapnya tentang penyajian halaman parsial dan menggunakan UpdatePanel kontrol, lihat Gambaran Umum Kontrol UpdatePanel dan Gambaran Umum Penyajian Halaman Parsial.
Sintaks Deklaratif
<asp:Button
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CausesValidation="True|False"
CommandArgument="string"
CommandName="string"
CssClass="string"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
OnClick="Click event handler"
OnClientClick="string"
OnCommand="Command event handler"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
PostBackUrl="uri"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
Text="string"
ToolTip="string"
UseSubmitBehavior="True|False"
ValidationGroup="string"
Visible="True|False"
Width="size"
/>
Konstruktor
| Button() |
Menginisialisasi instans baru kelas Button. |
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) |
| 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 menyetel 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) |
| CausesValidation |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah validasi dilakukan saat Button kontrol diklik. |
| 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) |
| CommandArgument |
Mendapatkan atau mengatur parameter opsional yang diteruskan ke Command peristiwa bersama dengan yang terkait CommandName. |
| CommandName |
Mendapatkan atau mengatur nama perintah yang terkait dengan Button kontrol yang diteruskan ke Command peristiwa. |
| 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) |
| CssClass |
Mendapatkan atau mengatur kelas Lembar Gaya Bertingkat (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) |
| Enabled |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server Web diaktifkan. (Diperoleh dari WebControl) |
| 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) |
| 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 latar depan (biasanya warna teks) kontrol server Web. (Diperoleh dari WebControl) |
| 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) |
| 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) |
| OnClientClick |
Mendapatkan atau mengatur skrip sisi klien yang dijalankan saat Button peristiwa kontrol Click dinaikkan. |
| 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) |
| PostBackUrl |
Mendapatkan atau mengatur URL halaman yang akan diposting dari halaman saat ini saat Button kontrol diklik. |
| RenderingCompatibility |
Mendapatkan nilai yang menentukan versi ASP.NET yang akan kompatibel dengan HTML yang dirender. (Diperoleh dari Control) |
| 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 ke 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 |
HtmlTextWriterTag Mendapatkan nilai yang sesuai dengan kontrol server Web ini. Properti ini digunakan terutama oleh pengembang kontrol. (Diperoleh dari WebControl) |
| 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 dari atau UserControl yang berisi kontrol server saat ini. (Diperoleh dari Control) |
| Text |
Mendapatkan atau mengatur teks caption ditampilkan dalam Button kontrol. |
| 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) |
| UseSubmitBehavior |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah Button kontrol menggunakan mekanisme pengiriman browser klien atau mekanisme postback ASP.NET. |
| 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 grup kontrol yang Button kontrolnya menyebabkan validasi ketika memposting kembali ke server. |
| 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 menetapkan nilai yang menunjukkan apakah kontrol server dirender sebagai UI di halaman. (Diperoleh dari Control) |
| Width |
Mendapatkan atau menyetel lebar kontrol server Web. (Diperoleh dari WebControl) |
Metode
| AddAttributesToRender(HtmlTextWriter) |
Menambahkan atribut Button 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 server bahwa elemen, baik XML atau HTML, diurai, dan menambahkan elemen ke objek kontrol ControlCollection server. (Diperoleh dari Control) |
| 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) |
| 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) |
| 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) |
| 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) |
| 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) |
| GetDesignModeState() |
Mendapatkan data waktu desain untuk kontrol. (Diperoleh dari Control) |
| GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetPostBackOptions() |
PostBackOptions Membuat objek yang mewakili Button perilaku postback kontrol. |
| 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) |
Memulihkan informasi status tampilan dari permintaan sebelumnya yang disimpan dengan SaveViewState() metode . (Diperoleh dari WebControl) |
| 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) |
| OnClick(EventArgs) | |
| OnCommand(CommandEventArgs) | |
| OnDataBinding(EventArgs) |
Memunculkan kejadian DataBinding. (Diperoleh dari Control) |
| OnInit(EventArgs) |
Memunculkan kejadian Init. (Diperoleh dari Control) |
| OnLoad(EventArgs) |
Memunculkan kejadian Load. (Diperoleh dari Control) |
| OnPreRender(EventArgs) |
Menentukan apakah tombol telah diklik sebelum penyajian pada klien. |
| OnPreRender(EventArgs) |
Memunculkan kejadian PreRender. (Diperoleh dari Control) |
| OnUnload(EventArgs) |
Memunculkan kejadian Unload. (Diperoleh dari Control) |
| 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) |
| RaisePostBackEvent(String) |
Menaikkan peristiwa untuk Button kontrol ketika memposting kembali ke server. |
| RemovedControl(Control) |
Dipanggil setelah kontrol anak dihapus dari Controls koleksi Control objek. (Diperoleh dari Control) |
| Render(HtmlTextWriter) |
Merender kontrol ke penulis HTML yang ditentukan. (Diperoleh dari WebControl) |
| 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 kontrol ke penulis yang ditentukan. |
| 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) |
Acara
| Click |
Terjadi ketika Button kontrol diklik. |
| Command |
Terjadi ketika Button kontrol diklik. |
| 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) |
| 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