HtmlSelect Classe

Referência

Definição

Namespace:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Permite o acesso programático ao elemento <select> HTML no servidor.

public ref class HtmlSelect : System::Web::UI::HtmlControls::HtmlContainerControl, System::Web::UI::IPostBackDataHandler

[System.Web.UI.ValidationProperty("Value")]
public class HtmlSelect : System.Web.UI.HtmlControls.HtmlContainerControl, System.Web.UI.IPostBackDataHandler

[<System.Web.UI.ValidationProperty("Value")>]
type HtmlSelect = class
    inherit HtmlContainerControl
    interface IPostBackDataHandler
    interface IParserAccessor

Public Class HtmlSelect
Inherits HtmlContainerControl
Implements IPostBackDataHandler

Herança: Object

Control

HtmlControl

HtmlContainerControl
HtmlSelect

Atributos: ValidationPropertyAttribute

Implementações: IParserAccessor IPostBackDataHandler

Exemplos

O exemplo de código a seguir demonstra como criar um HtmlSelect controle declarando explicitamente os itens que aparecem no controle.


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

<script runat="server">

    void Button_Click (Object sender, EventArgs e)
    {
        
        Label1.Text = "You selected:";

        for (int i = 0; i <= Select1.Items.Count - 1; i++)
        {
           if (Select1.Items[i].Selected)
              Label1.Text += "<br />    -" + Select1.Items[i].Text;
        }

    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>
    <title> HtmlSelect Example </title>
</head>
<body>
<form id="form1" runat="server">
    
    <h3> HtmlSelect Example </h3>

    Select items from the list: <br /><br />

    <select id="Select1" 
            multiple="true"
            runat="server">

        <option value="1" selected="selected"> Item 1 </option>
        <option value="2"> Item 2 </option>
        <option value="3"> Item 3 </option>
        <option value="4"> Item 4 </option>
        <option value="5"> Item 5 </option>
        <option value="6"> Item 6 </option>

    </select>
    <br /><br />

    <button id="Button1"
            onserverclick="Button_Click"
            runat="server">

        Submit

    </button>
    <br /><br />

    <asp:Label id="Label1"
         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">

<script runat="server">

    Sub Button_Click (sender As Object, e As EventArgs)
        
        Dim i As Integer

        Label1.Text = "You selected:"
        For i = 0 to Select1.Items.Count - 1
  
            If Select1.Items(i).Selected Then
               Label1.Text = Label1.Text & "<br />    -" _
                   & Select1.Items(i).Text
            End If         

        Next i

    End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>
    <title> HtmlSelect Example </title>
</head>
<body>
<form id="form1" runat="server">

    <h3> HtmlSelect Example </h3>

    Select items from the list: <br /><br />

    <select id="Select1" 
            multiple="true"
            runat="server">

        <option value="1" selected="selected"> Item 1 </option>
        <option value="2"> Item 2 </option>
        <option value="3"> Item 3 </option>
        <option value="4"> Item 4 </option>
        <option value="5"> Item 5 </option>
        <option value="6"> Item 6 </option>

    </select>
    <br /><br />

    <button id="Button1"
            onserverclick="Button_Click"
            runat="server">

        Submit

    </button>
    <br /><br />

    <asp:Label id="Label1"
         runat="server"/>

   </form>
</body>
</html>

O exemplo de código a seguir demonstra como criar um HtmlSelect controle associando o controle a uma fonte de dados.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<%@ Import Namespace="System.Data.SqlClient" %>

<!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> HtmlSelect Example </title>
<script runat="server">

      void Page_Load (Object sender, EventArgs e)
      {

        // Bind the HtmlSelect control to a data source when the page is initially loaded.
        if (!IsPostBack)
        {
      
           // Open a connection to the database and run the query.
           // Note that the connection string may vary depending on your
           // database server settings. 
           string ConnectString = "server=localhost;database=pubs;integrated security=SSPI";
           string QueryString = "select * from authors";

           SqlConnection myConnection = new SqlConnection(ConnectString);
           SqlDataAdapter myCommand = new SqlDataAdapter(QueryString, myConnection);

           // Create a dataset to store the query results.
           DataSet ds = new DataSet();
           myCommand.Fill(ds, "Authors");

           // Bind the HtmlSelect control to the data source.
           Select1.DataSource = ds;
           Select1.DataTextField = "au_fname";
           Select1.DataValueField = "au_fname";
           Select1.DataBind();
        }

      }

      void Button_Click (Object sender, EventArgs e)
      {
       
         // Display the selected items. 
         Label1.Text = "You selected:";

         for (int i=0; i<=Select1.Items.Count - 1; i++)
         {
            if (Select1.Items[i].Selected)
               Label1.Text += "<br />    - " + Select1.Items[i].Text;
         }

      }

   </script>

</head>

<body>

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

      <h3> HtmlSelect Example </h3>

      Select items from the list. <br />
      Use the Control or Shift key to select multiple items. <br /><br />

      <select id="Select1"
              multiple="true" 
              runat="server"/>

      <br /><br />

      <button id="Button1"
              onserverclick="Button_Click"
              runat="server">

         Submit

      </button>

      <br /><br />

      <asp:Label id="Label1"
           runat="server"/>

   </form>

</body>

</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
<%@ Import Namespace="System.Data.SqlClient" %>

<!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> HtmlSelect Example </title>
<script runat="server">

      Sub Page_Load (sender As Object, e As EventArgs)
  
        ' Bind the HtmlSelect control to a data source when the page is initially loaded.
        If Not IsPostBack Then
        
           ' Open a connection to the database and run the query.
           ' Note that the connection string may vary depending on your
           ' database server settings.
           Dim ConnectString As String = "server=localhost;database=pubs;integrated security=SSPI"
           Dim QueryString As String = "select * from authors"

           Dim myConnection As SqlConnection = New SqlConnection(ConnectString)
           Dim myCommand As SqlDataAdapter = New SqlDataAdapter(QueryString, myConnection)

           ' Create a dataset to store the query results.
           Dim ds As DataSet = New DataSet()
           myCommand.Fill(ds, "Authors")

           ' Bind the HtmlSelect control to the data source.
           Select1.DataSource = ds
           Select1.DataTextField = "au_fname"
           Select1.DataValueField = "au_fname"
           Select1.DataBind()
        
        End If

      End Sub

      Sub Button_Click (sender As Object, e As EventArgs)
        
         Dim i As Integer

         Label1.Text = "You selected:"

         For i = 0 To Select1.Items.Count - 1
         
            If Select1.Items(i).Selected Then
               Label1.Text = Label1.Text & "<br />    - " & Select1.Items(i).Text
            End If

         Next i

      End Sub

   </script>

</head>

<body>

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

      <h3> HtmlSelect Example </h3>

      Select items from the list. <br />
      Use the Control or Shift key to select multiple items. <br /><br />

      <select id="Select1"
              multiple="true" 
              runat="server"/>

      <br /><br />

      <button id="Button1"
              onserverclick="Button_Click"
              runat="server">

         Submit

      </button>

      <br /><br />

      <asp:Label id="Label1"
           runat="server"/>

   </form>

</body>

</html>

O exemplo de código a seguir demonstra como usar a DataSourceID propriedade para especificar a fonte de dados para um HtmlSelect controle . A DataSourceID propriedade é definida como a ID propriedade do SqlDataSource controle usado para recuperar os dados. Quando a página é carregada, o HtmlSelect controle é automaticamente associado à fonte de dados especificada pelo SqlDataSource controle e os dados são exibidos para o usuário.

<%@ page language="C#" %>

<!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 id="Head1" runat="server">
    <title>HtmlSelect.DataSourceID</title>
</head>
<body>
<form id="Form1" runat="server">
  <div>

    <h3> HtmlSelect.DataSourceID Example </h3>

    <p>Select an item from the list</p>

    <select id="Select1"
      name="Select1"
      datasourceid="SqlDataSource1"
      datatextfield="ProductName"
      runat="server">
    </select>

    <asp:sqldatasource id="SqlDataSource1"          
      connectionstring="workstation id=localhost;integrated security=SSPI;initial catalog=Northwind"
      selectcommand="SELECT * FROM [Products] Where ProductID <= 5"
      runat="server">
    </asp:sqldatasource>

  </div>
</form>
</body>
</html>

<%@ page language="VB" %>

<!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 id="Head1" runat="server">
    <title>HtmlSelect.DataSourceID</title>
</head>
<body>
<form id="Form1" runat="server">
  <div>

    <h3> HtmlSelect.DataSourceID Example </h3>

    <p>Select an item from the list</p>

    <select id="Select1"
      name="Select1"
      datasourceid="SqlDataSource1"
      datatextfield="ProductName"
      runat="server">
    </select>

    <asp:sqldatasource id="SqlDataSource1"          
      connectionstring="workstation id=localhost;integrated security=SSPI;initial catalog=Northwind"
      selectcommand="SELECT * FROM [Products] Where ProductID <= 5"
      runat="server">
    </asp:sqldatasource>

  </div>
</form>
</body>
</html>

Comentários

Use o HtmlSelect controle para criar uma caixa de seleção. Especifique as listagens de itens no controle colocando elementos HTML <option> entre as marcas de abertura e fechamento <select> . Cada item é representado por um System.Web.UI.WebControls.ListItem objeto . Para especificar o texto exibido para cada item no controle, você pode definir a ListItem.Text propriedade do item ou simplesmente colocar o texto entre as marcas de abertura e fechamento <option> . Ao definir a ListItem.Value propriedade do item, você pode associar um valor ao item diferente do texto. Para selecionar um item da lista por padrão, defina a ListItem.Selected propriedade do item como true.

Você pode controlar a aparência e o HtmlSelect comportamento do controle definindo as Size propriedades e Multiple . A Size propriedade especifica a altura (em linhas) do controle. A Multiple propriedade especifica se mais de um item pode ser selecionado simultaneamente no HtmlSelect controle .

Por padrão, o HtmlSelect controle é exibido como uma caixa de listagem suspensa. Se você permitir várias seleções (definindo a Multiple propriedade truecomo ) ou especificar uma altura maior que uma linha (definindo a Size propriedade como um valor maior que 1), o controle será exibido como uma caixa de listagem.

Para determinar o item selecionado em um controle de seleção HtmlSelect única, use a SelectedIndex propriedade para obter o índice do item selecionado. Em seguida, você pode usar esse valor para recuperar o item da Items coleção.

Para determinar os itens selecionados de um HtmlSelect controle que permite várias seleções, itere pela Items coleção e teste a ListItem.Selected propriedade de cada item.

A HtmlSelect classe fornece duas propriedades para dar suporte à associação de dados. Para associar dados a qualquer objeto que implemente a System.Collections.IEnumerable interface (como System.Data.DataView, System.Collections.ArrayListe System.Collections.Generic.List<T>) ou a IListSource interface , use a DataSource propriedade para especificar a fonte de dados à qual associar. Ao definir a DataSource propriedade, você deve escrever manualmente o código para executar a associação de dados. Para associar automaticamente um HtmlSelect controle a uma fonte de dados representada por um controle de fonte de dados, use a DataSourceID propriedade e defina seu valor como a ID propriedade do controle de fonte de dados a ser usada. Quando você define a DataSourceID propriedade, o HtmlSelect controle se associa automaticamente ao controle de fonte de dados especificado. Portanto, você não precisa chamar explicitamente o DataBind método .

Você também pode especificar quais campos na fonte de dados se associam às ListItem.Text propriedades e ListItem.Value de um item no controle definindo as DataTextField propriedades e DataValueField , respectivamente. Se a fonte de dados contiver várias fontes de dados, use a DataMember propriedade para especificar a fonte específica a ser associada ao controle. Por exemplo, se você tiver um System.Data.DataSet objeto com várias tabelas, deverá especificar qual tabela associar ao controle com a DataMember propriedade .

Para obter uma lista de valores de propriedade iniciais de uma instância do HtmlSelect, consulte o HtmlSelect construtor.

Construtores

HtmlSelect()

Inicializa uma nova instância da classe HtmlSelect.

Propriedades

Adapter	Obtém o adaptador específico de navegador para o controle. (Herdado de Control)
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle. (Herdado de Control)
Attributes	Obtém uma coleção de todos os pares de nome e valor dos atributos expressos em uma marca de controle do servidor na página ASP.NET. (Herdado de HtmlControl)
BindingContainer	Obtém o controle que contém a vinculação de dados desse controle. (Herdado de Control)
ChildControlsCreated	Obtém um valor que indica se os controles filho do controle de servidor foram criados. (Herdado de Control)
ClientID	Obtém a ID de controle de marcação HTML gerada pelo ASP.NET. (Herdado de Control)
ClientIDMode	Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID. (Herdado de Control)
ClientIDSeparator	Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID. (Herdado de Control)
Context	Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual. (Herdado de Control)
Controls	Obtém um objeto ControlCollection que representa os controles filho para um controle de servidor especificado na hierarquia de interface do usuário. (Herdado de Control)
DataItemContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer. (Herdado de Control)
DataKeysContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl. (Herdado de Control)
DataMember	Obtém ou define o conjunto de dados para associar o controle HtmlSelect de uma propriedade DataSource com vários conjuntos de dados.
DataSource	Obtém ou define a origem das informações para associar ao controle HtmlSelect.
DataSourceID	Obtém ou define a propriedade ID do controle de fonte de dados que o controle HtmlSelect deve usar para recuperar a fonte de dados.
DataTextField	Obtém ou define o campo da fonte de dados para associar à propriedade Text de cada item no controle HtmlSelect.
DataValueField	Obtém ou define o campo da fonte de dados para associar à propriedade Value de cada item no controle HtmlSelect.
DesignMode	Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control)
Disabled	Obtém ou define um valor que indica se o controle do servidor HTML está desabilitado. (Herdado de HtmlControl)
EnableTheming	Obtém ou define um valor que indica se os temas se aplicam a esse controle. (Herdado de Control)
EnableViewState	Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante. (Herdado de Control)
Events	Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control)
HasChildViewState	Obtém um valor que indica se os controles filho do controle de servidor atual têm alguma configuração de estado de exibição salva. (Herdado de Control)
ID	Obtém ou define o identificador programático atribuído ao controle de servidor. (Herdado de Control)
IdSeparator	Obtém o caractere usado para separar identificadores de controle. (Herdado de Control)
InnerHtml	Obtém ou define o conteúdo entre as marcas de abertura e fechamento do controle, sem converter automaticamente os caracteres especiais nas suas entidades HTML equivalentes. Não há suporte para a propriedade neste controle.
InnerText	Obtém ou define o conteúdo entre as marcas de abertura e fechamento do controle, convertendo automaticamente os caracteres especiais nas suas entidades HTML equivalentes. Não há suporte para a propriedade neste controle.
IsBoundUsingDataSourceID	Obtém um valor que indica se uma propriedade DataSourceID é definida para o controle HtmlSelect.
IsChildControlStateCleared	Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle. (Herdado de Control)
IsTrackingViewState	Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição. (Herdado de Control)
IsViewStateEnabled	Obtém um valor que indica se o estado de exibição está habilitado para esse controle. (Herdado de Control)
Items	Obtém uma coleção que contém os itens listados em um controle HtmlSelect.
LoadViewStateByID	Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice. (Herdado de Control)
Multiple	Obtém ou define um valor que indica se vários itens podem ser selecionados ao mesmo tempo no controle HtmlSelect.
Name	Obtém ou define o nome de identificador associado ao controle HtmlSelect.
NamingContainer	Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID. (Herdado de Control)
Page	Obtém uma referência para a instância Page que contém o controle de servidor. (Herdado de Control)
Parent	Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página. (Herdado de Control)
RenderingCompatibility	Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control)
RequiresDataBinding	Obtém ou define um valor que indica se o controle HtmlSelect precisa se associar à respectiva fonte de dados especificada.
SelectedIndex	Obtém ou define o índice ordinal do item selecionado no controle HtmlSelect.
SelectedIndices	Obtém uma coleção que contém os índices com base em zero de todos os itens selecionados no momento no controle HtmlSelect.
Site	Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design. (Herdado de Control)
Size	Obtém ou define a altura (em linhas) do controle HtmlSelect.
SkinID	Obtém ou define a capa a ser aplicada ao controle. (Herdado de Control)
Style	Obtém uma coleção de todas as propriedades de CSS (folha de estilos em cascata) aplicadas a um controle de servidor HTML especificado no arquivo ASP.NET. (Herdado de HtmlControl)
TagName	Obtém o nome do elemento de uma marca que contém um par de atributo e valor `runat=server`. (Herdado de HtmlControl)
TemplateControl	Obtém ou define uma referência ao modelo que contém este controle. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual. (Herdado de Control)
UniqueID	Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor. (Herdado de Control)
ValidateRequestMode	Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control)
Value	Obtém o valor do item selecionado no controle HtmlSelect ou define a propriedade SelectedIndex do controle para o índice do primeiro item na lista com o valor especificado.
ViewState	Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página. (Herdado de Control)
ViewStateIgnoresCase	Obtém um valor que indica se o estado de exibição HtmlControl diferencia maiúsculas de minúsculas. (Herdado de HtmlControl)
ViewStateMode	Obtém ou define o modo de estado de exibição deste controle. (Herdado de Control)
Visible	Obtém ou define um valor que indica se um controle de servidor é renderizado como uma interface do usuário na página. (Herdado de Control)

Métodos

AddedControl(Control, Int32)	Chamado após um controle filho ser adicionado à coleção Controls do objeto Control. (Herdado de Control)
AddParsedSubObject(Object)	Adiciona um controle filho analisado ao controle HtmlSelect.
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilos da página ao controle. (Herdado de Control)
BeginRenderTracing(TextWriter, Object)	Inicia o rastreamento de tempo de design de dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor ClientID armazenado em cache como `null`. (Herdado de Control)
ClearChildControlState()	Exclui as informações de estado de controle para os controles filho do controle de servidor. (Herdado de Control)
ClearChildState()	Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor. (Herdado de Control)
ClearChildViewState()	Exclui as informações de estado de exibição para todos os controles filho do controle de servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit. (Herdado de Control)
ClearSelection()	Limpa a seleção de lista do controle HtmlSelect e define a propriedade Selected de todos os itens como `false`.
CreateChildControls()	Chamado pela estrutura de página do ASP.NET para notificar os controles do servidor que usam a implementação baseada em composição para criar os controles filho para preparar-se para um postback ou renderização. (Herdado de Control)
CreateControlCollection()	Cria um objeto EmptyControlCollection para o controle HtmlSelect.
DataBind()	Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho. (Herdado de Control)
DataBind(Boolean)	Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding. (Herdado de Control)
DataBindChildren()	Associa uma fonte de dados aos controles filho do controle do servidor. (Herdado de Control)
Dispose()	Permite que um controle de servidor execute a limpeza final antes do lançamento da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Encerra o rastreamento de tempo de design de dados de renderização. (Herdado de Control)
EnsureChildControls()	Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho. (Herdado de Control)
EnsureDataBound()	Verifica se o controle HtmlSelect requer associação de dados e se um controle de fonte de dados válido é especificado antes de chamar o método DataBind().
EnsureID()	Cria um identificador para controles que não têm um identificador atribuído. (Herdado de Control)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindControl(String)	Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro `id` especificado. (Herdado de Control)
FindControl(String, Int32)	Procura o contêiner de nomenclatura atual para um controle de servidor com o `id` especificado e um inteiro especificado no parâmetro `pathOffset`, que auxilia na pesquisa. Você não deve substituir esta versão do método FindControl. (Herdado de Control)
Focus()	Define o foco de entrada para um controle. (Herdado de Control)
GetAttribute(String)	Obtém o valor do atributo nomeado no controle HtmlControl. (Herdado de HtmlControl)
GetData()	Obtém um objeto IEnumerable que representa a fonte de dados associada ao controle HtmlSelect.
GetDesignModeState()	Obtém os dados de tempo de design para um controle. (Herdado de Control)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetRouteUrl(Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(String, Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUniqueIDRelativeTo(Control)	Retorna a parte prefixada da propriedade UniqueID do controle especificado. (Herdado de Control)
HasControls()	Determina se o controle de servidor contém algum controle filho. (Herdado de Control)
HasEvents()	Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho. (Herdado de Control)
IsLiteralContent()	Determina se o controle de servidor contém apenas o conteúdo literal. (Herdado de Control)
LoadControlState(Object)	Restaura informações de estado de controle de uma solicitação de página anterior que foi salva pelo método SaveControlState(). (Herdado de Control)
LoadPostData(String, NameValueCollection)	Processa os dados de postback para o controle HtmlSelect.
LoadViewState(Object)	Restaura as informações de estado de exibição do controle HtmlSelect de uma solicitação de página anterior salva pelo método SaveViewState().
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual. (Herdado de Control)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnBubbleEvent(Object, EventArgs)	Determina se o evento do controle de servidor é passado um nível acima da hierarquia de controle de servidor da interface do usuário da página. (Herdado de Control)
OnDataBinding(EventArgs)	Aciona o evento DataBinding de um controle HtmlSelect.
OnDataPropertyChanged()	É invocado quando a propriedade DataSource, DataMember ou DataSourceID é alterada.
OnDataSourceViewChanged(Object, EventArgs)	É invocado quando a propriedade DataSource, DataMember ou DataSourceID é alterada.
OnInit(EventArgs)	Aciona o evento Init do controle HtmlSelect.
OnInit(EventArgs)	Aciona o evento Init. (Herdado de Control)
OnLoad(EventArgs)	Aciona o evento Load do controle HtmlSelect.
OnLoad(EventArgs)	Aciona o evento Load. (Herdado de Control)
OnPreRender(EventArgs)	Aciona o evento PreRender do controle HtmlSelect.
OnServerChange(EventArgs)	Aciona o evento ServerChange do controle HtmlSelect. Isso permite que você forneça um manipulador personalizado para o evento.
OnUnload(EventArgs)	Aciona o evento Unload. (Herdado de Control)
OpenFile(String)	Obtém um Stream usado para ler um arquivo. (Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)	Atribui quaisquer fontes de evento e suas informações para o pai do controle. (Herdado de Control)
RaisePostDataChangedEvent()	Chama o método OnServerChange(EventArgs) para sinalizar ao controle HtmlSelect que o estado do controle foi alterado.
RemovedControl(Control)	Chamado após um controle filho ser removido da coleção Controls do objeto Control. (Herdado de Control)
Render(HtmlTextWriter)	Renderiza o controle HtmlContainerControl no objeto HtmlTextWriter especificado. (Herdado de HtmlContainerControl)
RenderAttributes(HtmlTextWriter)	Renderiza os atributos do controle HtmlSelect no objeto HtmlTextWriter especificado.
RenderBeginTag(HtmlTextWriter)	Renderiza a marca HTML de abertura do controle para o objeto HtmlTextWriter especificado. (Herdado de HtmlControl)
RenderChildren(HtmlTextWriter)	Renderiza os controles filho do controle HtmlSelect no objeto HtmlTextWriter especificado.
RenderControl(HtmlTextWriter)	Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado. (Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido. (Herdado de Control)
RenderEndTag(HtmlTextWriter)	Renderiza a marca de fechamento para o controle HtmlContainerControl no objeto HtmlTextWriter especificado. (Herdado de HtmlContainerControl)
ResolveAdapter()	Obtém o adaptador de controle responsável por renderizar o controle especificado. (Herdado de Control)
ResolveClientUrl(String)	Obtém uma URL que pode ser usada pelo navegador. (Herdado de Control)
ResolveUrl(String)	Converte uma URL em uma que possa ser usada no cliente solicitante. (Herdado de Control)
SaveControlState()	Salva as alterações de estado do controle de servidor que ocorreram desde a hora em que ocorreu o postback da página no servidor. (Herdado de Control)
SaveViewState()	Salva alterações de estado de exibição do controle HtmlSelect que ocorreram desde o postback da página no servidor.
Select(Int32[])	Selecione vários itens da coleção Items do controle HtmlSelect.
SetAttribute(String, String)	Define o valor do atributo nomeado no controle HtmlControl. (Herdado de HtmlControl)
SetDesignModeState(IDictionary)	Define os dados de tempo de design para um controle. (Herdado de Control)
SetRenderMethodDelegate(RenderMethod)	Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai. (Herdado de Control)
SetTraceData(Object, Object)	Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento. (Herdado de Control)
SetTraceData(Object, Object, Object)	Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento. (Herdado de Control)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TrackViewState()	Rastreia alterações de estado de exibição no controle HtmlSelect de modo que as alterações podem ser armazenadas no objeto StateBag do controle. Esse objeto é acessível por meio da propriedade ViewState.

Eventos

DataBinding	Ocorre quando o controle de servidor é associado a uma fonte de dados. (Herdado de Control)
Disposed	Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida de controle de servidor quando uma página ASP.NET é solicitada. (Herdado de Control)
Init	Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida. (Herdado de Control)
Load	Ocorre quando o controle de servidor é carregado no objeto Page. (Herdado de Control)
PreRender	Ocorre depois que o objeto Control é carregado, mas antes da renderização. (Herdado de Control)
ServerChange	Ocorre quando os itens selecionados no controle de HtmlSelect se alteram entre as postagens no servidor.
Unload	Ocorre quando o controle de servidor é descarregado da memória. (Herdado de Control)

Implantações explícitas de interface

IAttributeAccessor.GetAttribute(String)	Para obter uma descrição desse membro, confira GetAttribute(String). (Herdado de HtmlControl)
IAttributeAccessor.SetAttribute(String, String)	Para obter uma descrição desse membro, confira SetAttribute(String, String). (Herdado de HtmlControl)
IControlBuilderAccessor.ControlBuilder	Para obter uma descrição desse membro, confira ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para obter uma descrição desse membro, confira GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para obter uma descrição desse membro, confira SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para obter uma descrição desse membro, confira UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para obter uma descrição desse membro, confira DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para obter uma descrição desse membro, confira HasDataBindings. (Herdado de Control)
IExpressionsAccessor.Expressions	Para obter uma descrição desse membro, confira Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para obter uma descrição desse membro, confira HasExpressions. (Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para obter uma descrição desse membro, confira AddParsedSubObject(Object). (Herdado de Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)	Para obter uma descrição desse membro, confira LoadPostData(String, NameValueCollection).
IPostBackDataHandler.RaisePostDataChangedEvent()	Para obter uma descrição desse membro, confira RaisePostDataChangedEvent().

Métodos de Extensão

FindDataSourceControl(Control)	Retorna a fonte de dados associada ao controle de dados do controle especificado.
FindFieldTemplate(Control, String)	Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.
FindMetaTable(Control)	Retorna o objeto metatable para o controle que contém dados.

Aplica-se a

Compartilhar via