ListBox Sınıf

Tanım

Tek veya birden çok öğe seçimine izin veren bir liste kutusu denetimini temsil eder.

public ref class ListBox : System::Web::UI::WebControls::ListControl, System::Web::UI::IPostBackDataHandler
[System.Web.UI.ValidationProperty("SelectedItem")]
public class ListBox : System.Web.UI.WebControls.ListControl, System.Web.UI.IPostBackDataHandler
[<System.Web.UI.ValidationProperty("SelectedItem")>]
type ListBox = class
    inherit ListControl
    interface IPostBackDataHandler
Public Class ListBox
Inherits ListControl
Implements IPostBackDataHandler
Devralma
Devralma
Öznitelikler
Uygulamalar

Örnekler

Aşağıdaki örnekte bir denetimin nasıl oluşturulacağı gösterilmektedir ListBox .

<%@ 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>ListBox Example</title>
<script language="C#" runat="server">

      void SubmitBtn_Click(Object sender, EventArgs e) 
      {
         if (ListBox1.SelectedIndex > -1)
            Label1.Text="You chose: " + ListBox1.SelectedItem.Text;
      }

   </script>

</head>
<body>

   <h3>ListBox Example</h3>

   <form id="form1" runat="server">

      <asp:ListBox id="ListBox1" 
           Rows="6"
           Width="100px"
           SelectionMode="Single" 
           runat="server">

         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>

      </asp:ListBox>

      <asp:button id="Button1"
           Text="Submit" 
           OnClick="SubmitBtn_Click" 
           runat="server" />
        
      <asp:Label id="Label1" 
           Font-Names="Verdana" 
           Font-Size="10pt" 
           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>ListBox Example</title>
<script language="VB" runat="server">

    Sub SubmitBtn_Click(sender As Object, e As EventArgs)
        If ListBox1.SelectedIndex > - 1 Then
            Label1.Text = "You chose: " & ListBox1.SelectedItem.Text
        End If
    End Sub 'SubmitBtn_Click

  </script>

</head>
<body>

   <h3>ListBox Example</h3>

   <form id="form1" runat="server">

      <asp:ListBox id="ListBox1" 
           Rows="6"
           Width="100px"
           SelectionMode="Single" 
           runat="server">

         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>

      </asp:ListBox>

      <asp:button id="Button1"
           Text="Submit" 
           OnClick="SubmitBtn_Click" 
           runat="server" />
        
      <asp:Label id="Label1" 
           Font-Names="Verdana" 
           Font-Size="10pt" 
           runat="server"/>
        
   </form>

</body>
</html>

Aşağıdaki örnekte, birden çok seçimi destekleyen bir ListBox denetimin nasıl oluşturulacağı gösterilmektedir.

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <script language="C#" runat="server">

      void SubmitBtn_Click(Object sender, EventArgs e) 
      {
          string msg = "";
          foreach (ListItem li in ListBox1.Items)
          {
              if (li.Selected == true)
              {
                  msg += "<BR>" + li.Text + " is selected.";
              }
          }
          Label1.Text = msg;
      }

   </script>

</head>
<body>

   <h3>ListBox Example</h3>

   <form id="Form1" runat=server>

      <asp:ListBox id="ListBox1" 
           Rows="6"
           Width="100px"
           SelectionMode="Multiple" 
           runat="server">

         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>

      </asp:ListBox>

      <asp:button id="Button1"
           Text="Submit" 
           OnClick="SubmitBtn_Click" 
           runat="server" />
        
      <asp:Label id="Label1" 
           Font-Name="Verdana" 
           Font-Size="10pt" 
           runat="server"/>
        
   </form>

</body>
</html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <script language="VB" runat="server">

    Sub SubmitBtn_Click(sender As Object, e As EventArgs)
            Dim msg As String
            Dim li As ListItem
            msg = ""
            For Each li In ListBox1.Items
                If li.Selected = True Then
                    msg = msg & "<br>" & li.Text & " selected."
                End If
            Next
            Label1.Text = msg
    End Sub 'SubmitBtn_Click

  </script>

</head>
<body>

   <h3>ListBox Example</h3>

   <form id="Form1" runat=server>

      <asp:ListBox id="ListBox1" 
           Rows="6"
           Width="100px"
           SelectionMode="Multiple" 
           runat="server">

         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>

      </asp:ListBox>

      <asp:button id="Button1"
           Text="Submit" 
           OnClick="SubmitBtn_Click" 
           runat="server" />
        
      <asp:Label id="Label1" 
           Font-Name="Verdana" 
           Font-Size="10pt" 
           runat="server"/>
        
   </form>

</body>
</html>

Aşağıdaki örnekte, veri bağlama aracılığıyla bir ListBox denetimin nasıl oluşturulacağı gösterilmektedir.

<%@ 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>Data Binding ListBox</title>
<script language="C#" runat="server">

      void Page_Load(Object sender, EventArgs e) 
      {

         if (!IsPostBack) 
         {

            ArrayList values = new ArrayList();

            values.Add ("Item 1");
            values.Add ("Item 2");
            values.Add ("Item 3");
            values.Add ("Item 4");
            values.Add ("Item 5");
            values.Add ("Item 6");

            ListBox1.DataSource = values;
            ListBox1.DataBind();

         }

      }

      void SubmitBtn_Click(Object sender, EventArgs e) 
      {
      
         if ( ListBox1.SelectedIndex > -1 )
            Label1.Text = "You chose: " + ListBox1.SelectedItem.Text;
         
      }

   </script>

</head>
<body>

   <form id="form1" runat="server">

        <h3>Data Binding ListBox</h3>
    
        <asp:ListBox id="ListBox1" 
             Width="100px" 
             runat="server"/>

        <asp:button id="Button1"
             Text="Submit" 
             OnClick="SubmitBtn_Click" 
             runat="server" />
        
        <asp:Label id="Label1" 
             Font-Names="Verdana" 
             font-size="10pt" 
             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>Data Binding ListBox</title>
<script language="VB" runat="server">

    Sub Page_Load(sender As Object, e As EventArgs)
        
        If Not IsPostBack Then
            
            Dim values As New ArrayList()
            
            values.Add("Item 1")
            values.Add("Item 2")
            values.Add("Item 3")
            values.Add("Item 4")
            values.Add("Item 5")
            values.Add("Item 6")
            
            ListBox1.DataSource = values
            ListBox1.DataBind()
        End If 
    End Sub 'Page_Load

    Sub SubmitBtn_Click(sender As Object, e As EventArgs)
        
        If ListBox1.SelectedIndex > - 1 Then
            Label1.Text = "You chose: " & ListBox1.SelectedItem.Text
        End If 
    End Sub 'SubmitBtn_Click

  </script>

</head>
<body>

   <form id="form1" runat="server">

        <h3>Data Binding ListBox</h3>
    
        <asp:ListBox id="ListBox1" 
             Width="100px" 
             runat="server"/>

        <asp:button id="Button1"
             Text="Submit" 
             OnClick="SubmitBtn_Click" 
             runat="server" />
        
        <asp:Label id="Label1" 
             Font-Names="Verdana" 
             font-size="10pt" 
             runat="server"/>

   </form>

</body>
</html>

Açıklamalar

Bu konuda:

Giriş

ListBox Tek veya birden çok öğe seçimine izin veren bir liste denetimi oluşturmak için denetimi kullanın. Denetimin Rows yüksekliğini belirtmek için özelliğini kullanın. Birden çok öğe seçimini etkinleştirmek için özelliğini olarak ListSelectionMode.MultipleayarlayınSelectionMode.

Denetimde görünmesini istediğiniz öğeleri belirtmek için, denetimin ListBox açma ve kapatma etiketleri ListBox arasına her giriş için bir ListItem öğe yerleştirin.

Denetimde Items yer alan ListBox nesneleri incelemek ListItem için koleksiyonunu kullanın. Örneğin, koleksiyonu numaralandırıp her ListItem öğe için değeri test ederek denetimdeki ListBoxItemsSelected seçili öğeleri belirleyebilirsiniz.

Denetim ListBox , veri bağlamayı da destekler. Denetimi bir veri kaynağına bağlamak için, önce denetimde görüntülenecek öğeleri içeren nesnelerden DataSourceControl biri gibi bir veri kaynağı oluşturun. Ardından, veri kaynağını denetime bağlamak için ListBox yöntemini kullanınDataBind. Denetimdeki her liste öğesinin DataTextField sırasıyla ve özelliklerine veri kaynağında hangi alanın bağlanacağını belirtmek için Text ve DataValueFieldValue özelliklerini kullanın. Denetim ListBox şimdi veri kaynağındaki bilgileri görüntüler.

Dikkat

Bu denetim, kötü amaçlı istemci betiği içerebilecek kullanıcı girişini görüntülemek için kullanılabilir. Uygulamanızda görüntülemeden önce bir istemciden yürütülebilir betik, SQL deyimleri veya başka bir kod için gönderilen tüm bilgileri denetleyin. Denetimde giriş metnini görüntülemeden önce kullanıcı girişini doğrulamak için doğrulama denetimlerini kullanabilirsiniz. ASP.NET, kullanıcı girişinde betiği ve HTML'yi engellemek için bir giriş isteği doğrulama özelliği sağlar. Daha fazla bilgi için bkz. Standart Denetimlerin Güvenliğini Sağlama, Nasıl yapılır: Dizelere HTML Kodlaması Uygulayarak ve ASP.NET Web Sayfalarında Kullanıcı Girişini Doğrulayarak Web Uygulamasında Betik Açıklarından Yararlanmaya Karşı Koruma.

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, ASP.NET ve ASP.NET Denetimleri ve Erişilebilirlik.

Tanımlayıcı Sözdizimi

<asp:ListBox  
    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"  
    Rows="integer"  
    runat="server"  
    SelectedIndex="integer"  
    SelectedValue="string"  
    SelectionMode="Single|Multiple"  
    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:ListBox>  

Oluşturucular

ListBox()

ListBox sınıfının yeni bir örneğini başlatır.

Özellikler

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 belirten 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şisindeki belirtilen sunucu denetimi için alt denetimleri temsil eden bir nesnesi 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 bir başvuru alır.

(Devralındığı yer: Control)
DataKeysContainer

Adlandırma kapsayıcısı uygularsa IDataKeysControladlandırma kapsayıcısına bir başvuru alır.

(Devralındığı yer: Control)
DataMember

denetimine bağlanmak 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

Veriye bağlı denetimin 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 uygulanmayacağı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 getirmek olmadığı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 okunur durumdadır.

(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 öznitelikleri ayarlanıp ayarlanmadığı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 program tanımlayıcısını 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

Veriye bağlı denetimin 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 denetim içindeki denetimlerin denetim durumuna sahip olup olmadığını belirten 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 belirten 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ğlaması 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ı belirten bir değer alır.

(Devralındığı yer: Control)
NamingContainer

Aynı ö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 ID 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şisindeki 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)
Rows

Denetimde ListBox görüntülenen satır sayısını alır veya ayarlar.

SelectArguments

Veriye bağlı denetimin bir DataSourceSelectArguments veri kaynağı denetiminden veri alırken kullandığı nesneyi alır.

(Devralındığı yer: DataBoundControl)
SelectedIndex

Listedeki seçili öğelerin en düşük sıralı dizinini alır veya ayarlar.

(Devralındığı yer: ListControl)
SelectedItem

Liste denetiminde en düşük dizine sahip seçili öğeyi alır.

(Devralındığı yer: ListControl)
SelectedValue

Liste denetiminde seçili öğenin değerini alır veya liste denetiminde belirtilen değeri içeren öğeyi seçer.

(Devralındığı yer: ListControl)
SelectionMode

Denetimin seçim modunu ListBox alır veya ayarlar.

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 falseolduğundaIsEnabled, denetimin işlenen HTML öğesinin özniteliğini "devre dışı" olarak ayarlayıp ayarlamayacağını disabled belirten bir değer alır.

(Devralındığı yer: WebControl)
SupportsDisabledAttribute

Denetimin özelliği falseolduğundaIsEnabled, denetimin işlenen HTML öğesinin özniteliğini "devre dışı" olarak ayarlayıp ayarlamayacağını disabled belirten bir değer alır.

(Devralındığı yer: BaseDataBoundControl)
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 ToolTip 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 olarak 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 belirten 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 duyarlı 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 belirten 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

AddAttributesToRender(HtmlTextWriter)

İşlenmek üzere öznitelik listesine , size, multipleve onchange eklername.

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 nullayarlar.

(Devralındığı yer: Control)
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()

Veriye bağlı denetimin başlatılmış durumunu ayarlar.

(Devralındığı yer: BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Nesne tarafından Style kapsüllenmeyen ö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, geri gönderme veya işleme hazırlığında içerdikleri alt denetimleri oluşturmak üzere birleşim tabanlı uygulama kullanan sunucu denetimlerini bilgilendirmek için çağrılır.

(Devralındığı yer: Control)
CreateControlCollection()

Sunucu denetiminin alt denetimlerini (hem değişmez değer hem de sunucu) tutmak için yeni ControlCollection bir nesne oluşturur.

(Devralındığı yer: Control)
CreateControlStyle()

Stille ilgili tüm özellikleri uygulamak için sınıf tarafından WebControl 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, veriye bağlı denetim 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()

Sunucu denetiminin bellekten serbest bırakılmadan önce son temizleme işlemini gerçekleştirmesini sağlar.

(Devralındığı yer: Control)
EndRenderTracing(TextWriter, Object)

İşleme verilerinin tasarım zamanı izlemesini 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şaretlenmişse 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)

Belirtilen id parametreyle geçerli adlandırma kapsayıcısında bir sunucu denetimi arar.

(Devralındığı yer: Control)
FindControl(String, Int32)

Geçerli adlandırma kapsayıcısında belirtilen ve parametresinde belirtilen id bir tamsayı ile bir sunucu denetimi arar ve bu da pathOffset aramaya yardımcı olur. Yöntemin bu sürümünü FindControl geçersiz kılmamalısınız.

(Devralındığı yer: Control)
Focus()

Giriş odağını bir denetime ayarlar.

(Devralındığı yer: Control)
GetData()

Veriye bağlı denetimin 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)
GetSelectedIndices()

Denetimde seçili durumdaki öğeler için dizin değerleri dizisini ListBox alır.

GetType()

Type Geçerli örneğini 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 gösteren bir değer döndürür.

(Devralındığı yer: Control)
IsLiteralContent()

Sunucu denetiminin yalnızca değişmez değer içeriğini barındırdığını belirler.

(Devralındığı yer: Control)
LoadControlState(Object)

yöntemi tarafından SaveControlState() kaydedilen önceki bir sayfa isteğinden denetim durumu bilgilerini geri yükler.

(Devralındığı yer: Control)
LoadPostData(String, NameValueCollection)

Liste denetiminin son deftere nakilden farklıysa, deftere nakledilen içeriğini yükler.

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şlene olduğu fiziksel yolu 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 Objectöğesinin sığ 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 yazılmaz. 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 denetim 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 ekler.

(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ılmış durumunu ayarlar.

(Devralındığı yer: DataBoundControl)
OnPreRender(EventArgs)

İstemcide ListBox işlemeden önce denetimi yapılandırıyor.

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()

Denetim için OnSelectedIndexChanged(EventArgs) gönderilen veriler her değiştiğinde ListBox yöntemini çağırır.

RemovedControl(Control)

Alt denetim nesne koleksiyonundan Controls 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 sağlanan bir HtmlTextWriter nesneye aktarır ve istemcide işlenecek içeriği yazar.

(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)

Sunucu denetimi içeriğini sağlanan HtmlTextWriter bir nesneye aktarır ve izleme etkinse denetimle ilgili izleme bilgilerini depolar.

(Devralındığı yer: Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Sağlanan bir nesneyi kullanarak sağlanan HtmlTextWriter bir nesneye sunucu denetimi içeriği çıkışı sağlar ControlAdapter .

(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 bir 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()

Türetilmiş denetimin 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)

Bir sayfa deftere Selected nakledildikten 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)

İ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)
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)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
TrackViewState()

Görünüm durumu değişikliklerini izlemeye ve kaydetmeye başlamak için başlangıç noktasını türetilmiş denetime ListControl işaretler.

(Devralındığı yer: ListControl)
ValidateDataSource(Object)

Veriye bağlı denetimin bağlanabileceği nesnenin çalışabileceği nesne olduğunu doğrular.

(Devralındığı yer: DataBoundControl)
VerifyMultiSelect()

Liste denetiminin çok bölümlü modu destekleyip desteklemediğini belirler.

(Devralındığı yer: ListControl)

Ekinlikler

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ı

IAttributeAccessor.GetAttribute(String)

Belirtilen ada sahip Web denetiminin özniteliğini alır.

(Devralındığı yer: WebControl)
IAttributeAccessor.SetAttribute(String, String)

Web denetiminin özniteliğini belirtilen ada ve değere ayarlar.

(Devralındığı yer: WebControl)
IControlBuilderAccessor.ControlBuilder

Bu üyenin açıklaması için bkz ControlBuilder. .

(Devralındığı yer: Control)
IControlDesignerAccessor.GetDesignModeState()

Bu üyenin açıklaması için bkz GetDesignModeState(). .

(Devralındığı yer: Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Bu üyenin açıklaması için bkz SetDesignModeState(IDictionary). .

(Devralındığı yer: Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Bu üyenin açıklaması için bkz SetOwnerControl(Control). .

(Devralındığı yer: Control)
IControlDesignerAccessor.UserData

Bu üyenin açıklaması için bkz UserData. .

(Devralındığı yer: Control)
IDataBindingsAccessor.DataBindings

Bu üyenin açıklaması için bkz DataBindings. .

(Devralındığı yer: Control)
IDataBindingsAccessor.HasDataBindings

Bu üyenin açıklaması için bkz HasDataBindings. .

(Devralındığı yer: Control)
IExpressionsAccessor.Expressions

Bu üyenin açıklaması için bkz Expressions. .

(Devralındığı yer: Control)
IExpressionsAccessor.HasExpressions

Bu üyenin açıklaması için bkz HasExpressions. .

(Devralındığı yer: Control)
IParserAccessor.AddParsedSubObject(Object)

Bu üyenin açıklaması için bkz AddParsedSubObject(Object). .

(Devralındığı yer: Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Liste denetiminin son deftere nakilden farklıysa, deftere nakledilen içeriğini yükler.

IPostBackDataHandler.RaisePostDataChangedEvent()

Denetim için OnSelectedIndexChanged(EventArgs) gönderilen veriler her değiştiğinde ListBox yöntemini çağırır.

Uzantı Metotları

EnablePersistedSelection(BaseDataBoundControl)
Geçersiz.

Seçimi ve disk belleğini 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 metatablo nesnesini döndürür.

Şunlara uygulanır

Ayrıca bkz.