Button 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.
Exibe um controlo por botão na página Web.
public ref class Button : System::Web::UI::WebControls::WebControl, System::Web::UI::IPostBackEventHandlerpublic ref class Button : System::Web::UI::WebControls::WebControl, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::IButtonControlpublic class Button : System.Web.UI.WebControls.WebControl, System.Web.UI.IPostBackEventHandlerpublic class Button : System.Web.UI.WebControls.WebControl, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.IButtonControltype Button = class
inherit WebControl
interface IPostBackEventHandlertype Button = class
inherit WebControl
interface IButtonControl
interface IPostBackEventHandlerPublic Class Button
Inherits WebControl
Implements IPostBackEventHandlerPublic Class Button
Inherits WebControl
Implements IButtonControl, IPostBackEventHandler- Herança
- Implementações
Exemplos
O exemplo de código seguinte demonstra como criar um controlo Submit Button que publica o conteúdo da página Web de volta ao servidor.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Button Example</title>
<script language="C#" runat="server">
void SubmitBtn_Click(Object sender, EventArgs e)
{
Message.Text="Hello World!!";
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Button Example</h3>
Click on the submit button.<br /><br />
<asp:Button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server"/>
<br />
<asp:label id="Message" runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Button Example</title>
<script language="VB" runat="server">
Sub SubmitBtn_Click(sender As Object, e As EventArgs)
Message.Text = "Hello World!!"
End Sub 'SubmitBtn_Click
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Button Example</h3>
Click on the submit button.<br /><br />
<asp:Button id="Button1"
Text="Submit"
OnClick="SubmitBtn_Click"
runat="server"/>
<br />
<asp:label id="Message" runat="server"/>
</form>
</body>
</html>
O exemplo de código seguinte demonstra como criar um controlo de comando Button que ordena uma lista.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Button CommandName Example</title>
<script runat="server">
void CommandBtn_Click(Object sender, CommandEventArgs e)
{
switch(e.CommandName)
{
case "Sort":
// Call the method to sort the list.
Sort_List((String)e.CommandArgument);
break;
case "Submit":
// Display a message for the Submit button being clicked.
Message.Text = "You clicked the Submit button";
// Test whether the command argument is an empty string ("").
if((String)e.CommandArgument == "")
{
// End the message.
Message.Text += ".";
}
else
{
// Display an error message for the command argument.
Message.Text += ", however the command argument is not recogized.";
}
break;
default:
// The command name is not recognized. Display an error message.
Message.Text = "Command name not recogized.";
break;
}
}
void Sort_List(string commandArgument)
{
switch(commandArgument)
{
case "Ascending":
// Insert code to sort the list in ascending order here.
Message.Text = "You clicked the Sort Ascending button.";
break;
case "Descending":
// Insert code to sort the list in descending order here.
Message.Text = "You clicked the Sort Descending button.";
break;
default:
// The command argument is not recognized. Display an error message.
Message.Text = "Command argument not recogized.";
break;
}
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Button CommandName Example</h3>
Click on one of the command buttons.
<br /><br />
<asp:Button id="Button1"
Text="Sort Ascending"
CommandName="Sort"
CommandArgument="Ascending"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button2"
Text="Sort Descending"
CommandName="Sort"
CommandArgument="Descending"
OnCommand="CommandBtn_Click"
runat="server"/>
<br /><br />
<asp:Button id="Button3"
Text="Submit"
CommandName="Submit"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button4"
Text="Unknown Command Name"
CommandName="UnknownName"
CommandArgument="UnknownArgument"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button5"
Text="Submit Unknown Command Argument"
CommandName="Submit"
CommandArgument="UnknownArgument"
OnCommand="CommandBtn_Click"
runat="server"/>
<br /><br />
<asp:Label id="Message" runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Button CommandName Example</title>
<script runat="server">
Sub CommandBtn_Click(sender As Object, e As CommandEventArgs)
Select e.CommandName
Case "Sort"
' Call the method to sort the list.
Sort_List(CType(e.CommandArgument, String))
Case "Submit"
' Display a message for the Submit button being clicked.
Message.Text = "You clicked the Submit button"
' Test whether the command argument is an empty string ("").
If CType(e.CommandArgument , String) = "" Then
' End the message.
Message.Text &= "."
Else
' Display an error message for the command argument.
Message.Text &= ", however the command argument is not recogized."
End If
Case Else
' The command name is not recognized. Display an error message.
Message.Text = "Command name not recogized."
End Select
End Sub
Sub Sort_List(commandArgument As String)
Select commandArgument
Case "Ascending"
' Insert code to sort the list in ascending order here.
Message.Text = "You clicked the Sort Ascending button."
Case "Descending"
' Insert code to sort the list in descending order here.
Message.Text = "You clicked the Sort Descending button."
Case Else
' The command argument is not recognized. Display an error message.
Message.Text = "Command argument not recogized."
End Select
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Button CommandName Example</h3>
Click on one of the command buttons.
<br /><br />
<asp:Button id="Button1"
Text="Sort Ascending"
CommandName="Sort"
CommandArgument="Ascending"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button2"
Text="Sort Descending"
CommandName="Sort"
CommandArgument="Descending"
OnCommand="CommandBtn_Click"
runat="server"/>
<br /><br />
<asp:Button id="Button3"
Text="Submit"
CommandName="Submit"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button4"
Text="Unknown Command Name"
CommandName="UnknownName"
CommandArgument="UnknownArgument"
OnCommand="CommandBtn_Click"
runat="server"/>
<asp:Button id="Button5"
Text="Submit Unknown Command Argument"
CommandName="Submit"
CommandArgument="UnknownArgument"
OnCommand="CommandBtn_Click"
runat="server"/>
<br /><br />
<asp:Label id="Message" runat="server"/>
</form>
</body>
</html>
Observações
Neste tópico:
Introduction
Use o Button controlo para criar um botão na página Web que permite aos utilizadores publicar uma página no servidor. O controlo desencadeia um evento no código do servidor que pode gerir para responder ao postback. Também pode gerar um evento no script do cliente que podes gerir antes da página ser publicada ou que pode ser executado e depois cancelar a submissão da página.
Note
O ASP.NET inclui vários tipos de controlos de botões, cada um dos quais aparece de forma diferente nas páginas Web. São o Button controlo, que renderiza como um botão de pressão; o LinkButton controlo, que renderiza como um link; e o ImageButton controlo, que renderiza como imagem; e o ImageMap controlo, que permite criar um gráfico com hotspots que os utilizadores podem clicar. Por defeito, todos os controlos dos botões submetem a página quando clicados. Também podes usar os HtmlButton controlos and HtmlInputButton para criar botões na página que sejam programáveis em código servidor. Para detalhes sobre as diferenças entre controlos HTML e de servidores Web, consulte ASP.NET Visão Geral dos Controlos de Servidores Web.
Por defeito, um Button controlo é um botão Submeter. Um botão Enviar não tem um nome de comando (especificado pela CommandName propriedade) associado ao botão e simplesmente publica a página Web de volta ao servidor. Pode fornecer um gestor de eventos para o Click evento controlar programaticamente as ações realizadas quando o botão Enviar é clicado.
Um botão de comando tem um nome de comando associado ao botão, como Sort, ao definir a CommandName propriedade. Isto permite-lhe criar múltiplos Button controlos numa página Web e determinar programaticamente qual Button controlo é clicado. Também pode usar a CommandArgument propriedade com um botão de comando para fornecer informações adicionais sobre o comando a executar, como Ascending. Pode fornecer um gestor de eventos para o Command evento controlar programaticamente as ações realizadas quando o botão Comando é clicado.
Comportamento de Postback de Botões e Eventos do Servidor
Quando um utilizador clica em qualquer botão de controlo do servidor Web, a página é enviada para o servidor. Isto faz com que a página Web seja processada e quaisquer eventos pendentes sejam abertos em código baseado em servidor. Quando todo o processamento de página e controlo termina, a página volta a renderizar-se no navegador.
Os botões podem ativar os seus próprios Click eventos ou Command eventos, que podes gerir usando código baseado em servidor. Isto é diferente dos eventos em páginas HTML tradicionais ou em aplicações Web baseadas em cliente, onde o evento de onclick um botão é tratado usando JavaScript que corre no cliente. Para mais informações, consulte ASP.NET Web Forms Server Control Event Model.
Quando os utilizadores clicam num controlo de botão, a página é publicada de volta no servidor. Por defeito, a página é publicada de volta a si própria,
Podes configurar botões para publicar a página atual noutra página. Isto pode ser útil para criar formulários de várias páginas. Para mais detalhes, consulte Cross-Page Posting em ASP.NET Web Forms.
Gestão de Eventos de Botão no Script do Cliente
Os controlos de botões podem elevar tanto eventos do servidor como eventos do cliente. Os eventos do servidor ocorrem após o postback e são tratados no código do lado do servidor que escreves para a página. Os eventos do cliente são tratados em script do cliente, tipicamente ECMAScript (JavaScript), e são levantados antes da submissão da página. Ao adicionar eventos do lado do cliente aos controlos de botões do ASP.NET, pode realizar tarefas como mostrar caixas de diálogo de confirmação antes de submeter a página, e potencialmente cancelar a submissão. Para mais detalhes, veja Client Script em ASP.NET Web Pages e Como: Responder a Eventos de Controlo do Web Server de Botões no Client Script.
Também podes querer que o Button controlo use o script do cliente para realizar o postback (em vez de simplesmente executar uma operação HTTP POST). Isto pode ser útil se quiseres manipular programaticamente o postback, como anexá-lo a outros elementos da página. Podes definir a Button propriedade do UseSubmitBehavior controlo para true fazer com que o Button controlo use postback baseado em scripts cliente.
Controlo de Botões e Validação
Se uma página contiver controlos do validador ASP.NET, por defeito, clicar num controlo de botão faz com que o controlo do validador realize a sua verificação. Se a validação do lado do cliente estiver ativada para um controlo validador, a página não é submetida se uma verificação de validação tiver falhado.
A tabela seguinte descreve as propriedades suportadas pelos controlos de botões que permitem controlar o processo de validação de forma mais precisa.
| Property | Description |
|---|---|
| CausesValidation | Especifica se ao clicar no botão também se realiza uma verificação de validação. Defina esta propriedade para false impedir uma verificação de validação. |
| ValidationGroup | Permite especificar quais os validadores na página que são chamados quando o botão é clicado. Se não forem estabelecidos grupos de validação, um clique de botão chama todos os validadores que estão na página. |
Para mais informações, consulte Validação da Entrada do Utilizador em ASP.NET Páginas Web.
Botões nos Controlos de Dados
Os controlos de servidor Web por botão são frequentemente usados em controlos de dados, como nos DataListcontrolos de , GridView, e Repeater de lista. Nesses casos, normalmente não responde diretamente ao evento de clique no botão. Em vez disso, um botão num controlo de dados gera um evento específico para esse controlo. Por exemplo, no DataList controlo, um botão pode aumentar o DataList evento do ItemCommand controlo em vez de elevar o Button evento do controlo Click .
Como os controlos de listas ligados a dados podem conter muitos botões, pode definir a propriedade do CommandArgument botão para especificar um valor a passar como parte do evento. Depois podes testar este argumento para ver qual botão foi clicado.
Ligar Dados aos Controlos
Pode associar o botão de controlo do servidor web a uma fonte de dados para controlar dinamicamente as suas definições de propriedade. Por exemplo, pode definir a propriedade de Text um botão usando data binding.
Usar Botões com Controlo do Painel de Atualização
A renderização parcial da página permite atualizar partes de uma página sem necessidade de devolução de publicação. UpdatePanel Os controlos permitem-lhe marcar partes da página que participam na renderização parcial da página. Por defeito, o comportamento dos controlos dentro de um UpdatePanel controlo, incluindo Button controlos, é realizar um postback assíncrono em vez de um postback. Isto atualiza apenas o conteúdo do UpdatePanel controlo de onde o postback se origina.
Para além do cenário de um Button controlo que está dentro de um UpdatePanel controlo, pode usar Button controlos com UpdatePanel controlos nos seguintes cenários:
Definir um Button controlo que está fora de um UpdatePanel controlo como um AsyncPostBackTrigger controlo para esse painel. Quando o botão é pressionado, realiza um regresso assíncrono e atualiza o conteúdo do painel.
Definir um Button controlo que está dentro de um UpdatePanel controlo como um PostBackTrigger para o painel. Quando o botão é pressionado, faz um retrocesso mesmo estando dentro de um UpdatePanel controlo.
Para mais informações sobre renderização de páginas parciais e utilização UpdatePanel de controlos, consulte Visão Geral de Controlo do Painel de Atualização e Partial-Page Visão Geral de Renderização.
Sintaxe declarativa
<asp:Button
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CausesValidation="True|False"
CommandArgument="string"
CommandName="string"
CssClass="string"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
OnClick="Click event handler"
OnClientClick="string"
OnCommand="Command event handler"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
PostBackUrl="uri"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
Text="string"
ToolTip="string"
UseSubmitBehavior="True|False"
ValidationGroup="string"
Visible="True|False"
Width="size"
/>
Construtores
| Name | Description |
|---|---|
| Button() |
Inicializa uma nova instância da Button classe. |
Propriedades
| Name | Description |
|---|---|
| AccessKey |
Obtém ou define a chave de acesso que permite navegar rapidamente até ao controlo do servidor Web. (Herdado de WebControl) |
| 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 a coleção de atributos arbitrários (apenas para renderização) que não correspondem a propriedades no controlo. (Herdado de WebControl) |
| BackColor |
Obtém ou define a cor de fundo do controlo do servidor Web. (Herdado de WebControl) |
| BindingContainer |
Obtém o controlo que contém a ligação de dados desse controlo. (Herdado de Control) |
| BorderColor |
Obtém ou define a cor da borda do controlo Web. (Herdado de WebControl) |
| BorderStyle |
Obtém ou define o estilo de borda do controlo do servidor Web. (Herdado de WebControl) |
| BorderWidth |
Obtém ou define a largura da fronteira do controlo do servidor Web. (Herdado de WebControl) |
| CausesValidation |
Recebe ou define um valor que indica se a validação é realizada quando o Button controlo é clicado. |
| 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) |
| CommandArgument |
Recebe ou define um parâmetro opcional passado ao Command evento juntamente com o .CommandName |
| CommandName |
Recebe ou define o nome do comando associado ao Button controlo que é passado para o Command evento. |
| 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) |
| ControlStyle |
Recebe o estilo do controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl) |
| ControlStyleCreated |
Recebe um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl) |
| CssClass |
Obtém ou define a classe Cascading Style Sheet (CSS) renderizada pelo controlo do servidor Web no cliente. (Herdado de WebControl) |
| 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) |
| DesignMode |
Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto. (Herdado de Control) |
| Enabled |
Recebe ou define um valor que indica se o controlo do servidor Web está ativado. (Herdado de WebControl) |
| EnableTheming |
Recebe ou define um valor que indica se os temas se aplicam a este controlo. (Herdado de WebControl) |
| 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) |
| Font |
Obtém as propriedades da fonte associadas ao controlo do servidor Web. (Herdado de WebControl) |
| ForeColor |
Obtém ou define a cor do primeiro plano (tipicamente a cor do texto) do controlo do servidor Web. (Herdado de WebControl) |
| HasAttributes |
Recebe um valor que indica se o controlo tem atributos definidos. (Herdado de WebControl) |
| 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) |
| Height |
Obtém ou define a altura do controlo do servidor Web. (Herdado de WebControl) |
| 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) |
| IsChildControlStateCleared |
Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo. (Herdado de Control) |
| IsEnabled |
Recebe um valor que indica se o controlo está ativado. (Herdado de WebControl) |
| 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) |
| 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) |
| 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) |
| OnClientClick |
Obtém ou define o script do lado do cliente que é executado quando o evento de Click um Button controlo é levantado. |
| 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) |
| PostBackUrl |
Obtém ou define o URL da página para publicar a partir da página atual quando o Button controlo é clicado. |
| RenderingCompatibility |
Recebe um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control) |
| Site |
Obtém informação sobre o contentor que aloja o controlo atual quando renderizado numa superfície de design. (Herdado de Control) |
| SkinID |
Obtém ou fixa a pele para aplicar no controlo. (Herdado de WebControl) |
| Style |
Recebe uma coleção de atributos de texto que serão renderizados como um atributo de estilo na etiqueta externa do controlo do servidor Web. (Herdado de WebControl) |
| SupportsDisabledAttribute |
Obtém um valor que indica se o controlo deve definir o |
| TabIndex |
Obtém ou define o índice de tabulação do controlo do servidor Web. (Herdado de WebControl) |
| TagKey |
Obtém o HtmlTextWriterTag valor correspondente a este controlo do servidor Web. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl) |
| TagName |
Recebe o nome da etiqueta de controlo. Esta propriedade é utilizada principalmente por promotores de controlo. (Herdado de WebControl) |
| 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) |
| Text |
Obtém ou define a legenda de texto mostrada no Button controlo. |
| ToolTip |
Obtém ou define o texto exibido quando o ponteiro do rato paira sobre o controlo do servidor Web. (Herdado de WebControl) |
| UniqueID |
Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor. (Herdado de Control) |
| UseSubmitBehavior |
Recebe ou define um valor que indica se o controlo Button utiliza o mecanismo de submissão do navegador cliente ou o mecanismo de ASP.NET postback. |
| 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) |
| ValidationGroup |
Obtém ou define o grupo de controlos para os quais o controlo Button causa validação quando é enviado de volta ao servidor. |
| 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 StateBag objeto é indistinto a maiúsculas e maiúsculas. (Herdado de Control) |
| 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) |
| Width |
Obtém ou define a largura do controlo do servidor Web. (Herdado de WebControl) |
Métodos
| Name | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Adiciona os atributos do Button controlo ao fluxo de saída para renderização no cliente. |
| AddedControl(Control, Int32) |
Chamado após um controlo filho ser adicionado à Controls coleção do Control objeto. (Herdado de Control) |
| AddParsedSubObject(Object) |
Notifica o controlo do servidor que um elemento, seja XML ou HTML, foi analisado, e adiciona o elemento ao objeto do ControlCollection controlo do servidor. (Herdado de Control) |
| ApplyStyle(Style) |
Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, sobrescrevendo quaisquer elementos de estilo existentes do controlo. Este método é usado principalmente por desenvolvedores de controlo. (Herdado de WebControl) |
| 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) |
| CopyBaseAttributes(WebControl) |
Copia as propriedades não encapsuladas pelo Style objeto do controlo do servidor Web especificado para o controlo do servidor Web de onde este método é chamado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| 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 novo ControlCollection objeto para armazenar os controlos filhos (tanto literais como de servidor) do controlo do servidor. (Herdado de Control) |
| CreateControlStyle() |
Cria o objeto de estilo que é usado internamente pela WebControl classe para implementar todas as propriedades relacionadas com o estilo. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| 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) |
| 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) |
| 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) |
| GetPostBackOptions() |
Cria um PostBackOptions objeto que representa o Button comportamento de postback do controlo. |
| 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) |
| LoadViewState(Object) |
Restaura a informação de estado de visualização de um pedido anterior que foi guardado com o SaveViewState() método. (Herdado de WebControl) |
| 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) |
| MergeStyle(Style) |
Copia quaisquer elementos não em branco do estilo especificado para o controlo Web, mas não sobrescreve quaisquer elementos de estilo existentes do controlo. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| 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) |
| OnClick(EventArgs) | |
| OnCommand(CommandEventArgs) | |
| OnDataBinding(EventArgs) |
Eleva o DataBinding evento. (Herdado de Control) |
| OnInit(EventArgs) |
Eleva o Init evento. (Herdado de Control) |
| OnLoad(EventArgs) |
Eleva o Load evento. (Herdado de Control) |
| OnPreRender(EventArgs) |
Determina se o botão foi clicado antes de ser renderizado no cliente. |
| OnPreRender(EventArgs) |
Eleva o PreRender evento. (Herdado de Control) |
| 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) |
| RaisePostBackEvent(String) |
Levanta eventos para o Button controlo quando este é enviado de volta ao servidor. |
| RemovedControl(Control) |
Chamado após um controlo filho ser removido da Controls coleção do Control objeto. (Herdado de Control) |
| Render(HtmlTextWriter) |
Renderiza o controlo para o escritor HTML especificado. (Herdado de WebControl) |
| RenderBeginTag(HtmlTextWriter) |
Renderiza a etiqueta de abertura HTML do controlo ao escritor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| RenderChildren(HtmlTextWriter) |
Exporta o conteúdo dos filhos de um controlo de servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderContents(HtmlTextWriter) |
Apresenta o conteúdo do controlo ao autor especificado. |
| 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 HTML de fecho do controlo no escritor especificado. Este método é utilizado principalmente por reveladores de controlo. (Herdado de WebControl) |
| 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 qualquer estado que tenha sido modificado após o TrackViewState() método ter sido invocado. (Herdado de WebControl) |
| 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() |
Faz com que o controlo acompanhe alterações ao estado de visualização para que possam ser armazenadas na propriedade do ViewState objeto. (Herdado de WebControl) |
evento
| Name | Description |
|---|---|
| Click |
Ocorre quando o Button comando é carregado. |
| Command |
Ocorre quando o Button comando é carregado. |
| 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) |
| Unload |
Ocorre quando o controlo do servidor é descarregado da memória. (Herdado de Control) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Recebe um atributo do controlo Web com o nome especificado. (Herdado de WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Define um atributo do controlo Web ao nome e valor especificados. (Herdado de WebControl) |
| IControlBuilderAccessor.ControlBuilder |
Para uma descrição deste elemento, veja ControlBuilder. (Herdado de Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Para uma descrição deste elemento, veja GetDesignModeState(). (Herdado de Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Para uma descrição deste elemento, veja SetDesignModeState(IDictionary). (Herdado de Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Para uma descrição deste elemento, veja SetOwnerControl(Control). (Herdado de Control) |
| IControlDesignerAccessor.UserData |
Para uma descrição deste elemento, veja UserData. (Herdado de Control) |
| IDataBindingsAccessor.DataBindings |
Para uma descrição deste elemento, veja DataBindings. (Herdado de Control) |
| IDataBindingsAccessor.HasDataBindings |
Para uma descrição deste elemento, veja HasDataBindings. (Herdado de Control) |
| IExpressionsAccessor.Expressions |
Para uma descrição deste elemento, veja Expressions. (Herdado de Control) |
| IExpressionsAccessor.HasExpressions |
Para uma descrição deste elemento, veja HasExpressions. (Herdado de Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Para uma descrição deste elemento, veja AddParsedSubObject(Object). (Herdado de Control) |
| IPostBackEventHandler.RaisePostBackEvent(String) |
Levanta eventos para o Button controlo quando este é enviado de volta ao servidor. |
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. |