DropDownList Třída

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Představuje ovládací prvek, který uživateli umožňuje vybrat jednu položku z rozevíracího seznamu.

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 IPostBackDataHandler

Public Class DropDownList
Inherits ListControl
Implements IPostBackDataHandler

Dědičnost: Object

Control

WebControl

ListControl
DropDownList

Dědičnost: Object

Control

WebControl

BaseDataBoundControl

DataBoundControl

ListControl
DropDownList

Atributy: ValidationPropertyAttribute

Implementuje: IPostBackDataHandler

Příklady

Následující příklad kódu ukazuje, jak vytvořit DropDownList ovládací prvek, který obsahuje čtyři položky.

<%@ 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>

Následující příklad kódu ukazuje, jak vytvořit DropDownList ovládací prvek přes datovou vazbu.

<%@ 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>

Poznámky

V tomto článku:

Introduction
Přístupnost
Deklarativní syntaxe

Introduction

DropDownList Ovládací prvek slouží k vytvoření ovládacího prvku rozevíracího seznamu s jedním výběrem. Vzhled ovládacího prvku můžete řídit DropDownList nastavením BorderColorovládacího prvku , BorderStylea BorderWidth vlastností.

Chcete-li určit položky, které se mají v ovládacím DropDownList prvku zobrazit, umístěte ListItem objekt pro každou položku mezi levou a pravou značkou DropDownList ovládacího prvku.

Ovládací DropDownList prvek také podporuje datová vazba. Chcete-li vytvořit vazbu ovládacího prvku na zdroj dat, vytvořte zdroj dat, například System.Collections.ArrayList objekt, který obsahuje položky, které se mají v ovládacím prvku zobrazit. Pak použijte metodu Control.DataBind k vytvoření vazby zdroje dat k ovládacímu DropDownList prvku.

SelectedIndex Pomocí vlastnosti můžete programově určit index položky vybrané uživatelem DropDownList z ovládacího prvku. Index se pak dá použít k načtení vybrané položky z Items kolekce ovládacího prvku.

Přístupnost

Informace o tom, jak tento ovládací prvek nakonfigurovat tak, aby vygeneroval značky odpovídající standardům přístupnosti, najdete v tématu Přístupnost v sadě Visual Studio a ASP.NET a ASP.NET ovládací prvky a přístupnost.

Deklarativní syntaxe

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

Konstruktory

Name	Description
DropDownList()	Inicializuje novou instanci DropDownList třídy.

Vlastnosti

Name	Description
AccessKey	Získá nebo nastaví přístupový klíč, který umožňuje rychle přejít na ovládací prvek webového serveru. (Zděděno od WebControl)
Adapter	Získá adaptér specifický pro prohlížeč pro ovládací prvek. (Zděděno od Control)
AppendDataBoundItems	Získá nebo nastaví hodnotu, která určuje, zda jsou položky seznamu vymazány před datovou vazbou. (Zděděno od ListControl)
AppRelativeTemplateSourceDirectory	Získá nebo nastaví relativní virtuální adresář Page aplikace nebo UserControl objektu, který obsahuje tento ovládací prvek. (Zděděno od Control)
Attributes	Získá kolekci libovolných atributů (pouze pro vykreslování), které neodpovídají vlastnostem ovládacího prvku. (Zděděno od WebControl)
AutoPostBack	Získá nebo nastaví hodnotu určující, zda postback na server automaticky nastane, když uživatel změní výběr seznamu. (Zděděno od ListControl)
BackColor	Získá nebo nastaví barvu pozadí ovládacího prvku webového serveru. (Zděděno od WebControl)
BindingContainer	Získá ovládací prvek, který obsahuje datovou vazbu tohoto ovládacího prvku. (Zděděno od Control)
BorderColor	Získá nebo nastaví barvu ohraničení ovládacího prvku.
BorderStyle	Získá nebo nastaví styl ohraničení ovládacího prvku.
BorderWidth	Získá nebo nastaví šířku ohraničení ovládacího prvku.
CausesValidation	Získá nebo nastaví hodnotu určující, zda je provedeno ověření při ovládací prvek odvozený z ListControl třídy je kliknut. (Zděděno od ListControl)
ChildControlsCreated	Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClientID	Získá ID ovládacího prvku pro kód HTML, který je generován ASP.NET. (Zděděno od Control)
ClientIDMode	Získá nebo nastaví algoritmus, který se používá k vygenerování hodnoty ClientID vlastnosti. (Zděděno od Control)
ClientIDSeparator	Získá hodnotu znaku představující oddělovač znak použitý ve ClientID vlastnosti. (Zděděno od Control)
Context	HttpContext Získá objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek. (Zděděno od Control)
Controls	ControlCollection Získá objekt, který představuje podřízené ovládací prvky pro zadaný server ovládací prvek v hierarchii uživatelského rozhraní. (Zděděno od Control)
ControlStyle	Získá styl ovládacího prvku webového serveru. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebControl)
ControlStyleCreated	Získá hodnotu určující, zda Style objekt byl vytvořen pro ControlStyle vlastnost. Tuto vlastnost primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl)
CssClass	Získá nebo nastaví cascading style sheet (CSS) třídy vykreslované ovládacím prvkem webového serveru v klientovi. (Zděděno od WebControl)
DataItemContainer	Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataItemContainer. (Zděděno od Control)
DataKeysContainer	Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataKeysControl. (Zděděno od Control)
DataMember	Získá nebo nastaví konkrétní tabulku v DataSource vazbu k ovládacímu prvku. (Zděděno od ListControl)
DataSource	Získá nebo nastaví zdroj dat, který naplní položky ovládacího prvku seznamu. (Zděděno od ListControl)
DataSourceID	Získá nebo nastaví ID ovládacího prvku, ze kterého ovládací prvek vázané na data načte seznam datových položek. (Zděděno od DataBoundControl)
DataSourceObject	Získá objekt, který implementuje IDataSource rozhraní, který poskytuje přístup k datovému obsahu objektu. (Zděděno od DataBoundControl)
DataTextField	Získá nebo nastaví pole zdroje dat, který poskytuje textový obsah položek seznamu. (Zděděno od ListControl)
DataTextFormatString	Získá nebo nastaví formátovací řetězec použitý k řízení způsobu zobrazení dat vázaných na ovládací prvek seznamu. (Zděděno od ListControl)
DataValueField	Získá nebo nastaví pole zdroje dat, které poskytuje hodnotu každé položky seznamu. (Zděděno od ListControl)
DesignMode	Získá hodnotu určující, zda se ovládací prvek používá na návrhové ploše. (Zděděno od Control)
Enabled	Získá nebo nastaví hodnotu určující, zda je ovládací prvek webového serveru povolen. (Zděděno od WebControl)
EnableTheming	Získá nebo nastaví hodnotu označující, zda motivy platí pro tento ovládací prvek. (Zděděno od WebControl)
EnableViewState	Získá nebo nastaví hodnotu určující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, do žádajícího klienta. (Zděděno od Control)
Events	Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen ke čtení. (Zděděno od Control)
Font	Získá vlastnosti písma přidružené k webovému serveru ovládacího prvku. (Zděděno od WebControl)
ForeColor	Získá nebo nastaví barvu popředí (obvykle barvu textu) ovládacího prvku webového serveru. (Zděděno od WebControl)
HasAttributes	Získá hodnotu určující, zda ovládací prvek má nastaveny atributy. (Zděděno od WebControl)
HasChildViewState	Získá hodnotu určující, zda aktuální serverový ovládací prvky podřízené ovládací prvky mají jakékoli uložené nastavení stavu zobrazení. (Zděděno od Control)
Height	Získá nebo nastaví výšku ovládacího prvku webového serveru. (Zděděno od WebControl)
ID	Získá nebo nastaví programový identifikátor přiřazený ovládacímu prvku serveru. (Zděděno od Control)
IdSeparator	Získá znak použitý k oddělení identifikátorů ovládacích prvků. (Zděděno od Control)
Initialized	Získá hodnotu určující, zda byl inicializován ovládací prvek vázané na data. (Zděděno od BaseDataBoundControl)
IsBoundUsingDataSourceID	Získá hodnotu určující, zda DataSourceID je vlastnost nastavena. (Zděděno od BaseDataBoundControl)
IsChildControlStateCleared	Získá hodnotu určující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav ovládacího prvku. (Zděděno od Control)
IsDataBindingAutomatic	Získá hodnotu, která označuje, zda je datová vazba automatická. (Zděděno od BaseDataBoundControl)
IsEnabled	Získá hodnotu označující, zda je ovládací prvek povolen. (Zděděno od WebControl)
IsTrackingViewState	Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do jeho stavu zobrazení. (Zděděno od Control)
IsUsingModelBinders	Získá hodnotu, která určuje, zda se používá vazba modelu. (Zděděno od DataBoundControl)
IsViewStateEnabled	Získá hodnotu označující, zda je pro tento ovládací prvek povolen stav zobrazení. (Zděděno od Control)
Items	Získá kolekci položek v ovládacím prvku seznam. (Zděděno od ListControl)
ItemType	Získá nebo nastaví název datové položky typu silného typu dat vazby. (Zděděno od DataBoundControl)
LoadViewStateByID	Získá hodnotu určující, zda se ovládací prvek účastní načítání jeho stavu zobrazení namísto ID indexu. (Zděděno od Control)
NamingContainer	Získá odkaz na kontejner pojmenování ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro odlišné mezi serverovými ovládacími prvky se stejnou ID hodnotou vlastnosti. (Zděděno od Control)
Page	Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek. (Zděděno od Control)
Parent	Získá odkaz na nadřazený ovládací prvek ovládacího prvku serveru v hierarchii ovládacích prvků stránky. (Zděděno od Control)
RenderingCompatibility	Získá hodnotu, která určuje ASP.NET verzi, která vykreslený KÓD HTML bude kompatibilní s. (Zděděno od Control)
RequiresDataBinding	Získá nebo nastaví hodnotu určující, zda DataBind() metoda má být volána. (Zděděno od BaseDataBoundControl)
SelectArguments	DataSourceSelectArguments Získá objekt, který ovládací prvek vázané na data používá při načítání dat z ovládacího prvku zdroje dat. (Zděděno od DataBoundControl)
SelectedIndex	Získá nebo nastaví index vybrané položky v ovládacím DropDownList prvku.
SelectedItem	Získá vybranou položku s nejnižším indexem v ovládacím prvku seznamu. (Zděděno od ListControl)
SelectedValue	Získá hodnotu vybrané položky v ovládacím prvku seznam nebo vybere položku v ovládacím prvku seznamu, který obsahuje zadanou hodnotu. (Zděděno od ListControl)
SelectMethod	Název metody, která se má volat za účelem čtení dat. (Zděděno od DataBoundControl)
Site	Získá informace o kontejneru, který je hostitelem aktuálního ovládacího prvku při vykreslení na návrhové ploše. (Zděděno od Control)
SkinID	Získá nebo nastaví kůži, která se použije na ovládací prvek. (Zděděno od WebControl)
Style	Získá kolekci text atributy, které budou vykresleny jako atribut stylu na vnější značce webového serveru ovládacího prvku. (Zděděno od WebControl)
SupportsDisabledAttribute	Získá hodnotu, která určuje, zda ovládací prvek má nastavit `disabled` atribut vykresleného HTML elementu na "zakázáno" při vlastnosti ovládacího prvku IsEnabled je `false`.
TabIndex	Získá nebo nastaví index karty ovládacího prvku webového serveru. (Zděděno od WebControl)
TagKey	HtmlTextWriterTag Získá hodnotu pro ListControl ovládací prvek. (Zděděno od ListControl)
TagName	Získá název značky ovládacího prvku. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebControl)
TemplateControl	Získá nebo nastaví odkaz na šablonu, která obsahuje tento ovládací prvek. (Zděděno od Control)
TemplateSourceDirectory	Získá virtuální adresář Page nebo UserControl který obsahuje aktuální server řízení. (Zděděno od Control)
Text	Získá nebo nastaví SelectedValue vlastnost ListControl ovládacího prvku. (Zděděno od ListControl)
ToolTip	Získá nebo nastaví text popisu zobrazený při umístění ukazatele myši nad ovládací prvek.
ToolTip	Získá nebo nastaví text zobrazený, když ukazatel myši najede myší na ovládací prvek webového serveru. (Zděděno od WebControl)
UniqueID	Získá jedinečný hierarchicky kvalifikovaný identifikátor pro ovládací prvek serveru. (Zděděno od Control)
ValidateRequestMode	Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek kontroluje vstup klienta z prohlížeče pro potenciálně nebezpečné hodnoty. (Zděděno od Control)
ValidationGroup	Získá nebo nastaví skupinu ovládacích prvků, pro které ovládací prvek odvozený z ListControl třídy způsobí ověření, když publikuje zpět na server. (Zděděno od ListControl)
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení ovládacího prvku serveru napříč několika požadavky na stejnou stránku. (Zděděno od Control)
ViewStateIgnoresCase	Získá hodnotu, která určuje, zda StateBag objekt nerozlišuje malá a velká písmena. (Zděděno od Control)
ViewStateMode	Získá nebo nastaví režim zobrazení-stav tohoto ovládacího prvku. (Zděděno od Control)
Visible	Získá nebo nastaví hodnotu, která určuje, zda je serverový ovládací prvek vykreslen jako uživatelské rozhraní na stránce. (Zděděno od Control)
Width	Získá nebo nastaví šířku ovládacího prvku webového serveru. (Zděděno od WebControl)

Metody

Name	Description
AddAttributesToRender(HtmlTextWriter)	Přidá atributy a styly HTML, které je potřeba vykreslit do zadaného HtmlTextWriter objektu.
AddedControl(Control, Int32)	Volá se po přidání podřízeného ovládacího prvku do Controls kolekce objektu Control . (Zděděno od Control)
AddParsedSubObject(Object)	Upozorní serverový ovládací prvek, že byl analyzován element XML nebo HTML a přidá prvek do objektu ControlCollection ovládacího prvku serveru. (Zděděno od Control)
ApplyStyle(Style)	Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku a přepíše všechny existující prvky stylu ovládacího prvku. Tuto metodu primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl)
ApplyStyleSheetSkin(Page)	Použije vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek. (Zděděno od Control)
BeginRenderTracing(TextWriter, Object)	Začíná trasování doby návrhu vykreslovacích dat. (Zděděno od Control)
BuildProfileTree(String, Boolean)	Shromažďuje informace o ovládacím prvku serveru a doručuje ho Trace vlastnosti, která se má zobrazit při povolení trasování stránky. (Zděděno od Control)
ClearCachedClientID()	Nastaví hodnotu uloženou ClientID v mezipaměti na `null`hodnotu . (Zděděno od Control)
ClearChildControlState()	Odstraní informace o stavu řízení pro podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClearChildState()	Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClearChildViewState()	Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClearEffectiveClientIDMode()	ClientIDMode Nastaví vlastnost aktuální instance ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control)
ClearSelection()	Vymaže výběr seznamu a nastaví Selected vlastnost všech položek na false. (Zděděno od ListControl)
ConfirmInitState()	Nastaví inicializovaný stav ovládacího prvku vázaného na data. (Zděděno od BaseDataBoundControl)
CopyBaseAttributes(WebControl)	Zkopíruje vlastnosti, které nejsou zapouzdřeny objektem Style ze zadaného ovládacího prvku webového serveru do ovládacího prvku webového serveru, ze kterého je tato metoda volána. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl)
CreateChildControls()	Volal ASP.NET stránkovací rámec, který informuje serverové ovládací prvky, které používají implementaci založenou na složení k vytvoření podřízených ovládacích prvků, které obsahují při přípravě na publikování zpět nebo vykreslování. (Zděděno od Control)
CreateControlCollection()	Vytvoří kolekci pro ukládání podřízených ovládacích prvků.
CreateControlStyle()	Vytvoří objekt stylu, který je interně WebControl používán třídou k implementaci všech vlastností souvisejících se stylem. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl)
CreateDataSourceSelectArguments()	Vytvoří výchozí DataSourceSelectArguments objekt, který používá ovládací prvek vázané na data, pokud nejsou zadány žádné argumenty. (Zděděno od DataBoundControl)
DataBind()	Vytvoří vazbu zdroje dat na vyvolaný ovládací prvek serveru a všechny jeho podřízené ovládací prvky. (Zděděno od Control)
DataBind()	Vytvoří vazbu zdroje dat na vyvolaný ovládací prvek serveru a všechny jeho podřízené ovládací prvky. (Zděděno od BaseDataBoundControl)
DataBind(Boolean)	Vytvoří vazbu zdroje dat na vyvolaný serverový ovládací prvek a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost. (Zděděno od Control)
DataBindChildren()	Vytvoří vazbu zdroje dat k podřízeným ovládacím prvkům ovládacího prvku serveru. (Zděděno od Control)
Dispose()	Umožňuje ovládacímu prvku serveru provést konečné vyčištění před uvolněním z paměti. (Zděděno od Control)
EndRenderTracing(TextWriter, Object)	Ukončí trasování vykreslování dat v době návrhu. (Zděděno od Control)
EnsureChildControls()	Určuje, zda ovládací prvek serveru obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky. (Zděděno od Control)
EnsureDataBound()	Volá metodu DataBind()DataSourceID , pokud je vlastnost nastavena a ovládací prvek vázané na data je označen k vyžadování vazby. (Zděděno od BaseDataBoundControl)
EnsureID()	Vytvoří identifikátor pro ovládací prvky, které nemají přiřazený identifikátor. (Zděděno od Control)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
FindControl(String, Int32)	Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným `id` a celé číslo zadané v parametru `pathOffset` , který pomáhá při hledání. Tuto verzi FindControl metody byste neměli přepsat. (Zděděno od Control)
FindControl(String)	Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným `id` parametrem. (Zděděno od Control)
Focus()	Nastaví vstupní fokus na ovládací prvek. (Zděděno od Control)
GetData()	DataSourceView Načte objekt, který ovládací prvek vázaný na data používá k provádění datových operací. (Zděděno od DataBoundControl)
GetDataSource()	Načte rozhraní, ke kterému je ovládací prvek svázaný s daty IDataSource přidružený, pokud existuje. (Zděděno od DataBoundControl)
GetDesignModeState()	Získá data v době návrhu pro ovládací prvek. (Zděděno od Control)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetRouteUrl(Object)	Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control)
GetRouteUrl(RouteValueDictionary)	Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control)
GetRouteUrl(String, Object)	Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control)
GetRouteUrl(String, RouteValueDictionary)	Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
GetUniqueIDRelativeTo(Control)	Vrátí předponu části UniqueID vlastnosti zadaného ovládacího prvku. (Zděděno od Control)
HasControls()	Určuje, zda serverový ovládací prvek obsahuje jakékoli podřízené ovládací prvky. (Zděděno od Control)
HasEvents()	Vrátí hodnotu určující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky. (Zděděno od Control)
IsLiteralContent()	Určuje, zda ovládací prvek serveru obsahuje pouze literálový obsah. (Zděděno od Control)
LoadControlState(Object)	Obnoví informace o stavu řízení z předchozího požadavku na stránku, který byla uložena metodou SaveControlState() . (Zděděno od Control)
LoadPostData(String, NameValueCollection)	Zpracovává data postback pro DropDownList ovládací prvek.
LoadViewState(Object)	Načte dříve uložený stav DetailsView zobrazení ovládacího prvku. (Zděděno od ListControl)
MapPathSecure(String)	Načte fyzickou cestu, na kterou se mapuje virtuální cesta ( absolutní nebo relativní). (Zděděno od Control)
MarkAsDataBound()	Nastaví stav ovládacího prvku ve stavu zobrazení tak, aby byl úspěšně svázán s daty. (Zděděno od DataBoundControl)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
MergeStyle(Style)	Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku, ale nepřepíše žádné existující prvky stylu ovládacího prvku. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl)
OnBubbleEvent(Object, EventArgs)	Určuje, zda je událost pro ovládací prvek serveru předána hierarchii ovládacích prvků uživatelského rozhraní stránky. (Zděděno od Control)
OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)	CreatingModelDataSource Vyvolá událost. (Zděděno od DataBoundControl)
OnDataBinding(EventArgs)	DataBinding Vyvolá událost. (Zděděno od ListControl)
OnDataBound(EventArgs)	DataBound Vyvolá událost. (Zděděno od BaseDataBoundControl)
OnDataPropertyChanged()	Po změně jedné z vlastností identifikace základního zdroje dat se ovládací prvek svázaný s daty změní na data. (Zděděno od DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)	DataSourceViewChanged Vyvolá událost. (Zděděno od DataBoundControl)
OnInit(EventArgs)	Init Vyvolá událost. (Zděděno od Control)
OnInit(EventArgs)	Init Zpracovává událost. (Zděděno od BaseDataBoundControl)
OnLoad(EventArgs)	Load Vyvolá událost. (Zděděno od Control)
OnLoad(EventArgs)	Load Zpracovává událost. (Zděděno od DataBoundControl)
OnPagePreLoad(Object, EventArgs)	Nastaví inicializovaný stav ovládacího prvku vázaného na data před načtením ovládacího prvku. (Zděděno od DataBoundControl)
OnPreRender(EventArgs)	PreRender Vyvolá událost. (Zděděno od ListControl)
OnSelectedIndexChanged(EventArgs)	SelectedIndexChanged Vyvolá událost. To umožňuje zadat vlastní obslužnou rutinu události. (Zděděno od ListControl)
OnTextChanged(EventArgs)	TextChanged Vyvolá událost. (Zděděno od ListControl)
OnUnload(EventArgs)	Unload Vyvolá událost. (Zděděno od Control)
OpenFile(String)	Stream Získá použité ke čtení souboru. (Zděděno od Control)
PerformDataBinding(IEnumerable)	Vytvoří vazbu zadaného zdroje dat na ovládací prvek odvozený z ListControl třídy. (Zděděno od ListControl)
PerformSelect()	Načte data z přidruženého zdroje dat. (Zděděno od ListControl)
RaiseBubbleEvent(Object, EventArgs)	Přiřadí všechny zdroje události a její informace nadřazené ovládacího prvku. (Zděděno od Control)
RaisePostDataChangedEvent()	Vyvolá události pro DropDownList ovládací prvek, když dojde k zpětnému odeslání.
RemovedControl(Control)	Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control . (Zděděno od Control)
Render(HtmlTextWriter)	Vykreslí ovládací prvek na zadaný zapisovač HTML. (Zděděno od WebControl)
RenderBeginTag(HtmlTextWriter)	Vykreslí počáteční značku HTML ovládacího prvku určenému zapisovači. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl)
RenderChildren(HtmlTextWriter)	Vypíše obsah podřízených položek ovládacího prvku serveru do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control)
RenderContents(HtmlTextWriter)	Vykreslí obsah ovládacího prvku určenému zapisovači.
RenderContents(HtmlTextWriter)	Vykreslí položky v ovládacím ListControl prvku. (Zděděno od ListControl)
RenderControl(HtmlTextWriter, ControlAdapter)	Výstupy obsahu ovládacího prvku serveru do poskytnutého HtmlTextWriter objektu pomocí poskytnutého ControlAdapter objektu. (Zděděno od Control)
RenderControl(HtmlTextWriter)	Výstupy obsahu ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je povoleno trasování. (Zděděno od Control)
RenderEndTag(HtmlTextWriter)	Vykreslí zavírací značku HTML ovládacího prvku do zadaného zapisovače. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl)
ResolveAdapter()	Získá adaptér ovládacího prvku zodpovědný za vykreslení zadaného ovládacího prvku. (Zděděno od Control)
ResolveClientUrl(String)	Získá adresu URL, kterou může prohlížeč používat. (Zděděno od Control)
ResolveUrl(String)	Převede adresu URL na adresu URL, která je použitelná u žádajícího klienta. (Zděděno od Control)
SaveControlState()	Uloží všechny změny stavu řízení serveru, ke kterým došlo od doby, kdy byla stránka odeslána zpět na server. (Zděděno od Control)
SaveViewState()	Uloží aktuální stav ListControl zobrazení ovládacího prvku -derived a položky, které obsahuje. (Zděděno od ListControl)
SetDesignModeState(IDictionary)	Nastaví data návrhu pro ovládací prvek. (Zděděno od Control)
SetPostDataSelection(Int32)	Selected Nastaví vlastnost ListItem ovládacího prvku po publikování stránky. (Zděděno od ListControl)
SetRenderMethodDelegate(RenderMethod)	Přiřadí delegáta obslužné rutiny události k vykreslení ovládacího prvku serveru a jeho obsahu do nadřazeného ovládacího prvku. (Zděděno od Control)
SetTraceData(Object, Object, Object)	Nastaví trasovací data pro trasování doby návrhu vykreslovacích dat pomocí trasovaného objektu, klíče dat trasování a hodnoty dat trasování. (Zděděno od Control)
SetTraceData(Object, Object)	Nastaví data trasování pro trasování vykreslování dat v době návrhu pomocí klíče dat trasování a hodnoty dat trasování. (Zděděno od Control)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TrackViewState()	Označí výchozí bod pro zahájení sledování a ukládání změn stavu zobrazení do ListControl ovládacího prvku -derived. (Zděděno od ListControl)
ValidateDataSource(Object)	Ověřuje, že objekt, na který je ovládací prvek svázaný s daty, je takový, se kterým může pracovat. (Zděděno od DataBoundControl)
VerifyMultiSelect()	Vždy vyvolá HttpException výjimku, protože ovládací DropDownList prvek nepodporuje vícenásobný výběr.

Událost

Name	Description
CallingDataMethods	Nastane, když se volají datové metody. (Zděděno od DataBoundControl)
CreatingModelDataSource	Nastane při vytváření objektu ModelDataSource . (Zděděno od DataBoundControl)
DataBinding	Nastane, když ovládací prvek serveru vytvoří vazbu ke zdroji dat. (Zděděno od Control)
DataBound	Nastane po vytvoření vazby ovládacího prvku serveru ke zdroji dat. (Zděděno od BaseDataBoundControl)
Disposed	Nastane, když je serverový ovládací prvek uvolněn z paměti, což je poslední fáze životního cyklu řízení serveru při vyžádání ASP.NET stránky. (Zděděno od Control)
Init	Nastane při inicializaci ovládacího prvku serveru, což je první krok v jeho životním cyklu. (Zděděno od Control)
Load	Nastane, když je serverový ovládací prvek načten do objektu Page . (Zděděno od Control)
PreRender	Nastane po načtení objektu Control , ale před vykreslením. (Zděděno od Control)
SelectedIndexChanged	Nastane, když se výběr z ovládacího prvku seznamu změní mezi příspěvky na server. (Zděděno od ListControl)
TextChanged	Nastane, když se Text změní vlastnosti a SelectedValue vlastnosti. (Zděděno od ListControl)
Unload	Nastane, když je serverový ovládací prvek uvolněn z paměti. (Zděděno od Control)

Explicitní implementace rozhraní

Name	Description
IAttributeAccessor.GetAttribute(String)	Získá atribut webového ovládacího prvku se zadaným názvem. (Zděděno od WebControl)
IAttributeAccessor.SetAttribute(String, String)	Nastaví atribut webového ovládacího prvku na zadaný název a hodnotu. (Zděděno od WebControl)
IControlBuilderAccessor.ControlBuilder	Popis tohoto člena naleznete v tématu ControlBuilder. (Zděděno od Control)
IControlDesignerAccessor.GetDesignModeState()	Popis tohoto člena naleznete v tématu GetDesignModeState(). (Zděděno od Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Popis tohoto člena naleznete v tématu SetDesignModeState(IDictionary). (Zděděno od Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Popis tohoto člena naleznete v tématu SetOwnerControl(Control). (Zděděno od Control)
IControlDesignerAccessor.UserData	Popis tohoto člena naleznete v tématu UserData. (Zděděno od Control)
IDataBindingsAccessor.DataBindings	Popis tohoto člena naleznete v tématu DataBindings. (Zděděno od Control)
IDataBindingsAccessor.HasDataBindings	Popis tohoto člena naleznete v tématu HasDataBindings. (Zděděno od Control)
IExpressionsAccessor.Expressions	Popis tohoto člena naleznete v tématu Expressions. (Zděděno od Control)
IExpressionsAccessor.HasExpressions	Popis tohoto člena naleznete v tématu HasExpressions. (Zděděno od Control)
IParserAccessor.AddParsedSubObject(Object)	Popis tohoto člena naleznete v tématu AddParsedSubObject(Object). (Zděděno od Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)	Zpracovává data vystavená DropDownList pro ovládací prvek.
IPostBackDataHandler.RaisePostDataChangedEvent()	Vyvolá události pro ovládací prvek postback DropDownList .

Metody rozšíření

Name	Description
EnablePersistedSelection(BaseDataBoundControl)	Zastaralé. Umožňuje zachovat výběr v ovládacích prvcích dat, které podporují výběr a stránkování.
FindDataSourceControl(Control)	Vrátí zdroj dat přidružený k ovládacímu prvku dat pro zadaný ovládací prvek.
FindFieldTemplate(Control, String)	Vrátí šablonu pole pro zadaný sloupec v kontejneru pojmenování zadaného ovládacího prvku.
FindMetaTable(Control)	Vrátí objekt metatable pro ovládací prvek obsahující data.

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?