DropDownList 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.
Mewakili kontrol yang memungkinkan pengguna memilih satu item dari daftar drop-down.
public ref class DropDownList : System::Web::UI::WebControls::ListControl, System::Web::UI::IPostBackDataHandler[System.Web.UI.ValidationProperty("SelectedItem")]
public class DropDownList : System.Web.UI.WebControls.ListControl, System.Web.UI.IPostBackDataHandler[<System.Web.UI.ValidationProperty("SelectedItem")>]
type DropDownList = class
inherit ListControl
interface IPostBackDataHandlerPublic Class DropDownList
Inherits ListControl
Implements IPostBackDataHandler- Warisan
- Warisan
- Atribut
- Penerapan
Contoh
Proyek situs Web Visual Studio dengan kode sumber tersedia untuk menyertai topik ini: Unduh.
Contoh kode berikut menunjukkan cara membuat DropDownList kontrol yang berisi empat item.
<%@ 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" >
<script runat="server" >
void Selection_Change(Object sender, EventArgs e)
{
// Set the background color for days in the Calendar control
// based on the value selected by the user from the
// DropDownList control.
Calendar1.DayStyle.BackColor =
System.Drawing.Color.FromName(ColorList.SelectedItem.Value);
}
</script>
<head runat="server">
<title> DropDownList Example </title>
</head>
<body>
<form id="form1" runat="server">
<h3> DropDownList Example </h3>
Select a background color for days in the calendar.
<br /><br />
<asp:Calendar id="Calendar1"
ShowGridLines="True"
ShowTitle="True"
runat="server"/>
<br /><br />
<table cellpadding="5">
<tr>
<td>
Background color:
</td>
</tr>
<tr>
<td>
<asp:DropDownList id="ColorList"
AutoPostBack="True"
OnSelectedIndexChanged="Selection_Change"
runat="server">
<asp:ListItem Selected="True" Value="White"> White </asp:ListItem>
<asp:ListItem Value="Silver"> Silver </asp:ListItem>
<asp:ListItem Value="DarkGray"> Dark Gray </asp:ListItem>
<asp:ListItem Value="Khaki"> Khaki </asp:ListItem>
<asp:ListItem Value="DarkKhaki"> Dark Khaki </asp:ListItem>
</asp:DropDownList>
</td>
</tr>
</table>
</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" >
<script runat="server" >
Sub Selection_Change(sender As Object, e As EventArgs)
' Set the background color for days in the Calendar control
' based on the value selected by the user from the
' DropDownList control.
Calendar1.DayStyle.BackColor = _
System.Drawing.Color.FromName(ColorList.SelectedItem.Value)
End Sub
</script>
<head runat="server">
<title> DropDownList Example </title>
</head>
<body>
<form id="form1" runat="server">
<h3> DropDownList Example </h3>
Select a background color for days in the calendar.
<br /><br />
<asp:Calendar id="Calendar1"
ShowGridLines="True"
ShowTitle="True"
runat="server"/>
<br /><br />
<table cellpadding="5">
<tr>
<td>
Background color:
</td>
</tr>
<tr>
<td>
<asp:DropDownList id="ColorList"
AutoPostBack="True"
OnSelectedIndexChanged="Selection_Change"
runat="server">
<asp:ListItem Selected="True" Value="White"> White </asp:ListItem>
<asp:ListItem Value="Silver"> Silver </asp:ListItem>
<asp:ListItem Value="DarkGray"> Dark Gray </asp:ListItem>
<asp:ListItem Value="Khaki"> Khaki </asp:ListItem>
<asp:ListItem Value="DarkKhaki"> Dark Khaki </asp:ListItem>
</asp:DropDownList>
</td>
</tr>
</table>
</form>
</body>
</html>
Contoh kode berikut menunjukkan cara membuat DropDownList kontrol melalui pengikatan data.
<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!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" >
<script runat="server" >
void Selection_Change(Object sender, EventArgs e)
{
// Set the background color for days in the Calendar control
// based on the value selected by the user from the
// DropDownList control.
Calendar1.DayStyle.BackColor =
System.Drawing.Color.FromName(ColorList.SelectedItem.Value);
}
void Page_Load(Object sender, EventArgs e)
{
// Load data for the DropDownList control only once, when the
// page is first loaded.
if(!IsPostBack)
{
// Specify the data source and field names for the Text
// and Value properties of the items (ListItem objects)
// in the DropDownList control.
ColorList.DataSource = CreateDataSource();
ColorList.DataTextField = "ColorTextField";
ColorList.DataValueField = "ColorValueField";
// Bind the data to the control.
ColorList.DataBind();
// Set the default selected item, if desired.
ColorList.SelectedIndex = 0;
}
}
ICollection CreateDataSource()
{
// Create a table to store data for the DropDownList control.
DataTable dt = new DataTable();
// Define the columns of the table.
dt.Columns.Add(new DataColumn("ColorTextField", typeof(String)));
dt.Columns.Add(new DataColumn("ColorValueField", typeof(String)));
// Populate the table with sample values.
dt.Rows.Add(CreateRow("White", "White", dt));
dt.Rows.Add(CreateRow("Silver", "Silver", dt));
dt.Rows.Add(CreateRow("Dark Gray", "DarkGray", dt));
dt.Rows.Add(CreateRow("Khaki", "Khaki", dt));
dt.Rows.Add(CreateRow("Dark Khaki", "DarkKhaki", dt));
// Create a DataView from the DataTable to act as the data source
// for the DropDownList control.
DataView dv = new DataView(dt);
return dv;
}
DataRow CreateRow(String Text, String Value, DataTable dt)
{
// Create a DataRow using the DataTable defined in the
// CreateDataSource method.
DataRow dr = dt.NewRow();
// This DataRow contains the ColorTextField and ColorValueField
// fields, as defined in the CreateDataSource method. Set the
// fields with the appropriate value. Remember that column 0
// is defined as ColorTextField, and column 1 is defined as
// ColorValueField.
dr[0] = Text;
dr[1] = Value;
return dr;
}
</script>
<head runat="server">
<title> DropDownList Data Binding Example </title>
</head>
<body>
<form id="form1" runat="server">
<h3> DropDownList Data Binding Example </h3>
Select a background color for days in the calendar.
<br /><br />
<asp:Calendar id="Calendar1"
ShowGridLines="True"
ShowTitle="True"
runat="server"/>
<br /><br />
<table cellpadding="5">
<tr>
<td>
Background color:
</td>
</tr>
<tr>
<td>
<asp:DropDownList id="ColorList"
AutoPostBack="True"
OnSelectedIndexChanged="Selection_Change"
runat="server"/>
</td>
</tr>
</table>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<!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" >
<script runat="server" >
Sub Selection_Change(sender as Object, e As EventArgs)
' Set the background color for days in the Calendar control
' based on the value selected by the user from the
' DropDownList control.
Calendar1.DayStyle.BackColor = _
System.Drawing.Color.FromName(ColorList.SelectedItem.Value)
End Sub
Sub Page_Load(sender as Object, e As EventArgs)
' Load data for the DropDownList control only once, when the
' page is first loaded.
If Not IsPostBack Then
' Specify the data source and field names for the Text
' and Value properties of the items (ListItem objects)
' in the DropDownList control.
ColorList.DataSource = CreateDataSource()
ColorList.DataTextField = "ColorTextField"
ColorList.DataValueField = "ColorValueField"
' Bind the data to the control.
ColorList.DataBind()
' Set the default selected item, if desired.
ColorList.SelectedIndex = 0
End If
End Sub
Function CreateDataSource() As ICollection
' Create a table to store data for the DropDownList control.
Dim dt As DataTable = New DataTable()
' Define the columns of the table.
dt.Columns.Add(new DataColumn("ColorTextField", GetType(String)))
dt.Columns.Add(new DataColumn("ColorValueField", GetType(String)))
' Populate the table with sample values.
dt.Rows.Add(CreateRow("White", "White", dt))
dt.Rows.Add(CreateRow("Silver", "Silver", dt))
dt.Rows.Add(CreateRow("Dark Gray", "DarkGray", dt))
dt.Rows.Add(CreateRow("Khaki", "Khaki", dt))
dt.Rows.Add(CreateRow("Dark Khaki", "DarkKhaki", dt))
' Create a DataView from the DataTable to act as the data source
' for the DropDownList control.
Dim dv As DataView = New DataView(dt)
Return dv
End Function
Function CreateRow(Text As String, Value As String, dt As DataTable) As DataRow
' Create a DataRow using the DataTable defined in the
' CreateDataSource method.
Dim dr As DataRow = dt.NewRow()
' This DataRow contains the ColorTextField and ColorValueField
' fields, as defined in the CreateDataSource method. Set the
' fields with the appropriate value. Remember that column 0
' is defined as ColorTextField, and column 1 is defined as
' ColorValueField.
dr(0) = Text
dr(1) = Value
Return dr
End Function
</script>
<head runat="server">
<title> DropDownList Data Binding Example </title>
</head>
<body>
<form id="form1" runat="server">
<h3> DropDownList Data Binding Example </h3>
Select a background color for days in the calendar.
<br /><br />
<asp:Calendar id="Calendar1"
ShowGridLines="True"
ShowTitle="True"
runat="server"/>
<br /><br />
<table cellpadding="5">
<tr>
<td>
Background color:
</td>
</tr>
<tr>
<td>
<asp:DropDownList id="ColorList"
AutoPostBack="True"
OnSelectedIndexChanged="Selection_Change"
runat="server"/>
</td>
</tr>
</table>
</form>
</body>
</html>
Keterangan
Dalam topik ini:
Pengantar
DropDownList Gunakan kontrol untuk membuat kontrol daftar drop-down pilihan tunggal. Anda dapat mengontrol tampilan DropDownList kontrol dengan mengatur BorderColorproperti , BorderStyle, dan BorderWidth .
Untuk menentukan item yang ingin Anda munculkan di DropDownList kontrol, tempatkan ListItem objek untuk setiap entri antara tag DropDownList pembuka dan penutup kontrol.
Kontrol ini DropDownList juga mendukung pengikatan data. Untuk mengikat kontrol ke sumber data, buat sumber data, seperti System.Collections.ArrayList objek, yang berisi item untuk ditampilkan dalam kontrol. Kemudian, gunakan Control.DataBind metode untuk mengikat sumber data ke DropDownList kontrol.
SelectedIndex Gunakan properti untuk menentukan indeks item yang dipilih oleh pengguna secara terprogram dari DropDownList kontrol. Indeks kemudian dapat digunakan untuk mengambil item yang dipilih dari Items kumpulan kontrol.
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.
Sintaks Deklaratif
<asp:DropDownList
AccessKey="string"
AppendDataBoundItems="True|False"
AutoPostBack="True|False"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CausesValidation="True|False"
CssClass="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
DataTextField="string"
DataTextFormatString="string"
DataValueField="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"
OnDataBinding="DataBinding event handler"
OnDataBound="DataBound event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnSelectedIndexChanged="SelectedIndexChanged event handler"
OnTextChanged="TextChanged event handler"
OnUnload="Unload event handler"
runat="server"
SelectedIndex="integer"
SelectedValue="string"
SkinID="string"
Style="string"
TabIndex="integer"
ToolTip="string"
ValidationGroup="string"
Visible="True|False"
Width="size"
>
<asp:ListItem
Enabled="True|False"
Selected="True|False"
Text="string"
Value="string"
/>
</asp:DropDownList>
Konstruktor
| DropDownList() |
Menginisialisasi instans baru kelas DropDownList. |
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) |
| AppendDataBoundItems |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah item daftar dibersihkan sebelum pengikatan data. (Diperoleh dari ListControl) |
| 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) |
| AutoPostBack |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah postback ke server secara otomatis terjadi ketika pengguna mengubah pilihan daftar. (Diperoleh dari ListControl) |
| 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. |
| BorderStyle |
Mendapatkan atau mengatur gaya batas kontrol. |
| BorderWidth |
Mendapatkan atau mengatur lebar batas untuk kontrol. |
| CausesValidation |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah validasi dilakukan saat kontrol yang berasal dari ListControl kelas diklik. (Diperoleh dari ListControl) |
| 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) |
| 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 IDataItemContainermengimplementasikan . (Diperoleh dari Control) |
| DataKeysContainer |
Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan IDataKeysControlmengimplementasikan . (Diperoleh dari Control) |
| DataMember |
Mendapatkan atau mengatur tabel tertentu dalam DataSource untuk mengikat kontrol. (Diperoleh dari ListControl) |
| DataSource |
Mendapatkan atau mengatur sumber data yang mengisi item kontrol daftar. (Diperoleh dari ListControl) |
| DataSourceID |
Mendapatkan atau mengatur ID kontrol tempat kontrol terikat data mengambil daftar item datanya. (Diperoleh dari DataBoundControl) |
| DataSourceObject |
Mendapatkan objek yang mengimplementasikan IDataSource antarmuka, yang menyediakan akses ke konten data objek. (Diperoleh dari DataBoundControl) |
| DataTextField |
Mendapatkan atau mengatur bidang sumber data yang menyediakan konten teks item daftar. (Diperoleh dari ListControl) |
| DataTextFormatString |
Mendapatkan atau mengatur string pemformatan yang digunakan untuk mengontrol bagaimana data yang terikat ke kontrol daftar ditampilkan. (Diperoleh dari ListControl) |
| DataValueField |
Mendapatkan atau mengatur bidang sumber data yang menyediakan nilai setiap item daftar. (Diperoleh dari ListControl) |
| 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 kontrol anak apa pun 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 turunan 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) |
| Initialized |
Mendapatkan nilai yang menunjukkan apakah kontrol terikat data telah diinisialisasi. (Diperoleh dari BaseDataBoundControl) |
| IsBoundUsingDataSourceID |
Mendapatkan nilai yang menunjukkan apakah DataSourceID properti diatur. (Diperoleh dari BaseDataBoundControl) |
| IsChildControlStateCleared |
Mendapatkan nilai yang menunjukkan apakah kontrol yang terkandung dalam kontrol ini memiliki status kontrol. (Diperoleh dari Control) |
| IsDataBindingAutomatic |
Mendapatkan nilai yang menunjukkan apakah pengikatan data bersifat otomatis. (Diperoleh dari BaseDataBoundControl) |
| 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) |
| IsUsingModelBinders |
Mendapatkan nilai yang menunjukkan apakah pengikatan model sedang digunakan. (Diperoleh dari DataBoundControl) |
| IsViewStateEnabled |
Mendapatkan nilai yang menunjukkan apakah status tampilan diaktifkan untuk kontrol ini. (Diperoleh dari Control) |
| Items |
Mendapatkan kumpulan item dalam kontrol daftar. (Diperoleh dari ListControl) |
| ItemType |
Mendapatkan atau mengatur nama jenis item data untuk pengikatan data yang ditik dengan kuat. (Diperoleh dari DataBoundControl) |
| 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) |
| RenderingCompatibility |
Mendapatkan nilai yang menentukan versi ASP.NET yang dirender HTML akan kompatibel. (Diperoleh dari Control) |
| RequiresDataBinding |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah DataBind() metode harus dipanggil. (Diperoleh dari BaseDataBoundControl) |
| SelectArguments |
DataSourceSelectArguments Mendapatkan objek yang digunakan kontrol terikat data saat mengambil data dari kontrol sumber data. (Diperoleh dari DataBoundControl) |
| SelectedIndex |
Mendapatkan atau menyetel indeks item terpilih dalam DropDownList kontrol. |
| SelectedItem |
Mendapatkan item terpilih dengan indeks terendah dalam kontrol daftar. (Diperoleh dari ListControl) |
| SelectedValue |
Mendapatkan nilai item yang dipilih dalam kontrol daftar, atau memilih item dalam kontrol daftar yang berisi nilai yang ditentukan. (Diperoleh dari ListControl) |
| SelectMethod |
Nama metode yang akan dipanggil untuk membaca data. (Diperoleh dari DataBoundControl) |
| 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 |
| SupportsDisabledAttribute |
Mendapatkan nilai yang menunjukkan apakah kontrol harus mengatur |
| 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 untuk ListControl kontrol. (Diperoleh dari ListControl) |
| 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 SelectedValue properti ListControl kontrol. (Diperoleh dari ListControl) |
| ToolTip |
Mendapatkan atau mengatur teks TipsAlat yang ditampilkan saat penunjuk mouse berada di atas 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) |
| 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 kontrolnya berasal dari ListControl kelas menyebabkan validasi ketika memposting kembali ke server. (Diperoleh dari ListControl) |
| 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 menyetel lebar kontrol server Web. (Diperoleh dari WebControl) |
Metode
| AddAttributesToRender(HtmlTextWriter) |
Menambahkan atribut dan gaya HTML yang perlu dirender ke objek yang ditentukan HtmlTextWriter . |
| 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 dari data penyajian. (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 turunan 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 turunan kontrol server. (Diperoleh dari Control) |
| ClearEffectiveClientIDMode() |
Mengatur properti instans ClientIDMode kontrol saat ini dan kontrol turunan apa pun ke Inherit. (Diperoleh dari Control) |
| ClearSelection() |
Menghapus pilihan daftar dan mengatur Selected properti semua item ke false. (Diperoleh dari ListControl) |
| ConfirmInitState() |
Mengatur status inisialisasi kontrol terikat data. (Diperoleh dari BaseDataBoundControl) |
| 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 koleksi untuk menyimpan kontrol anak. |
| 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) |
| CreateDataSourceSelectArguments() |
Membuat objek default DataSourceSelectArguments yang digunakan oleh kontrol terikat data jika tidak ada argumen yang ditentukan. (Diperoleh dari DataBoundControl) |
| DataBind() |
Mengikat sumber data ke kontrol server yang dipanggil dan semua kontrol turunannya. (Diperoleh dari Control) |
| DataBind() |
Mengikat sumber data ke kontrol server yang dipanggil dan semua kontrol turunannya. (Diperoleh dari BaseDataBoundControl) |
| 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 dirilis dari memori. (Diperoleh dari Control) |
| EndRenderTracing(TextWriter, Object) |
Mengakhiri pelacakan waktu desain data penyajian. (Diperoleh dari Control) |
| EnsureChildControls() |
Menentukan apakah kontrol server berisi kontrol anak. Jika tidak, itu membuat kontrol anak. (Diperoleh dari Control) |
| EnsureDataBound() |
DataBind() Memanggil metode jika DataSourceID properti diatur dan kontrol terikat data ditandai untuk memerlukan pengikatan. (Diperoleh dari BaseDataBoundControl) |
| 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 yang ditentukan |
| Focus() |
Mengatur fokus input ke kontrol. (Diperoleh dari Control) |
| GetData() |
DataSourceView Mengambil objek yang digunakan kontrol terikat data untuk melakukan operasi data. (Diperoleh dari DataBoundControl) |
| GetDataSource() |
IDataSource Mengambil antarmuka yang dikaitkan dengan kontrol terikat data, jika ada. (Diperoleh dari DataBoundControl) |
| 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 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) |
| LoadPostData(String, NameValueCollection) |
Memproses data postback untuk DropDownList kontrol. |
| LoadViewState(Object) |
Memuat status tampilan kontrol yang DetailsView disimpan sebelumnya. (Diperoleh dari ListControl) |
| MapPathSecure(String) |
Mengambil jalur fisik tempat jalur virtual, baik absolut atau relatif, dipetakan. (Diperoleh dari Control) |
| MarkAsDataBound() |
Mengatur status kontrol dalam status tampilan sebagai berhasil terikat ke data. (Diperoleh dari DataBoundControl) |
| MemberwiseClone() |
Membuat salinan dangkal dari yang 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) |
| OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) |
Memunculkan kejadian CreatingModelDataSource. (Diperoleh dari DataBoundControl) |
| OnDataBinding(EventArgs) |
Memunculkan kejadian DataBinding. (Diperoleh dari ListControl) |
| OnDataBound(EventArgs) |
Memunculkan kejadian DataBound. (Diperoleh dari BaseDataBoundControl) |
| OnDataPropertyChanged() |
Mengikat kembali kontrol terikat data ke datanya setelah salah satu properti identifikasi sumber data dasar berubah. (Diperoleh dari DataBoundControl) |
| OnDataSourceViewChanged(Object, EventArgs) |
Memunculkan kejadian DataSourceViewChanged. (Diperoleh dari DataBoundControl) |
| OnInit(EventArgs) |
Memunculkan kejadian Init. (Diperoleh dari Control) |
| OnInit(EventArgs) |
Init Menangani peristiwa. (Diperoleh dari BaseDataBoundControl) |
| OnLoad(EventArgs) |
Memunculkan kejadian Load. (Diperoleh dari Control) |
| OnLoad(EventArgs) |
Load Menangani peristiwa. (Diperoleh dari DataBoundControl) |
| OnPagePreLoad(Object, EventArgs) |
Mengatur status inisialisasi kontrol terikat data sebelum kontrol dimuat. (Diperoleh dari DataBoundControl) |
| OnPreRender(EventArgs) |
Memunculkan kejadian PreRender. (Diperoleh dari ListControl) |
| OnSelectedIndexChanged(EventArgs) |
Memunculkan kejadian SelectedIndexChanged. Ini memungkinkan Anda untuk menyediakan handler kustom untuk peristiwa tersebut. (Diperoleh dari ListControl) |
| OnTextChanged(EventArgs) |
Memunculkan kejadian TextChanged. (Diperoleh dari ListControl) |
| OnUnload(EventArgs) |
Memunculkan kejadian Unload. (Diperoleh dari Control) |
| OpenFile(String) |
Stream Menggunakan untuk membaca file. (Diperoleh dari Control) |
| PerformDataBinding(IEnumerable) |
Mengikat sumber data yang ditentukan ke kontrol yang berasal dari ListControl kelas . (Diperoleh dari ListControl) |
| PerformSelect() |
Mengambil data dari sumber data terkait. (Diperoleh dari ListControl) |
| RaiseBubbleEvent(Object, EventArgs) |
Menetapkan sumber peristiwa apa pun dan informasinya ke induk kontrol. (Diperoleh dari Control) |
| RaisePostDataChangedEvent() |
Menaikkan peristiwa untuk DropDownList kontrol saat postback terjadi. |
| 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) |
Mengeluarkan 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. |
| RenderContents(HtmlTextWriter) |
Merender item dalam ListControl kontrol. (Diperoleh dari ListControl) |
| 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 yang telah terjadi sejak halaman diposting kembali ke server. (Diperoleh dari Control) |
| SaveViewState() |
Menyimpan status tampilan saat ini dari ListControl kontrol -turunan dan item yang dikandungnya. (Diperoleh dari ListControl) |
| SetDesignModeState(IDictionary) |
Mengatur data waktu desain untuk kontrol. (Diperoleh dari Control) |
| SetPostDataSelection(Int32) |
Selected Mengatur properti ListItem kontrol setelah halaman diposting. (Diperoleh dari ListControl) |
| 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() |
Menandai titik awal untuk mulai melacak dan menyimpan perubahan status tampilan ke ListControl kontrol -turunan. (Diperoleh dari ListControl) |
| ValidateDataSource(Object) |
Memverifikasi bahwa objek yang diikat kontrol terikat data adalah objek yang dapat dikerjakannya. (Diperoleh dari DataBoundControl) |
| VerifyMultiSelect() |
Selalu melempar HttpException pengecualian karena beberapa pilihan tidak didukung untuk DropDownList kontrol. |
| VerifyMultiSelect() |
Menentukan apakah kontrol daftar mendukung mode multiseleksi. (Diperoleh dari ListControl) |
Acara
| CallingDataMethods |
Terjadi ketika metode data sedang dipanggil. (Diperoleh dari DataBoundControl) |
| CreatingModelDataSource |
Terjadi ketika ModelDataSource objek sedang dibuat. (Diperoleh dari DataBoundControl) |
| DataBinding |
Terjadi ketika kontrol server mengikat ke sumber data. (Diperoleh dari Control) |
| DataBound |
Terjadi setelah kontrol server mengikat ke sumber data. (Diperoleh dari BaseDataBoundControl) |
| Disposed |
Terjadi ketika kontrol server dirilis 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) |
| SelectedIndexChanged |
Terjadi ketika pilihan dari kontrol daftar berubah antara postingan ke server. (Diperoleh dari ListControl) |
| TextChanged |
Terjadi ketika Text properti dan SelectedValue berubah. (Diperoleh dari ListControl) |
| Unload |
Terjadi ketika kontrol server dibongkar dari memori. (Diperoleh dari Control) |
Implementasi Antarmuka Eksplisit
Metode Ekstensi
| EnablePersistedSelection(BaseDataBoundControl) |
Kedaluwarsa.
Memungkinkan pilihan untuk dipertahankan dalam kontrol data yang mendukung pemilihan dan halaman. |
| 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