DropDownList Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Kullanıcının açılan listeden tek bir öğe seçmesine izin veren bir denetimi temsil eder.
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- Devralma
- Devralma
- Öznitelikler
- Uygulamalar
Örnekler
Aşağıdaki kod örneği, dört öğe içeren bir DropDownList denetimin nasıl oluşturulacağını gösterir.
<%@ 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>
Aşağıdaki kod örneği, veri bağlamaya rağmen denetimin DropDownList nasıl oluşturulacağını gösterir.
<%@ 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>
Açıklamalar
Bu makalede:
Introduction
DropDownList Tek seçimli açılan liste denetimi oluşturmak için denetimi kullanın. , BorderStyleve BorderWidth özelliklerini ayarlayarak denetimin BorderColorgörünümünü DropDownList denetleyebilirsiniz.
Denetimde DropDownList görünmesini istediğiniz öğeleri belirtmek için, denetimin açma ve kapatma etiketleri DropDownList arasına her girdi için bir ListItem nesne yerleştirin.
Denetim DropDownList , veri bağlamayı da destekler. Denetimi bir veri kaynağına bağlamak için, denetimde görüntülenecek öğeleri içeren bir nesne gibi bir System.Collections.ArrayList veri kaynağı oluşturun. Ardından, veri kaynağını denetime bağlamak için DropDownList yöntemini kullanınControl.DataBind.
Denetiminden SelectedIndexDropDownList kullanıcı tarafından seçilen öğenin dizinini program aracılığıyla belirlemek için özelliğini kullanın. Daha sonra dizin, seçili öğeyi denetimin Items koleksiyonundan almak için kullanılabilir.
Erişilebilirlik
Bu denetimi erişilebilirlik standartlarına uygun işaretlemeler oluşturacak şekilde yapılandırma hakkında bilgi için bkz . Visual Studio'da Erişilebilirlik ve ASP.NET ve ASP.NET Denetimleri ve Erişilebilirlik.
Bildirim Temelli Söz Dizimi
<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>
Oluşturucular
| Name | Description |
|---|---|
| DropDownList() |
DropDownList sınıfının yeni bir örneğini başlatır. |
Özellikler
| Name | Description |
|---|---|
| AccessKey |
Web sunucusu denetimine hızla gitmenize olanak tanıyan erişim anahtarını alır veya ayarlar. (Devralındığı yer: WebControl) |
| Adapter |
Denetim için tarayıcıya özgü bağdaştırıcıyı alır. (Devralındığı yer: Control) |
| AppendDataBoundItems |
Veri bağlamadan önce liste öğelerinin temizlenip temizlenmediğini gösteren bir değer alır veya ayarlar. (Devralındığı yer: ListControl) |
| AppRelativeTemplateSourceDirectory |
Bu denetimi içeren veya nesnesinin Page uygulama göreli sanal dizinini alır veya UserControl ayarlar. (Devralındığı yer: Control) |
| Attributes |
Denetimdeki özelliklere karşılık gelen rastgele özniteliklerin (yalnızca işleme için) koleksiyonunu alır. (Devralındığı yer: WebControl) |
| AutoPostBack |
Kullanıcı liste seçimini değiştirdiğinde sunucuya geri göndermenin otomatik olarak gerçekleşip gerçekleşmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: ListControl) |
| BackColor |
Web sunucusu denetiminin arka plan rengini alır veya ayarlar. (Devralındığı yer: WebControl) |
| BindingContainer |
Bu denetimin veri bağlamasını içeren denetimi alır. (Devralındığı yer: Control) |
| BorderColor |
Denetimin kenarlık rengini alır veya ayarlar. |
| BorderStyle |
Denetimin kenarlık stilini alır veya ayarlar. |
| BorderWidth |
Denetimin kenarlık genişliğini alır veya ayarlar. |
| CausesValidation |
Sınıfından ListControl türetilen bir denetime tıklandığında doğrulamanın gerçekleştirilip gerçekleştirilmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: ListControl) |
| ChildControlsCreated |
Sunucu denetiminin alt denetimlerinin oluşturulup oluşturulmadığını gösteren bir değer alır. (Devralındığı yer: Control) |
| ClientID |
ASP.NET tarafından oluşturulan HTML işaretlemesinin denetim kimliğini alır. (Devralındığı yer: Control) |
| ClientIDMode |
Özelliğinin değerini oluşturmak için kullanılan algoritmayı ClientID alır veya ayarlar. (Devralındığı yer: Control) |
| ClientIDSeparator |
özelliğinde ClientID kullanılan ayırıcı karakteri temsil eden bir karakter değeri alır. (Devralındığı yer: Control) |
| Context |
HttpContext Geçerli Web isteği için sunucu denetimiyle ilişkili nesneyi alır. (Devralındığı yer: Control) |
| Controls |
ControlCollection Kullanıcı arabirimi hiyerarşisinde belirtilen bir sunucu denetimi için alt denetimleri temsil eden bir nesne alır. (Devralındığı yer: Control) |
| ControlStyle |
Web sunucusu denetiminin stilini alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| ControlStyleCreated |
Özelliği için ControlStyle bir nesne oluşturulup oluşturulmadığını belirten bir Style değer alır. Bu özellik öncelikli olarak denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| CssClass |
İstemcideki Web sunucusu denetimi tarafından işlenen Basamaklı Stil Sayfası (CSS) sınıfını alır veya ayarlar. (Devralındığı yer: WebControl) |
| DataItemContainer |
Adlandırma kapsayıcısı uygularsa IDataItemContaineradlandırma kapsayıcısına başvuru alır. (Devralındığı yer: Control) |
| DataKeysContainer |
Adlandırma kapsayıcısı uygularsa IDataKeysControladlandırma kapsayıcısına başvuru alır. (Devralındığı yer: Control) |
| DataMember |
denetimine bağlamak için içindeki DataSource belirli tabloyu alır veya ayarlar. (Devralındığı yer: ListControl) |
| DataSource |
Liste denetiminin öğelerini dolduran veri kaynağını alır veya ayarlar. (Devralındığı yer: ListControl) |
| DataSourceID |
Veri bağlama denetiminin veri öğeleri listesini aldığı denetimin kimliğini alır veya ayarlar. (Devralındığı yer: DataBoundControl) |
| DataSourceObject |
Arabirimini uygulayan ve nesnenin IDataSource veri içeriğine erişim sağlayan bir nesnesi alır. (Devralındığı yer: DataBoundControl) |
| DataTextField |
Liste öğelerinin metin içeriğini sağlayan veri kaynağının alanını alır veya ayarlar. (Devralındığı yer: ListControl) |
| DataTextFormatString |
Liste denetimine bağlı verilerin nasıl görüntüleneceğini denetlemek için kullanılan biçimlendirme dizesini alır veya ayarlar. (Devralındığı yer: ListControl) |
| DataValueField |
Her liste öğesinin değerini sağlayan veri kaynağının alanını alır veya ayarlar. (Devralındığı yer: ListControl) |
| DesignMode |
Bir denetimin tasarım yüzeyinde kullanılıp kullanılmadığını belirten bir değer alır. (Devralındığı yer: Control) |
| Enabled |
Web sunucusu denetiminin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: WebControl) |
| EnableTheming |
Temaların bu denetime uygulanıp uygulanmadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: WebControl) |
| EnableViewState |
Sunucu denetiminin görünüm durumunu ve içerdiği alt denetimlerin görünüm durumunu istekte bulunan istemciye kalıcı hale getirip taşımadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: Control) |
| Events |
Denetim için olay işleyicisi temsilcilerinin listesini alır. Bu özellik salt okunurdur. (Devralındığı yer: Control) |
| Font |
Web sunucusu denetimiyle ilişkili yazı tipi özelliklerini alır. (Devralındığı yer: WebControl) |
| ForeColor |
Web sunucusu denetiminin ön plan rengini (genellikle metnin rengi) alır veya ayarlar. (Devralındığı yer: WebControl) |
| HasAttributes |
Denetimin ayarlanmış öznitelikleri olup olmadığını belirten bir değer alır. (Devralındığı yer: WebControl) |
| HasChildViewState |
Geçerli sunucu denetiminin alt denetimlerinin kaydedilmiş görünüm durumu ayarlarına sahip olup olmadığını gösteren bir değer alır. (Devralındığı yer: Control) |
| Height |
Web sunucusu denetiminin yüksekliğini alır veya ayarlar. (Devralındığı yer: WebControl) |
| ID |
Sunucu denetimine atanan programlı tanımlayıcıyı alır veya ayarlar. (Devralındığı yer: Control) |
| IdSeparator |
Denetim tanımlayıcılarını ayırmak için kullanılan karakteri alır. (Devralındığı yer: Control) |
| Initialized |
Veri bağlama denetiminin başlatılıp başlatılmadığını belirten bir değer alır. (Devralındığı yer: BaseDataBoundControl) |
| IsBoundUsingDataSourceID |
Özelliğin ayarlanıp ayarlanmadığını DataSourceID belirten bir değer alır. (Devralındığı yer: BaseDataBoundControl) |
| IsChildControlStateCleared |
Bu denetimin içindeki denetimlerin denetim durumuna sahip olup olmadığını gösteren bir değer alır. (Devralındığı yer: Control) |
| IsDataBindingAutomatic |
Veri bağlamanın otomatik olup olmadığını gösteren bir değer alır. (Devralındığı yer: BaseDataBoundControl) |
| IsEnabled |
Denetimin etkinleştirilip etkinleştirilmediğini belirten bir değer alır. (Devralındığı yer: WebControl) |
| IsTrackingViewState |
Sunucu denetiminin değişiklikleri görünüm durumuna kaydedip kaydetmediğini gösteren bir değer alır. (Devralındığı yer: Control) |
| IsUsingModelBinders |
Model bağlamanın kullanımda olup olmadığını gösteren bir değer alır. (Devralındığı yer: DataBoundControl) |
| IsViewStateEnabled |
Bu denetim için görünüm durumunun etkinleştirilip etkinleştirilmediğini gösteren bir değer alır. (Devralındığı yer: Control) |
| Items |
Liste denetimindeki öğe koleksiyonunu alır. (Devralındığı yer: ListControl) |
| ItemType |
Kesin olarak yazılan veri bağlama için veri öğesi türünün adını alır veya ayarlar. (Devralındığı yer: DataBoundControl) |
| LoadViewStateByID |
Denetimin dizin yerine görünüm durumunu ID yüklemeye katılıp katılmadığını gösteren bir değer alır. (Devralındığı yer: Control) |
| NamingContainer |
Aynı ID özellik değerine sahip sunucu denetimleri arasında ayrım yapmak için benzersiz bir ad alanı oluşturan sunucu denetiminin adlandırma kapsayıcısına başvuru alır. (Devralındığı yer: Control) |
| Page |
Sunucu denetimini içeren örneğe başvuru Page alır. (Devralındığı yer: Control) |
| Parent |
Sayfa denetimi hiyerarşisinde sunucu denetiminin üst denetimine başvuru alır. (Devralındığı yer: Control) |
| RenderingCompatibility |
HTML'nin uyumlu olacağı ASP.NET sürümünü belirten bir değer alır. (Devralındığı yer: Control) |
| RequiresDataBinding |
Yöntemin DataBind() çağrılıp çağrılmayacağını belirten bir değer alır veya ayarlar. (Devralındığı yer: BaseDataBoundControl) |
| SelectArguments |
DataSourceSelectArguments Veri kaynağı denetiminden veri alırken veri bağlama denetiminin kullandığı nesneyi alır. (Devralındığı yer: DataBoundControl) |
| SelectedIndex |
Denetimde seçili öğenin DropDownList dizinini alır veya ayarlar. |
| SelectedItem |
Liste denetiminde en düşük dizine sahip seçili öğeyi alır. (Devralındığı yer: ListControl) |
| SelectedValue |
Seçili öğenin değerini liste denetiminde alır veya liste denetiminde belirtilen değeri içeren öğeyi seçer. (Devralındığı yer: ListControl) |
| SelectMethod |
Verileri okumak için çağrılacak yöntemin adı. (Devralındığı yer: DataBoundControl) |
| Site |
Tasarım yüzeyinde işlendiğinde geçerli denetimi barındıran kapsayıcı hakkında bilgi alır. (Devralındığı yer: Control) |
| SkinID |
Denetime uygulanacak kaplamayı alır veya ayarlar. (Devralındığı yer: WebControl) |
| Style |
Web sunucusu denetiminin dış etiketinde stil özniteliği olarak işlenecek metin öznitelikleri koleksiyonunu alır. (Devralındığı yer: WebControl) |
| SupportsDisabledAttribute |
Denetimin özelliği |
| TabIndex |
Web sunucusu denetiminin sekme dizinini alır veya ayarlar. (Devralındığı yer: WebControl) |
| TagKey |
Denetimin HtmlTextWriterTag değerini ListControl alır. (Devralındığı yer: ListControl) |
| TagName |
Denetim etiketinin adını alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| TemplateControl |
Bu denetimi içeren şablona başvuru alır veya ayarlar. (Devralındığı yer: Control) |
| TemplateSourceDirectory |
geçerli sunucu denetimini içeren veya UserControl sanal dizinini Page alır. (Devralındığı yer: Control) |
| Text |
Denetimin SelectedValue özelliğini ListControl alır veya ayarlar. (Devralındığı yer: ListControl) |
| ToolTip |
Fare işaretçisi denetimin üzerinde bekletildiğinde görüntülenen Araç İpucu metnini alır veya ayarlar. |
| ToolTip |
Fare işaretçisi Web sunucusu denetiminin üzerine geldiğinde görüntülenen metni alır veya ayarlar. (Devralındığı yer: WebControl) |
| UniqueID |
Sunucu denetimi için benzersiz, hiyerarşik nitelenmiş tanımlayıcıyı alır. (Devralındığı yer: Control) |
| ValidateRequestMode |
Denetimin tarayıcıdan istemci girişini tehlikeli olabilecek değerler için denetlediğini gösteren bir değer alır veya ayarlar. (Devralındığı yer: Control) |
| ValidationGroup |
Sınıfından türetilen ListControl denetimin sunucuya geri gönderildiğinde doğrulamaya neden olduğu denetim grubunu alır veya ayarlar. (Devralındığı yer: ListControl) |
| ViewState |
Aynı sayfa için birden çok istekte bir sunucu denetiminin görünüm durumunu kaydetmenize ve geri yüklemenize olanak tanıyan durum bilgileri sözlüğü alır. (Devralındığı yer: Control) |
| ViewStateIgnoresCase |
Nesnenin StateBag büyük/küçük harfe duyarsız olup olmadığını gösteren bir değer alır. (Devralındığı yer: Control) |
| ViewStateMode |
Bu denetimin görünüm durumu modunu alır veya ayarlar. (Devralındığı yer: Control) |
| Visible |
Sunucu denetiminin sayfada kullanıcı arabirimi olarak işlenip işlenmediğini gösteren bir değer alır veya ayarlar. (Devralındığı yer: Control) |
| Width |
Web sunucusu denetiminin genişliğini alır veya ayarlar. (Devralındığı yer: WebControl) |
Yöntemler
| Name | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Belirtilen HtmlTextWriter nesneye işlenmesi gereken HTML öznitelikleri ve stilleri ekler. |
| AddedControl(Control, Int32) |
Nesne koleksiyonuna Controls bir alt denetim eklendikten sonra çağrılır Control . (Devralındığı yer: Control) |
| AddParsedSubObject(Object) |
Xml veya HTML gibi bir öğenin ayrıştırıldığını sunucu denetimine bildirir ve öğeyi sunucu denetiminin ControlCollection nesnesine ekler. (Devralındığı yer: Control) |
| ApplyStyle(Style) |
Belirtilen stilin boş olmayan öğelerini Web denetimine kopyalar ve denetimin varolan stil öğelerinin üzerine yazar. Bu yöntem öncelikli olarak denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| ApplyStyleSheetSkin(Page) |
Sayfa stili sayfasında tanımlanan stil özelliklerini denetime uygular. (Devralındığı yer: Control) |
| BeginRenderTracing(TextWriter, Object) |
İşleme verilerinin tasarım zamanı izlemeye başlar. (Devralındığı yer: Control) |
| BuildProfileTree(String, Boolean) |
Sunucu denetimi hakkında bilgi toplar ve sayfa için izleme etkinleştirildiğinde görüntülenecek özelliğe teslim eder Trace . (Devralındığı yer: Control) |
| ClearCachedClientID() |
Önbelleğe alınan ClientID değeri olarak |
| ClearChildControlState() |
Sunucu denetiminin alt denetimleri için denetim durumu bilgilerini siler. (Devralındığı yer: Control) |
| ClearChildState() |
Tüm sunucu denetiminin alt denetimleri için görünüm durumu ve denetim durumu bilgilerini siler. (Devralındığı yer: Control) |
| ClearChildViewState() |
Tüm sunucu denetiminin alt denetimleri için görünüm durumu bilgilerini siler. (Devralındığı yer: Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Geçerli denetim örneğinin ve alt denetimlerin özelliğini olarak Inheritayarlar. (Devralındığı yer: Control) |
| ClearSelection() |
Liste seçimini temizler ve tüm öğelerin özelliğini false olarak ayarlar Selected . (Devralındığı yer: ListControl) |
| ConfirmInitState() |
Veri bağlama denetiminin başlatılan durumunu ayarlar. (Devralındığı yer: BaseDataBoundControl) |
| CopyBaseAttributes(WebControl) |
Nesne tarafından Style kapsüllenmemiş özellikleri belirtilen Web sunucusu denetiminden bu yöntemin çağrıldığı Web sunucusu denetimine kopyalar. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| CreateChildControls() |
ASP.NET sayfa çerçevesi tarafından çağrılarak, geri gönderme veya işleme hazırlığında içerdikleri alt denetimleri oluşturmak üzere oluşturma tabanlı uygulama kullanan sunucu denetimlerini bilgilendirmek için kullanılır. (Devralındığı yer: Control) |
| CreateControlCollection() |
Alt denetimleri depolamak için bir koleksiyon oluşturur. |
| CreateControlStyle() |
Sınıf tarafından WebControl stille ilgili tüm özellikleri uygulamak için dahili olarak kullanılan stil nesnesini oluşturur. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| CreateDataSourceSelectArguments() |
Hiçbir bağımsız değişken belirtilmezse, veri bağlı denetimi tarafından kullanılan varsayılan DataSourceSelectArguments bir nesne oluşturur. (Devralındığı yer: DataBoundControl) |
| DataBind() |
Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine bağlar. (Devralındığı yer: Control) |
| DataBind() |
Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine bağlar. (Devralındığı yer: BaseDataBoundControl) |
| DataBind(Boolean) |
Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine olayı tetikle DataBinding seçeneğiyle bağlar. (Devralındığı yer: Control) |
| DataBindChildren() |
Bir veri kaynağını sunucu denetiminin alt denetimlerine bağlar. (Devralındığı yer: Control) |
| Dispose() |
Bir sunucu denetiminin bellekten çıkmadan önce son temizlemeyi gerçekleştirmesini sağlar. (Devralındığı yer: Control) |
| EndRenderTracing(TextWriter, Object) |
İşleme verilerinin tasarım zamanı izlemeyi sonlandırır. (Devralındığı yer: Control) |
| EnsureChildControls() |
Sunucu denetiminin alt denetimler içerip içermediğini belirler. Aksi takdirde alt denetimler oluşturur. (Devralındığı yer: Control) |
| EnsureDataBound() |
DataBind() Özellik ayarlanırsa ve veriye bağlı denetim bağlama gerektirecek şekilde işaretlenirse DataSourceID yöntemini çağırır. (Devralındığı yer: BaseDataBoundControl) |
| EnsureID() |
Atanmış tanımlayıcısı olmayan denetimler için bir tanımlayıcı oluşturur. (Devralındığı yer: Control) |
| Equals(Object) |
Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object) |
| FindControl(String, Int32) |
Geçerli adlandırma kapsayıcısında belirtilen ve parametresinde belirtilen |
| FindControl(String) |
Belirtilen |
| Focus() |
Giriş odağını bir denetime ayarlar. (Devralındığı yer: Control) |
| GetData() |
Veri bağlama denetiminin veri işlemlerini gerçekleştirmek için kullandığı bir DataSourceView nesneyi alır. (Devralındığı yer: DataBoundControl) |
| GetDataSource() |
IDataSource Varsa, veriye bağlı denetimin ilişkili olduğu arabirimi alır. (Devralındığı yer: DataBoundControl) |
| GetDesignModeState() |
Denetim için tasarım zamanı verilerini alır. (Devralındığı yer: Control) |
| GetHashCode() |
Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object) |
| GetRouteUrl(Object) |
Bir yol parametreleri kümesine karşılık gelen URL'yi alır. (Devralındığı yer: Control) |
| GetRouteUrl(RouteValueDictionary) |
Bir yol parametreleri kümesine karşılık gelen URL'yi alır. (Devralındığı yer: Control) |
| GetRouteUrl(String, Object) |
Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır. (Devralındığı yer: Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır. (Devralındığı yer: Control) |
| GetType() |
Geçerli örneğin Type alır. (Devralındığı yer: Object) |
| GetUniqueIDRelativeTo(Control) |
Belirtilen denetimin özelliğinin UniqueID ön ekli bölümünü döndürür. (Devralındığı yer: Control) |
| HasControls() |
Sunucu denetiminin alt denetimler içerip içermediğini belirler. (Devralındığı yer: Control) |
| HasEvents() |
Olayların denetim için mi yoksa alt denetimler için mi kaydedildiğini belirten bir değer döndürür. (Devralındığı yer: Control) |
| IsLiteralContent() |
Sunucu denetiminin yalnızca değişmez içeriği barındırdığını belirler. (Devralındığı yer: Control) |
| LoadControlState(Object) |
yöntemi tarafından SaveControlState() kaydedilen önceki sayfa isteğinden denetim durumu bilgilerini geri yükler. (Devralındığı yer: Control) |
| LoadPostData(String, NameValueCollection) |
Denetim için DropDownList geri gönderme verilerini işler. |
| LoadViewState(Object) |
Denetimin daha önce kaydedilmiş görünüm durumunu DetailsView yükler. (Devralındığı yer: ListControl) |
| MapPathSecure(String) |
Bir sanal yolun mutlak veya göreli olarak eşlenin fiziksel yolunu alır. (Devralındığı yer: Control) |
| MarkAsDataBound() |
Görünüm durumundaki denetimin durumunu verilere başarıyla bağlı olarak ayarlar. (Devralındığı yer: DataBoundControl) |
| MemberwiseClone() |
Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object) |
| MergeStyle(Style) |
Belirtilen stilin boş olmayan öğelerini Web denetimine kopyalar, ancak denetimin varolan stil öğelerinin üzerine yazmaz. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Sunucu denetimi olayının sayfanın UI sunucu denetimi hiyerarşisine geçirilip geçirilmeyeceğini belirler. (Devralındığı yer: Control) |
| OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) |
Olayı tetikler CreatingModelDataSource . (Devralındığı yer: DataBoundControl) |
| OnDataBinding(EventArgs) |
Olayı tetikler DataBinding . (Devralındığı yer: ListControl) |
| OnDataBound(EventArgs) |
Olayı tetikler DataBound . (Devralındığı yer: BaseDataBoundControl) |
| OnDataPropertyChanged() |
Temel veri kaynağı tanımlama özelliklerinden biri değiştikten sonra veriye bağlı denetimi verilerine yeniden bağlama. (Devralındığı yer: DataBoundControl) |
| OnDataSourceViewChanged(Object, EventArgs) |
Olayı tetikler DataSourceViewChanged . (Devralındığı yer: DataBoundControl) |
| OnInit(EventArgs) |
Olayı tetikler Init . (Devralındığı yer: Control) |
| OnInit(EventArgs) |
Olayı işler Init . (Devralındığı yer: BaseDataBoundControl) |
| OnLoad(EventArgs) |
Olayı tetikler Load . (Devralındığı yer: Control) |
| OnLoad(EventArgs) |
Olayı işler Load . (Devralındığı yer: DataBoundControl) |
| OnPagePreLoad(Object, EventArgs) |
Denetim yüklenmeden önce veriye bağlı denetimin başlatılan durumunu ayarlar. (Devralındığı yer: DataBoundControl) |
| OnPreRender(EventArgs) |
Olayı tetikler PreRender . (Devralındığı yer: ListControl) |
| OnSelectedIndexChanged(EventArgs) |
Olayı tetikler SelectedIndexChanged . Bu, olay için özel bir işleyici sağlamanıza olanak tanır. (Devralındığı yer: ListControl) |
| OnTextChanged(EventArgs) |
Olayı tetikler TextChanged . (Devralındığı yer: ListControl) |
| OnUnload(EventArgs) |
Olayı tetikler Unload . (Devralındığı yer: Control) |
| OpenFile(String) |
Stream Bir dosyayı okumak için kullanılan alır. (Devralındığı yer: Control) |
| PerformDataBinding(IEnumerable) |
Belirtilen veri kaynağını sınıfından türetilen denetime ListControl bağlar. (Devralındığı yer: ListControl) |
| PerformSelect() |
İlişkili veri kaynağından veri alır. (Devralındığı yer: ListControl) |
| RaiseBubbleEvent(Object, EventArgs) |
Olayın tüm kaynaklarını ve bilgilerini denetimin üst öğesine atar. (Devralındığı yer: Control) |
| RaisePostDataChangedEvent() |
Geri gönderme gerçekleştiğinde DropDownList denetim için olayları tetikler. |
| RemovedControl(Control) |
Nesne koleksiyonundan Controls bir alt denetim kaldırıldıktan sonra çağrılır Control . (Devralındığı yer: Control) |
| Render(HtmlTextWriter) |
Denetimi belirtilen HTML yazıcısına işler. (Devralındığı yer: WebControl) |
| RenderBeginTag(HtmlTextWriter) |
Denetimin HTML açma etiketini belirtilen yazıcıya işler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| RenderChildren(HtmlTextWriter) |
Sunucu denetiminin alt öğelerinin içeriğini, istemcide işlenecek içeriği yazan sağlanan HtmlTextWriter bir nesneye gönderir. (Devralındığı yer: Control) |
| RenderContents(HtmlTextWriter) |
Denetimin içeriğini belirtilen yazıcıya işler. |
| RenderContents(HtmlTextWriter) |
Denetimdeki ListControl öğeleri işler. (Devralındığı yer: ListControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Sağlanan bir nesneyi kullanarak sunucu denetimi içeriğini sağlanan HtmlTextWriterControlAdapter bir nesneye gönderir. (Devralındığı yer: Control) |
| RenderControl(HtmlTextWriter) |
Sunucu denetimi içeriğini sağlanan HtmlTextWriter bir nesneye gönderir ve izleme etkinse denetimle ilgili izleme bilgilerini depolar. (Devralındığı yer: Control) |
| RenderEndTag(HtmlTextWriter) |
Denetimin HTML kapanış etiketini belirtilen yazıcıya işler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır. (Devralındığı yer: WebControl) |
| ResolveAdapter() |
Belirtilen denetimin işlenmesinden sorumlu denetim bağdaştırıcısını alır. (Devralındığı yer: Control) |
| ResolveClientUrl(String) |
Tarayıcı tarafından kullanılabilecek bir URL alır. (Devralındığı yer: Control) |
| ResolveUrl(String) |
URL'yi istekte bulunan istemcide kullanılabilen url'ye dönüştürür. (Devralındığı yer: Control) |
| SaveControlState() |
Sayfanın sunucuya geri gönderildiği zamandan bu yana gerçekleşen tüm sunucu denetim durumu değişikliklerini kaydeder. (Devralındığı yer: Control) |
| SaveViewState() |
-derived denetiminin ListControl geçerli görünüm durumunu ve içerdiği öğeleri kaydeder. (Devralındığı yer: ListControl) |
| SetDesignModeState(IDictionary) |
Denetim için tasarım zamanı verilerini ayarlar. (Devralındığı yer: Control) |
| SetPostDataSelection(Int32) |
Selected Bir sayfa postalandıktan sonra denetimin ListItem özelliğini ayarlar. (Devralındığı yer: ListControl) |
| SetRenderMethodDelegate(RenderMethod) |
Sunucu denetimini ve içeriğini üst denetimine işlemek için bir olay işleyicisi temsilcisi atar. (Devralındığı yer: Control) |
| SetTraceData(Object, Object, Object) |
İzlenen nesneyi, izleme veri anahtarını ve izleme verisi değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar. (Devralındığı yer: Control) |
| SetTraceData(Object, Object) |
İzleme veri anahtarını ve izleme verisi değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar. (Devralındığı yer: Control) |
| ToString() |
Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object) |
| TrackViewState() |
Görünüm durumu değişikliklerini bir -derived denetimine izlemeye ve kaydetmeye başlamak için ListControl başlangıç noktasını işaretler. (Devralındığı yer: ListControl) |
| ValidateDataSource(Object) |
Veriye bağlı denetimin bağlanabildiği nesnenin çalışabileceği nesne olduğunu doğrular. (Devralındığı yer: DataBoundControl) |
| VerifyMultiSelect() |
Denetim için DropDownList birden çok seçim desteklenmediğinden her zaman bir HttpException özel durum oluşturur. |
Ekinlikler
| Name | Description |
|---|---|
| CallingDataMethods |
Veri yöntemleri çağrıldığında gerçekleşir. (Devralındığı yer: DataBoundControl) |
| CreatingModelDataSource |
Nesne oluşturulurken ModelDataSource gerçekleşir. (Devralındığı yer: DataBoundControl) |
| DataBinding |
Sunucu denetimi bir veri kaynağına bağlandığında gerçekleşir. (Devralındığı yer: Control) |
| DataBound |
Sunucu denetimi bir veri kaynağına bağlandıktan sonra gerçekleşir. (Devralındığı yer: BaseDataBoundControl) |
| Disposed |
ASP.NET sayfası istendiğinde sunucu denetimi yaşam döngüsünün son aşaması olan bellekten bir sunucu denetimi serbest bırakıldığında gerçekleşir. (Devralındığı yer: Control) |
| Init |
Sunucu denetimi başlatıldığında gerçekleşir ve bu, yaşam döngüsünün ilk adımıdır. (Devralındığı yer: Control) |
| Load |
Sunucu denetimi nesneye Page yüklendiğinde gerçekleşir. (Devralındığı yer: Control) |
| PreRender |
Nesne yüklendikten sonra Control ancak işlemeden önce gerçekleşir. (Devralındığı yer: Control) |
| SelectedIndexChanged |
Liste denetimindeki seçim, sunucuya yapılan gönderiler arasında değiştiğinde gerçekleşir. (Devralındığı yer: ListControl) |
| TextChanged |
ve SelectedValue özellikleri değiştiğinde Text gerçekleşir. (Devralındığı yer: ListControl) |
| Unload |
Sunucu denetimi bellekten kaldırıldığında gerçekleşir. (Devralındığı yer: Control) |
Belirtik Arabirim Kullanımları
Uzantı Metotları
| Name | Description |
|---|---|
| EnablePersistedSelection(BaseDataBoundControl) |
Geçersiz.
Seçimi ve sayfalandırmayı destekleyen veri denetimlerinde seçimin kalıcı olmasını sağlar. |
| FindDataSourceControl(Control) |
Belirtilen denetim için veri denetimiyle ilişkili veri kaynağını döndürür. |
| FindFieldTemplate(Control, String) |
Belirtilen denetimin adlandırma kapsayıcısında belirtilen sütun için alan şablonunu döndürür. |
| FindMetaTable(Control) |
İçeren veri denetimi için meta tablo nesnesini döndürür. |
