HtmlSelect Classe
Definição
Permite o acesso programático ao elemento <select> HTML no servidor.Allows programmatic access to the HTML <select> element on the server.
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
- Atributos
- Implementações
Exemplos
O exemplo de código a seguir demonstra como criar um HtmlSelect controle declarando explicitamente os itens que aparecem no controle.The following code example demonstrates how to create an HtmlSelect control by explicitly declaring the items that appear in the control.
<%@ 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 ligando o controle a uma fonte de dados.The following code example demonstrates how to create an HtmlSelect control by binding the control to a data source.
<%@ 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.The following code example demonstrates how to use the DataSourceID property to specify the data source for an HtmlSelect control. A DataSourceID propriedade é definida como a ID Propriedade do SqlDataSource controle usado para recuperar os dados.The DataSourceID property is set to the ID property of the SqlDataSource control used to retrieve the data. 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.When the page is loaded, the HtmlSelect control automatically binds to the data source specified by the SqlDataSource control and the data is displayed to the user.
<%@ 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.Use the HtmlSelect control to create a selection box. Especifique listagens de itens no controle colocando elementos HTML <option> entre as marcas de abertura e de fechamento <select> .Specify item listings in the control by placing HTML <option> elements between the opening and closing <select> tags. Cada item é representado por um System.Web.UI.WebControls.ListItem objeto.Each item is represented by a System.Web.UI.WebControls.ListItem object. Para especificar o texto que é 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 de fechamento <option> .To specify the text that is displayed for each item in the control, you can set the ListItem.Text property of the item, or simply place text between the opening and closing <option> tags. Ao definir a ListItem.Value Propriedade do item, você pode associar um valor ao item que é diferente do texto.By setting the ListItem.Value property of the item, you can associate a value with the item that is different from the text. Para selecionar um item da lista por padrão, defina a ListItem.Selected Propriedade do item como true .To select an item from the list by default, set the ListItem.Selected property of the item to true.
Você pode controlar a aparência e o comportamento do HtmlSelect controle definindo as Size Propriedades e Multiple .You can control the appearance and behavior of the HtmlSelect control by setting the Size and Multiple properties. A Size propriedade especifica a altura (em linhas) do controle.The Size property specifies the height (in rows) of the control. A Multiple propriedade especifica se mais de um item pode ser selecionado simultaneamente no HtmlSelect controle.The Multiple property specifies whether more than one item can be concurrently selected in the HtmlSelect control.
Por padrão, o HtmlSelect controle é exibido como uma caixa de listagem suspensa.By default, the HtmlSelect control is displayed as a drop-down list box. Se você permitir várias seleções (definindo a Multiple propriedade como true ) ou especificar uma altura maior que uma linha (definindo a Size propriedade com um valor maior que 1 ), o controle será exibido como uma caixa de listagem.If you allow multiple selections (by setting the Multiple property to true) or specify a height greater than one row (by setting the Size property to a value greater than 1), the control is displayed as a list box.
Para determinar o item selecionado em um controle de seleção única HtmlSelect , use a SelectedIndex propriedade para obter o índice do item selecionado.To determine the selected item in a single-selection HtmlSelect control, use the SelectedIndex property to get the index of the selected item. Você pode usar esse valor para recuperar o item da Items coleção.You can then use this value to retrieve the item from the Items collection.
Para determinar os itens selecionados de um HtmlSelect controle que permite várias seleções, itere na Items coleção e teste a ListItem.Selected propriedade de cada item.To determine the selected items from an HtmlSelect control that allows multiple selections, iterate through the Items collection and test the ListItem.Selected property of each item.
A HtmlSelect classe fornece duas propriedades para dar suporte à vinculação de dados.The HtmlSelect class provides two properties to support data binding. Para associar dados a qualquer objeto que implemente a System.Collections.IEnumerable interface (como System.Data.DataView , System.Collections.ArrayList , e System.Collections.Generic.List<T> ), ou a IListSource interface, use a DataSource propriedade para especificar a fonte de dados à qual associar.To bind data to any object that implements the System.Collections.IEnumerable interface (such as System.Data.DataView, System.Collections.ArrayList, and System.Collections.Generic.List<T>), or the IListSource interface, use the DataSource property to specify the data source to bind to. Ao definir a DataSource propriedade, você deve escrever manualmente o código para executar a vinculação de dados.When you set the DataSource property, you must manually write the code to perform the data binding. Para associar automaticamente um HtmlSelect controle a uma fonte de dados representada por um controle da fonte de dados, use a DataSourceID propriedade e defina seu valor como a ID Propriedade do controle da fonte de dados a ser usada.To automatically bind an HtmlSelect control to a data source represented by a data source control, use the DataSourceID property and set its value to the ID property of the data source control to use. Quando você define a DataSourceID propriedade, o HtmlSelect controle é automaticamente associado ao controle da fonte de dados especificado.When you set the DataSourceID property, the HtmlSelect control automatically binds to the specified data source control. Portanto, você não precisa chamar o DataBind método explicitamente.Therefore, you do not need to explicitly call the DataBind method.
Você também pode especificar quais campos na fonte de dados se associam ListItem.Text às ListItem.Value Propriedades e de um item no controle definindo as DataTextField Propriedades e DataValueField , respectivamente.You can also specify which fields in the data source bind to the ListItem.Text and ListItem.Value properties of an item in the control by setting the DataTextField and DataValueField properties, respectively. Se a fonte de dados contiver várias fontes de dados, use a DataMember propriedade para especificar a origem específica a ser associada ao controle.If the data source contains multiple sources of data, use the DataMember property to specify the specific source to bind to the control. Por exemplo, se você tiver um System.Data.DataSet objeto com várias tabelas, deverá especificar qual tabela deve ser associada ao controle com a DataMember propriedade.For example, if you have a System.Data.DataSet object with multiple tables, you must specify which table to bind to the control with the DataMember property.
Para obter uma lista de valores de propriedade inicial para uma instância do HtmlSelect , consulte o HtmlSelect Construtor.For a list of initial property values for an instance of HtmlSelect, see the HtmlSelect constructor.
Construtores
| HtmlSelect() |
Inicializa uma nova instância da classe HtmlSelect.Initializes a new instance of the HtmlSelect class. |
Propriedades
| Adapter |
Obtém o adaptador específico de navegador para o controle.Gets the browser-specific adapter for the control. (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.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control. (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.Gets a collection of all attribute name and value pairs expressed on a server control tag within the ASP.NET page. (Herdado de HtmlControl) |
| BindingContainer |
Obtém o controle que contém a vinculação de dados desse controle.Gets the control that contains this control's data binding. (Herdado de Control) |
| ChildControlsCreated |
Obtém um valor que indica se os controles filho do controle de servidor foram criados.Gets a value that indicates whether the server control's child controls have been created. (Herdado de Control) |
| ClientID |
Obtém a ID de controle de marcação HTML gerada pelo ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET. (Herdado de Control) |
| ClientIDMode |
Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property. (Herdado de Control) |
| ClientIDSeparator |
Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID.Gets a character value representing the separator character used in the ClientID property. (Herdado de Control) |
| Context |
Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual.Gets the HttpContext object associated with the server control for the current Web request. (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.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy. (Herdado de Control) |
| DataItemContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer. (Herdado de Control) |
| DataKeysContainer |
Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl.Gets a reference to the naming container if the naming container implements 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.Gets or sets the set of data to bind to the HtmlSelect control from a DataSource property with multiple sets of data. |
| DataSource |
Obtém ou define a origem das informações para associar ao controle HtmlSelect.Gets or sets the source of information to bind to the HtmlSelect control. |
| 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.Gets or sets the ID property of the data source control that the HtmlSelect control should use to retrieve its data source. |
| DataTextField |
Obtém ou define o campo da fonte de dados para associar à propriedade Text de cada item no controle HtmlSelect.Gets or sets the field from the data source to bind to the Text property of each item in the HtmlSelect control. |
| DataValueField |
Obtém ou define o campo da fonte de dados para associar à propriedade Value de cada item no controle HtmlSelect.Gets or sets the field from the data source to bind to the Value property of each item in the HtmlSelect control. |
| DesignMode |
Obtém um valor que indica se um controle está sendo usado em uma superfície de design.Gets a value indicating whether a control is being used on a design surface. (Herdado de Control) |
| Disabled |
Obtém ou define um valor que indica se o controle do servidor HTML está desabilitado.Gets or sets a value indicating whether the HTML server control is disabled. (Herdado de HtmlControl) |
| EnableTheming |
Obtém ou define um valor que indica se os temas se aplicam a esse controle.Gets or sets a value indicating whether themes apply to this control. (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.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client. (Herdado de Control) |
| Events |
Obtém uma lista de delegados de manipulador de eventos para o controle.Gets a list of event handler delegates for the control. Essa propriedade é somente leitura.This property is read-only. (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.Gets a value indicating whether the current server control's child controls have any saved view-state settings. (Herdado de Control) |
| ID |
Obtém ou define o identificador programático atribuído ao controle de servidor.Gets or sets the programmatic identifier assigned to the server control. (Herdado de Control) |
| IdSeparator |
Obtém o caractere usado para separar identificadores de controle.Gets the character used to separate control identifiers. (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.Gets or sets the content between the opening and closing tags of the control without automatically converting special characters to their equivalent HTML entities. Não há suporte para a propriedade neste controle.This property is not supported for this control. |
| 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.Gets or sets the content between the opening and closing tags of the control with automatic conversion of special characters to their equivalent HTML entities. Não há suporte para a propriedade neste controle.This property is not supported for this control. |
| IsBoundUsingDataSourceID |
Obtém um valor que indica se uma propriedade DataSourceID é definida para o controle HtmlSelect.Gets a value indicating whether a DataSourceID property is defined for the HtmlSelect control. |
| IsChildControlStateCleared |
Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle.Gets a value indicating whether controls contained within this control have control state. (Herdado de Control) |
| IsTrackingViewState |
Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição.Gets a value that indicates whether the server control is saving changes to its view state. (Herdado de Control) |
| IsViewStateEnabled |
Obtém um valor que indica se o estado de exibição está habilitado para esse controle.Gets a value indicating whether view state is enabled for this control. (Herdado de Control) |
| Items |
Obtém uma coleção que contém os itens listados em um controle HtmlSelect.Gets a collection that contains the items listed in an HtmlSelect control. |
| LoadViewStateByID |
Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice.Gets a value indicating whether the control participates in loading its view state by ID instead of index. (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.Gets or sets a value indicating whether multiple items can be selected concurrently in the HtmlSelect control. |
| Name |
Obtém ou define o nome de identificador associado ao controle HtmlSelect.Gets or sets the unique identifier name associated with the HtmlSelect control. |
| 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.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value. (Herdado de Control) |
| Page |
Obtém uma referência para a instância Page que contém o controle de servidor.Gets a reference to the Page instance that contains the server control. (Herdado de Control) |
| Parent |
Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página.Gets a reference to the server control's parent control in the page control hierarchy. (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.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with. (Herdado de Control) |
| RequiresDataBinding |
Obtém ou define um valor que indica se o controle HtmlSelect precisa se associar à respectiva fonte de dados especificada.Gets or sets a value indicating whether the HtmlSelect control needs to bind to its specified data source. |
| SelectedIndex |
Obtém ou define o índice ordinal do item selecionado no controle HtmlSelect.Gets or sets the ordinal index of the selected item in an HtmlSelect control. |
| 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.Gets a collection that contains the zero-based indexes of all currently selected items in the HtmlSelect control. |
| Site |
Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design.Gets information about the container that hosts the current control when rendered on a design surface. (Herdado de Control) |
| Size |
Obtém ou define a altura (em linhas) do controle HtmlSelect.Gets or sets the height (in rows) of the HtmlSelect control. |
| SkinID |
Obtém ou define a capa a ser aplicada ao controle.Gets or sets the skin to apply to the control. (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.Gets a collection of all cascading style sheet (CSS) properties applied to a specified HTML server control in the ASP.NET file. (Herdado de HtmlControl) |
| TagName |
Obtém o nome do elemento de uma marca que contém um par de atributo e valor |
| TemplateControl |
Obtém ou define uma referência ao modelo que contém este controle.Gets or sets a reference to the template that contains this control. (Herdado de Control) |
| TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual.Gets the virtual directory of the Page or UserControl that contains the current server control. (Herdado de Control) |
| UniqueID |
Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor.Gets the unique, hierarchically qualified identifier for the server control. (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.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values. (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.Gets the value of the selected item in the HtmlSelect control or sets the SelectedIndex property of the control to the index of the first item in the list with the specified value. |
| 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.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page. (Herdado de Control) |
| ViewStateIgnoresCase |
Obtém um valor que indica se o estado de exibição HtmlControl diferencia maiúsculas de minúsculas.Gets a value that indicates whether the HtmlControl view state is case-sensitive. (Herdado de HtmlControl) |
| ViewStateMode |
Obtém ou define o modo de estado de exibição deste controle.Gets or sets the view-state mode of this control. (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.Gets or sets a value that indicates whether a server control is rendered as UI on the page. (Herdado de Control) |
Métodos
| AddedControl(Control, Int32) |
Chamado após um controle filho ser adicionado à coleção Controls do objeto Control.Called after a child control is added to the Controls collection of the Control object. (Herdado de Control) |
| AddParsedSubObject(Object) |
Adiciona um controle filho analisado ao controle HtmlSelect.Adds a parsed child control to the HtmlSelect control. |
| ApplyStyleSheetSkin(Page) |
Aplica as propriedades de estilo definidas na folha de estilos da página ao controle.Applies the style properties defined in the page style sheet to the control. (Herdado de Control) |
| BeginRenderTracing(TextWriter, Object) |
Inicia o rastreamento de tempo de design de dados de renderização.Begins design-time tracing of rendering data. (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.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page. (Herdado de Control) |
| ClearCachedClientID() |
Define o valor ClientID armazenado em cache como |
| ClearChildControlState() |
Exclui as informações de estado de controle para os controles filho do controle de servidor.Deletes the control-state information for the server control's child controls. (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.Deletes the view-state and control-state information for all the server control's child controls. (Herdado de Control) |
| ClearChildViewState() |
Exclui as informações de estado de exibição para todos os controles filho do controle de servidor.Deletes the view-state information for all the server control's child controls. (Herdado de Control) |
| ClearEffectiveClientIDMode() |
Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit. (Herdado de Control) |
| ClearSelection() |
Limpa a seleção de lista do controle HtmlSelect e define a propriedade Selected de todos os itens como |
| 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.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering. (Herdado de Control) |
| CreateControlCollection() |
Cria um objeto EmptyControlCollection para o controle HtmlSelect.Creates an EmptyControlCollection object for the HtmlSelect control. |
| DataBind() |
Associa uma fonte de dados ao controle de servidor chamado e a todos os seus controles filho.Binds a data source to the invoked server control and all its child controls. (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.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event. (Herdado de Control) |
| DataBindChildren() |
Associa uma fonte de dados aos controles filho do controle do servidor.Binds a data source to the server control's child controls. (Herdado de Control) |
| Dispose() |
Permite que um controle de servidor execute a limpeza final antes do lançamento da memória.Enables a server control to perform final clean up before it is released from memory. (Herdado de Control) |
| EndRenderTracing(TextWriter, Object) |
Encerra o rastreamento de tempo de design de dados de renderização.Ends design-time tracing of rendering data. (Herdado de Control) |
| EnsureChildControls() |
Determinará se o controle de servidor contiver controles filho.Determines whether the server control contains child controls. Se ele não contiver, ele criará controles filho.If it does not, it creates child controls. (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().Verifies that the HtmlSelect control requires data binding and that a valid data source control is specified before calling the DataBind() method. |
| EnsureID() |
Cria um identificador para controles que não têm um identificador atribuído.Creates an identifier for controls that do not have an identifier assigned. (Herdado de Control) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object. (Herdado de Object) |
| FindControl(String) |
Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro |
| FindControl(String, Int32) |
Procura o contêiner de nomenclatura atual para um controle de servidor com o |
| Focus() |
Define o foco de entrada para um controle.Sets input focus to a control. (Herdado de Control) |
| GetAttribute(String) |
Obtém o valor do atributo nomeado no controle HtmlControl.Gets the value of the named attribute on the HtmlControl control. (Herdado de HtmlControl) |
| GetData() |
Obtém um objeto IEnumerable que representa a fonte de dados associada ao controle HtmlSelect.Gets an IEnumerable object that represents the data source that is bound to the HtmlSelect control. |
| GetDesignModeState() |
Obtém os dados de tempo de design para um controle.Gets design-time data for a control. (Herdado de Control) |
| GetHashCode() |
Serve como a função de hash padrão.Serves as the default hash function. (Herdado de Object) |
| GetRouteUrl(Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota.Gets the URL that corresponds to a set of route parameters. (Herdado de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota.Gets the URL that corresponds to a set of route parameters. (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.Gets the URL that corresponds to a set of route parameters and a route name. (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.Gets the URL that corresponds to a set of route parameters and a route name. (Herdado de Control) |
| GetType() |
Obtém o Type da instância atual.Gets the Type of the current instance. (Herdado de Object) |
| GetUniqueIDRelativeTo(Control) |
Retorna a parte prefixada da propriedade UniqueID do controle especificado.Returns the prefixed portion of the UniqueID property of the specified control. (Herdado de Control) |
| HasControls() |
Determina se o controle de servidor contém algum controle filho.Determines if the server control contains any child controls. (Herdado de Control) |
| HasEvents() |
Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho.Returns a value indicating whether events are registered for the control or any child controls. (Herdado de Control) |
| IsLiteralContent() |
Determina se o controle de servidor contém apenas o conteúdo literal.Determines if the server control holds only literal content. (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().Restores control-state information from a previous page request that was saved by the SaveControlState() method. (Herdado de Control) |
| LoadPostData(String, NameValueCollection) |
Processa os dados de postback para o controle HtmlSelect.Processes the postback data for the HtmlSelect control. |
| 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().Restores the HtmlSelect control's view state information from a previous page request that was saved by the SaveViewState() method. |
| MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual.Retrieves the physical path that a virtual path, either absolute or relative, maps to. (Herdado de Control) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object. (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.Determines whether the event for the server control is passed up the page's UI server control hierarchy. (Herdado de Control) |
| OnDataBinding(EventArgs) |
Aciona o evento DataBinding de um controle HtmlSelect.Raises the DataBinding event of an HtmlSelect control. |
| OnDataPropertyChanged() |
É invocado quando a propriedade DataSource, DataMember ou DataSourceID é alterada.Invoked when the DataSource, DataMember, or DataSourceID property is changed. |
| OnDataSourceViewChanged(Object, EventArgs) |
É invocado quando a propriedade DataSource, DataMember ou DataSourceID é alterada.Invoked when the DataSource, DataMember, or DataSourceID property is changed. |
| OnInit(EventArgs) |
Aciona o evento Init do controle HtmlSelect.Raises the Init event for the HtmlSelect control. |
| OnInit(EventArgs) |
Aciona o evento Init.Raises the Init event. (Herdado de Control) |
| OnLoad(EventArgs) |
Aciona o evento Load do controle HtmlSelect.Raises the Load event for the HtmlSelect control. |
| OnLoad(EventArgs) |
Aciona o evento Load.Raises the Load event. (Herdado de Control) |
| OnPreRender(EventArgs) |
Aciona o evento PreRender do controle HtmlSelect.Raises the PreRender event for the HtmlSelect control. |
| OnServerChange(EventArgs) |
Aciona o evento ServerChange do controle HtmlSelect.Raises the ServerChange event of the HtmlSelect control. Isso permite que você forneça um manipulador personalizado para o evento.This allows you to provide a custom handler for the event. |
| OnUnload(EventArgs) |
Aciona o evento Unload.Raises the Unload event. (Herdado de Control) |
| OpenFile(String) |
Obtém um Stream usado para ler um arquivo.Gets a Stream used to read a file. (Herdado de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Atribui quaisquer fontes de evento e suas informações para o pai do controle.Assigns any sources of the event and its information to the control's parent. (Herdado de Control) |
| RaisePostDataChangedEvent() |
Chama o método OnServerChange(EventArgs) para sinalizar ao controle HtmlSelect que o estado do controle foi alterado.Calls the OnServerChange(EventArgs) method to signal the HtmlSelect control that the state of the control has changed. |
| RemovedControl(Control) |
Chamado após um controle filho ser removido da coleção Controls do objeto Control.Called after a child control is removed from the Controls collection of the Control object. (Herdado de Control) |
| Render(HtmlTextWriter) |
Renderiza o controle HtmlContainerControl no objeto HtmlTextWriter especificado.Renders the HtmlContainerControl control to the specified HtmlTextWriter object. (Herdado de HtmlContainerControl) |
| RenderAttributes(HtmlTextWriter) |
Renderiza os atributos do controle HtmlSelect no objeto HtmlTextWriter especificado.Renders the HtmlSelect control's attributes to the specified HtmlTextWriter object. |
| RenderBeginTag(HtmlTextWriter) |
Renderiza a marca HTML de abertura do controle para o objeto HtmlTextWriter especificado.Renders the opening HTML tag of the control into the specified HtmlTextWriter object. (Herdado de HtmlControl) |
| RenderChildren(HtmlTextWriter) |
Renderiza os controles filho do controle HtmlSelect no objeto HtmlTextWriter especificado.Renders the HtmlSelect control's child controls to the specified HtmlTextWriter object. |
| 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.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled. (Herdado de Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object. (Herdado de Control) |
| RenderEndTag(HtmlTextWriter) |
Renderiza a marca de fechamento para o controle HtmlContainerControl no objeto HtmlTextWriter especificado.Renders the closing tag for the HtmlContainerControl control to the specified HtmlTextWriter object. (Herdado de HtmlContainerControl) |
| ResolveAdapter() |
Obtém o adaptador de controle responsável por renderizar o controle especificado.Gets the control adapter responsible for rendering the specified control. (Herdado de Control) |
| ResolveClientUrl(String) |
Obtém uma URL que pode ser usada pelo navegador.Gets a URL that can be used by the browser. (Herdado de Control) |
| ResolveUrl(String) |
Converte uma URL em uma que possa ser usada no cliente solicitante.Converts a URL into one that is usable on the requesting client. (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.Saves any server control state changes that have occurred since the time the page was posted back to the server. (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.Saves any HtmlSelect control view state changes that have occurred since the page was posted back to the server. |
| Select(Int32[]) |
Selecione vários itens da coleção Items do controle HtmlSelect.Selects multiple items of the HtmlSelect control's Items collection. |
| SetAttribute(String, String) |
Define o valor do atributo nomeado no controle HtmlControl.Sets the value of the named attribute on the HtmlControl control. (Herdado de HtmlControl) |
| SetDesignModeState(IDictionary) |
Define os dados de tempo de design para um controle.Sets design-time data for a control. (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.Assigns an event handler delegate to render the server control and its content into its parent control. (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.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value. (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.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value. (Herdado de Control) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object. (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.Tracks view state changes to the HtmlSelect control so the changes can be stored in the control's StateBag object. Esse objeto é acessível por meio da propriedade ViewState.This object is accessible through the ViewState property. |
Eventos
| DataBinding |
Ocorre quando o controle de servidor é associado a uma fonte de dados.Occurs when the server control binds to a data source. (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.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested. (Herdado de Control) |
| Init |
Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida.Occurs when the server control is initialized, which is the first step in its lifecycle. (Herdado de Control) |
| Load |
Ocorre quando o controle de servidor é carregado no objeto Page.Occurs when the server control is loaded into the Page object. (Herdado de Control) |
| PreRender |
Ocorre depois que o objeto Control é carregado, mas antes da renderização.Occurs after the Control object is loaded but prior to rendering. (Herdado de Control) |
| ServerChange |
Ocorre quando os itens selecionados no controle de HtmlSelect se alteram entre as postagens no servidor.Occurs when the selected items in the HtmlSelect control change between posts to the server. |
| Unload |
Ocorre quando o controle de servidor é descarregado da memória.Occurs when the server control is unloaded from memory. (Herdado de Control) |
Implantações explícitas de interface
| IAttributeAccessor.GetAttribute(String) |
Para obter uma descrição desse membro, confira GetAttribute(String).For a description of this member, see GetAttribute(String). (Herdado de HtmlControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Para obter uma descrição desse membro, confira SetAttribute(String, String).For a description of this member, see SetAttribute(String, String). (Herdado de HtmlControl) |
| IControlBuilderAccessor.ControlBuilder |
Para obter uma descrição desse membro, confira ControlBuilder.For a description of this member, see ControlBuilder. (Herdado de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Para obter uma descrição desse membro, confira GetDesignModeState().For a description of this member, see GetDesignModeState(). (Herdado de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary). (Herdado de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Para obter uma descrição desse membro, confira SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control). (Herdado de Control) |
| IControlDesignerAccessor.UserData |
Para obter uma descrição desse membro, confira UserData.For a description of this member, see UserData. (Herdado de Control) |
| IDataBindingsAccessor.DataBindings |
Para obter uma descrição desse membro, confira DataBindings.For a description of this member, see DataBindings. (Herdado de Control) |
| IDataBindingsAccessor.HasDataBindings |
Para obter uma descrição desse membro, confira HasDataBindings.For a description of this member, see HasDataBindings. (Herdado de Control) |
| IExpressionsAccessor.Expressions |
Para obter uma descrição desse membro, confira Expressions.For a description of this member, see Expressions. (Herdado de Control) |
| IExpressionsAccessor.HasExpressions |
Para obter uma descrição desse membro, confira HasExpressions.For a description of this member, see HasExpressions. (Herdado de Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Para obter uma descrição desse membro, confira AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object). (Herdado de Control) |
| IPostBackDataHandler.LoadPostData(String, NameValueCollection) |
Para obter uma descrição desse membro, confira LoadPostData(String, NameValueCollection).For a description of this member, see LoadPostData(String, NameValueCollection). |
| IPostBackDataHandler.RaisePostDataChangedEvent() |
Para obter uma descrição desse membro, confira RaisePostDataChangedEvent().For a description of this member, see RaisePostDataChangedEvent(). |
Métodos de Extensão
| FindDataSourceControl(Control) |
Retorna a fonte de dados associada ao controle de dados do controle especificado.Returns the data source that is associated with the data control for the specified control. |
| FindFieldTemplate(Control, String) |
Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.Returns the field template for the specified column in the specified control's naming container. |
| FindMetaTable(Control) |
Retorna o objeto metatable para o controle que contém dados.Returns the metatable object for the containing data control. |