HtmlSelect Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Permite acesso programático ao elemento HTML <select> 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 IParserAccessorPublic Class HtmlSelect
Inherits HtmlContainerControl
Implements IPostBackDataHandler- Herança
- Atributos
- Implementações
Exemplos
O exemplo de código seguinte demonstra como criar um HtmlSelect controlo declarando explicitamente os itens que aparecem no controlo.
<%@ 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 seguinte demonstra como criar um HtmlSelect controlo ligando o controlo 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 seguinte demonstra como usar a DataSourceID propriedade para especificar a fonte de dados de um HtmlSelect controlo. A DataSourceID propriedade é definida para a ID propriedade do SqlDataSource controlo usado para recuperar os dados. Quando a página é carregada, o controlo HtmlSelect liga-se automaticamente à fonte de dados especificada pelo SqlDataSource controlo e os dados são exibidos ao utilizador.
<%@ 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>
Observações
Use o HtmlSelect controlo para criar uma caixa de seleção. Especifique as listagens de itens no controlo colocando elementos HTML <option> entre as etiquetas de abertura e fecho <select> . Cada item é representado por um System.Web.UI.WebControls.ListItem objeto. Para especificar o texto que é exibido para cada item no controlo, pode definir a ListItem.Text propriedade do item, ou simplesmente colocar texto entre as etiquetas de abertura e fecho <option> . Ao definir a ListItem.Value propriedade do item, pode associar um valor ao item que é diferente do texto. Para selecionar um item da lista por defeito, defina a ListItem.Selected propriedade do item para true.
Pode controlar a aparência e o comportamento do HtmlSelect controlo definindo as Size propriedades e Multiple . A Size propriedade especifica a altura (em linhas) do controlo. A Multiple propriedade especifica se mais do que um item pode ser selecionado simultaneamente no HtmlSelect controlo.
Por defeito, o HtmlSelect controlo é apresentado como uma caixa de lista suspensa. Se permitir múltiplas seleções (definindo a Multiple propriedade para true) ou especificar uma altura superior a uma linha (definindo a Size propriedade para um valor superior a 1), o controlo é apresentado como uma caixa de lista.
Para determinar o item selecionado num controlo de seleção HtmlSelect única, use a SelectedIndex propriedade para obter o índice do item selecionado. Pode então usar esse valor para recuperar o item da Items coleção.
Para determinar os itens selecionados a partir de um HtmlSelect controlo que permite múltiplas seleções, itere pela Items coleção e teste a ListItem.Selected propriedade de cada item.
A HtmlSelect classe fornece duas propriedades para suportar a ligação de dados. 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 a que se deve ligar. Quando defines a DataSource propriedade, tens de escrever manualmente o código para realizar a ligação de dados. Para associar automaticamente um HtmlSelect controlo a uma fonte de dados representada por um controlo de fonte de dados, use a DataSourceID propriedade e defina o seu valor para a ID propriedade do controlo de fonte de dados a utilizar. Quando defines a DataSourceID propriedade, o controlo HtmlSelect liga-se automaticamente ao controlo de fonte de dados especificado. Portanto, não precisa de chamar explicitamente o DataBind método.
Também pode especificar quais os campos na fonte de dados que se associam às ListItem.Text propriedades e ListItem.Value de um item no controlo, definindo as DataTextField propriedades e DataValueField respetivamente. Se a fonte de dados contiver múltiplas fontes de dados, use a DataMember propriedade para especificar a fonte específica a vincular ao controlo. Por exemplo, se tiver um System.Data.DataSet objeto com várias tabelas, deve especificar qual tabela atribuir ao controlo com a DataMember propriedade.
Para obter uma lista de valores das propriedades iniciais de uma instância de HtmlSelect, consulte o construtor HtmlSelect.
Construtores
| Name | Description |
|---|---|
| HtmlSelect() |
Inicializa uma nova instância da HtmlSelect classe. |
Propriedades
| Name | Description |
|---|---|
| Adapter |
Recebe o adaptador específico do navegador para o controlo. (Herdado de Control) |
| AppRelativeTemplateSourceDirectory |
Obtém ou define o diretório virtual relativo à aplicação do Page objeto ou UserControl que contém este controlo. (Herdado de Control) |
| Attributes |
Obtém uma coleção de todos os pares de nome e valor de atributos expressos numa tag de controlo de servidor dentro da página ASP.NET. (Herdado de HtmlControl) |
| BindingContainer |
Obtém o controlo que contém a ligação de dados desse controlo. (Herdado de Control) |
| ChildControlsCreated |
Recebe um valor que indica se os controlos filhos do controlo do servidor foram criados. (Herdado de Control) |
| ClientID |
Obtém o ID de controlo para a marcação HTML gerada pelo ASP.NET. (Herdado de Control) |
| ClientIDMode |
Obtém ou define o algoritmo que é usado para gerar o valor da ClientID propriedade. (Herdado de Control) |
| ClientIDSeparator |
Obtém um valor de carácter que representa o carácter separador usado na ClientID propriedade. (Herdado de Control) |
| Context |
Obtém o controlo do HttpContext objeto associado ao servidor para o pedido Web atual. (Herdado de Control) |
| Controls |
Obtém um ControlCollection objeto que representa os controlos filhos de um servidor especificado na hierarquia da interface. (Herdado de Control) |
| DataItemContainer |
Obtém uma referência ao contentor de nomes se o contentor implementar IDataItemContainer. (Herdado de Control) |
| DataKeysContainer |
Obtém uma referência ao contentor de nomes se o contentor implementar IDataKeysControl. (Herdado de Control) |
| DataMember |
Obtém ou define o conjunto de dados para se ligar ao HtmlSelect controlo a partir de uma DataSource propriedade com múltiplos conjuntos de dados. |
| DataSource |
Obtém ou define a fonte de informação para se ligar ao HtmlSelect controlo. |
| DataSourceID |
Obtém ou define a ID propriedade do controlo de fonte de dados que o HtmlSelect controlo deve usar para recuperar a sua fonte de dados. |
| DataTextField |
Obtém ou define o campo da fonte de dados para se ligar à Text propriedade de cada item no HtmlSelect controlo. |
| DataValueField |
Obtém ou define o campo da fonte de dados para se ligar à Value propriedade de cada item no HtmlSelect controlo. |
| DesignMode |
Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto. (Herdado de Control) |
| Disabled |
Recebe ou define um valor que indica se o controlo do servidor HTML está desativado. (Herdado de HtmlControl) |
| EnableTheming |
Recebe ou define um valor que indica se os temas se aplicam a este controlo. (Herdado de Control) |
| EnableViewState |
Recebe ou define um valor que indica se o controlo do servidor mantém o seu estado de visualização, e o estado de vista de quaisquer controlos filhos que contém, para o cliente solicitante. (Herdado de Control) |
| Events |
Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura. (Herdado de Control) |
| HasChildViewState |
Recebe um valor que indica se os controlos filhos do controlo atual do servidor têm alguma configuração de estado de visualização guardada. (Herdado de Control) |
| ID |
Obtém ou define o identificador programático atribuído ao controlo do servidor. (Herdado de Control) |
| IdSeparator |
Faz com que o carácter seja usado para separar identificadores de controlo. (Herdado de Control) |
| InnerHtml |
Obtém ou define o conteúdo entre as etiquetas de abertura e fecho do controlo sem converter automaticamente caracteres especiais para as suas entidades HTML equivalentes. Esta propriedade não é suportada para este controlo. |
| InnerText |
Obtém ou define o conteúdo entre as etiquetas de abertura e fecho do controlo com conversão automática de caracteres especiais para as suas entidades HTML equivalentes. Esta propriedade não é suportada para este controlo. |
| IsBoundUsingDataSourceID |
Obtém um valor que indica se uma DataSourceID propriedade está definida para o HtmlSelect controlo. |
| IsChildControlStateCleared |
Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo. (Herdado de Control) |
| IsTrackingViewState |
Recebe um valor que indica se o controlo do servidor está a guardar alterações ao estado de visualização. (Herdado de Control) |
| IsViewStateEnabled |
Recebe um valor que indica se o estado de visualização está ativado para este controlo. (Herdado de Control) |
| Items |
Obtém uma coleção que contém os itens listados num HtmlSelect controlo. |
| LoadViewStateByID |
Recebe um valor que indica se o controlo participa no carregamento do seu estado de visualização em ID vez de index. (Herdado de Control) |
| Multiple |
Recebe ou define um valor que indica se múltiplos itens podem ser selecionados simultaneamente no HtmlSelect controlo. |
| Name |
Obtém ou define o nome do identificador único associado ao HtmlSelect controlo. |
| NamingContainer |
Obtém uma referência ao contentor de nomes do controlo do servidor, que cria um namespace único para diferenciar controlos de servidor com o mesmo ID valor de propriedade. (Herdado de Control) |
| Page |
Obtém uma referência à Page instância que contém o controlo do servidor. (Herdado de Control) |
| Parent |
Obtém uma referência ao controlo pai do controlo do servidor na hierarquia de controlo de página. (Herdado de Control) |
| RenderingCompatibility |
Recebe um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control) |
| RequiresDataBinding |
Recebe ou define um valor que indica se o controlo HtmlSelect precisa de se ligar à sua fonte de dados especificada. |
| SelectedIndex |
Obtém ou define o índice ordinal do item selecionado num HtmlSelect controlo. |
| SelectedIndices |
Obtém uma coleção que contém os índices baseados em zero de todos os itens atualmente selecionados no HtmlSelect controlo. |
| Site |
Obtém informação sobre o contentor que aloja o controlo atual quando renderizado numa superfície de design. (Herdado de Control) |
| Size |
Obtém ou define a altura (em filas) do HtmlSelect controlo. |
| SkinID |
Obtém ou fixa a pele para aplicar no controlo. (Herdado de Control) |
| Style |
Obtém uma coleção de todas as propriedades de folhas de estilo em cascata (CSS) aplicadas a um controlo de servidor HTML especificado no ficheiro ASP.NET. (Herdado de HtmlControl) |
| TagName |
Obtém o nome do elemento de uma etiqueta que contém um |
| TemplateControl |
Recebe ou define uma referência ao template que contém esse controlo. (Herdado de Control) |
| TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controlo atual do servidor. (Herdado de Control) |
| UniqueID |
Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor. (Herdado de Control) |
| ValidateRequestMode |
Recebe ou define um valor que indica se o controlo verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control) |
| Value |
Obtém o valor do item selecionado no HtmlSelect controlo ou define a SelectedIndex propriedade do controlo para o índice do primeiro item da lista com o valor especificado. |
| ViewState |
Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um controlo de servidor através de múltiplos pedidos para a mesma página. (Herdado de Control) |
| ViewStateIgnoresCase |
Obtém um valor que indica se o HtmlControl estado da vista é sensível a maiúsculas e minúsculas. (Herdado de HtmlControl) |
| ViewStateMode |
Obtém ou define o modo view-state deste controlo. (Herdado de Control) |
| Visible |
Recebe ou define um valor que indica se um controlo de servidor é renderizado como UI na página. (Herdado de Control) |
Métodos
| Name | Description |
|---|---|
| AddedControl(Control, Int32) |
Chamado após um controlo filho ser adicionado à Controls coleção do Control objeto. (Herdado de Control) |
| AddParsedSubObject(Object) |
Adiciona um controlo filho analisado ao HtmlSelect controlo. |
| ApplyStyleSheetSkin(Page) |
Aplica as propriedades de estilo definidas na folha de estilo da página ao controlo. (Herdado de Control) |
| BeginRenderTracing(TextWriter, Object) |
Inicia o rastreio em tempo de design dos dados de renderização. (Herdado de Control) |
| BuildProfileTree(String, Boolean) |
Recolhe informações sobre o controlo do servidor e entrega-as à Trace propriedade para serem exibidas quando o rastreamento for ativado para a página. (Herdado de Control) |
| ClearCachedClientID() |
Define o valor em ClientID cache para |
| ClearChildControlState() |
Apaga a informação de estado de controlo dos controlos filhos do controlo do servidor. (Herdado de Control) |
| ClearChildState() |
Apaga a informação de view-state e control-state de todos os controlos filhos do servidor. (Herdado de Control) |
| ClearChildViewState() |
Elimina a informação de estado de visualização de todos os controlos filhos do controlo do servidor. (Herdado de Control) |
| ClearEffectiveClientIDMode() |
Define a ClientIDMode propriedade da instância de controlo atual e de qualquer controlo filho para Inherit. (Herdado de Control) |
| ClearSelection() |
Limpa a seleção de lista do HtmlSelect controlo e define a Selected propriedade de todos os itens para |
| CreateChildControls() |
Chamada pelo framework de páginas ASP.NET para notificar os controlos de servidor que utilizam implementação baseada em composição para criar quaisquer controlos filhos que contenham em preparação para publicação ou renderização. (Herdado de Control) |
| CreateControlCollection() |
Cria um EmptyControlCollection objeto para o HtmlSelect controlo. |
| DataBind() |
Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos. (Herdado de Control) |
| DataBind(Boolean) |
Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos com uma opção para elevar o DataBinding evento. (Herdado de Control) |
| DataBindChildren() |
Vincula uma fonte de dados aos controlos filhos do controlo do servidor. (Herdado de Control) |
| Dispose() |
Permite que o controlo do servidor realize a limpeza final antes de ser libertado da memória. (Herdado de Control) |
| EndRenderTracing(TextWriter, Object) |
Termina o rastreio de tempo de design dos dados de renderização. (Herdado de Control) |
| EnsureChildControls() |
Determina se o controlo do servidor contém controlos filhos. Se não o fizer, cria controlos filhos. (Herdado de Control) |
| EnsureDataBound() |
Verifica que o controlo HtmlSelect requer ligação de dados e que um controlo de fonte de dados válido está especificado antes de chamar o DataBind() método. |
| EnsureID() |
Cria um identificador para controlos 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, Int32) |
Pesquisa no contentor de nomenclatura atual um controlo de servidor com o especificado |
| FindControl(String) |
Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado |
| Focus() |
Define o foco de entrada num controlo. (Herdado de Control) |
| GetAttribute(String) |
Obtém o valor do atributo nomeado no HtmlControl controlo. (Herdado de HtmlControl) |
| GetData() |
Obtém um IEnumerable objeto que representa a fonte de dados ligada ao HtmlSelect controlo. |
| GetDesignModeState() |
Obtém dados de tempo de projeto para um controlo. (Herdado de Control) |
| GetHashCode() |
Serve como função de hash predefinida. (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 o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetUniqueIDRelativeTo(Control) |
Devolve a parte prefixada da UniqueID propriedade do controlo especificado. (Herdado de Control) |
| HasControls() |
Determina se o controlo do servidor contém algum controlo filho. (Herdado de Control) |
| HasEvents() |
Devolve um valor que indica se os eventos estão registados para o controlo ou para quaisquer controlos filhos. (Herdado de Control) |
| IsLiteralContent() |
Determina se o controlo do servidor contém apenas conteúdo literal. (Herdado de Control) |
| LoadControlState(Object) |
Restaura a informação do estado de controlo a partir de um pedido de página anterior que foi guardado pelo SaveControlState() método. (Herdado de Control) |
| LoadPostData(String, NameValueCollection) |
Processa os dados de postback para o HtmlSelect controlo. |
| LoadViewState(Object) |
Restaura a HtmlSelect informação do estado de vista do controlo de um pedido de página anterior que foi guardado pelo SaveViewState() método. |
| MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual, seja absoluto ou relativo, mapeia. (Herdado de Control) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnBubbleEvent(Object, EventArgs) |
Determina se o evento para o controlo do servidor é passado para a hierarquia de controlo do servidor UI da página. (Herdado de Control) |
| OnDataBinding(EventArgs) |
Aumenta o DataBinding evento de um HtmlSelect controlo. |
| OnDataPropertyChanged() |
Invocado quando a DataSource, DataMember, ou DataSourceID propriedade é alterada. |
| OnDataSourceViewChanged(Object, EventArgs) |
Invocado quando a DataSource, DataMember, ou DataSourceID propriedade é alterada. |
| OnInit(EventArgs) |
Aumenta o Init evento para o HtmlSelect controlo. |
| OnInit(EventArgs) |
Eleva o Init evento. (Herdado de Control) |
| OnLoad(EventArgs) |
Aumenta o Load evento para o HtmlSelect controlo. |
| OnLoad(EventArgs) |
Eleva o Load evento. (Herdado de Control) |
| OnPreRender(EventArgs) |
Aumenta o PreRender evento para o HtmlSelect controlo. |
| OnServerChange(EventArgs) |
Aumenta o ServerChange evento do HtmlSelect controlo. Isto permite-lhe fornecer um handler personalizado para o evento. |
| OnUnload(EventArgs) |
Eleva o Unload evento. (Herdado de Control) |
| OpenFile(String) |
Recebe um Stream usado para ler um ficheiro. (Herdado de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Atribui quaisquer fontes do evento e da sua informação ao pai do controlo. (Herdado de Control) |
| RaisePostDataChangedEvent() |
Chama o OnServerChange(EventArgs) método para sinalizar ao HtmlSelect controlo que o estado do controlo mudou. |
| RemovedControl(Control) |
Chamado após um controlo filho ser removido da Controls coleção do Control objeto. (Herdado de Control) |
| Render(HtmlTextWriter) |
Renderiza o HtmlContainerControl controlo para o objeto especificado HtmlTextWriter . (Herdado de HtmlContainerControl) |
| RenderAttributes(HtmlTextWriter) |
Renderiza os HtmlSelect atributos do controlo no objeto especificado HtmlTextWriter . |
| RenderBeginTag(HtmlTextWriter) |
Renderiza a tag HTML de abertura do controlo no objeto especificado HtmlTextWriter . (Herdado de HtmlControl) |
| RenderChildren(HtmlTextWriter) |
Renderiza os HtmlSelect controlos filhos do controlo para o objeto especificado HtmlTextWriter . |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control) |
| RenderControl(HtmlTextWriter) |
Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter e armazena informação de rastreamento sobre o controlo se o rastreio estiver ativado. (Herdado de Control) |
| RenderEndTag(HtmlTextWriter) |
Renderiza a etiqueta de fecho do HtmlContainerControl controlo para o objeto especificado HtmlTextWriter . (Herdado de HtmlContainerControl) |
| ResolveAdapter() |
Faz com que o adaptador de controlo seja responsável por renderizar o controlo especificado. (Herdado de Control) |
| ResolveClientUrl(String) |
Recebe um URL que pode ser usado pelo navegador. (Herdado de Control) |
| ResolveUrl(String) |
Converte uma URL numa que seja utilizável no cliente solicitante. (Herdado de Control) |
| SaveControlState() |
Guarda quaisquer alterações no estado de controlo do servidor que tenham ocorrido desde que a página foi publicada de volta no servidor. (Herdado de Control) |
| SaveViewState() |
Guarda quaisquer HtmlSelect alterações no estado da vista de controlo que tenham ocorrido desde que a página foi publicada de volta no servidor. |
| Select(Int32[]) |
Seleciona múltiplos itens da HtmlSelect coleção do Items controlo. |
| SetAttribute(String, String) |
Define o valor do atributo nomeado no HtmlControl controlo. (Herdado de HtmlControl) |
| SetDesignModeState(IDictionary) |
Define dados em tempo de projeto para um controlo. (Herdado de Control) |
| SetRenderMethodDelegate(RenderMethod) |
Atribui um delegado handler de eventos para renderizar o controlo do servidor e o seu conteúdo no controlo pai. (Herdado de Control) |
| SetTraceData(Object, Object, Object) |
Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando o objeto rastreado, a chave de dados de traço e o valor dos dados de traço. (Herdado de Control) |
| SetTraceData(Object, Object) |
Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando a chave de dados de traço e o valor dos dados de traço. (Herdado de Control) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| TrackViewState() |
Acompanha as alterações no estado da vista do HtmlSelect controlo para que as alterações possam ser armazenadas no objeto do StateBag controlo. Este objeto é acessível através da ViewState propriedade. |
evento
| Name | Description |
|---|---|
| DataBinding |
Ocorre quando o controlo do servidor se liga a uma fonte de dados. (Herdado de Control) |
| Disposed |
Ocorre quando um controlo de servidor é libertado da memória, que é a última etapa do ciclo de vida do controlo do servidor quando uma página ASP.NET é solicitada. (Herdado de Control) |
| Init |
Ocorre quando o controlo do servidor é inicializado, que é o primeiro passo no seu ciclo de vida. (Herdado de Control) |
| Load |
Ocorre quando o controlo do servidor é carregado no Page objeto. (Herdado de Control) |
| PreRender |
Ocorre depois do carregamento do Control objeto, mas antes da renderização. (Herdado de Control) |
| ServerChange |
Ocorre quando os itens selecionados no HtmlSelect controlo mudam entre publicações para o servidor. |
| Unload |
Ocorre quando o controlo do servidor é descarregado da memória. (Herdado de Control) |
Implementações de Interface Explícita
Métodos da Extensão
| Name | Description |
|---|---|
| FindDataSourceControl(Control) |
Devolve a fonte de dados associada ao controlo de dados para o controlo especificado. |
| FindFieldTemplate(Control, String) |
Devolve o modelo de campo para a coluna especificada no contentor de nomenclatura do controlo especificado. |
| FindMetaTable(Control) |
Devolve o objeto metatable para o controlo de dados que contém. |