HtmlInputRadioButton.OnServerChange(EventArgs) Método
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.
Eleva o ServerChange evento. Isto permite-lhe criar um gestor de eventos personalizado quando o evento é ativado.
protected:
virtual void OnServerChange(EventArgs ^ e);
protected virtual void OnServerChange(EventArgs e);
abstract member OnServerChange : EventArgs -> unit
override this.OnServerChange : EventArgs -> unit
Protected Overridable Sub OnServerChange (e As EventArgs)
Parâmetros
Exemplos
O seguinte exemplo de código demonstra como especificar e programar um handler para o ServerChange evento. O handler de eventos personalizado atualiza uma etiqueta na página Web para mostrar o valor do botão de opção selecionado.
<%@ 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>HtmlInputRadioButton Sample</title>
<script runat="server">
void Server_Change(object sender, EventArgs e)
{
if (Radio1.Checked)
Span1.InnerHtml = "You selected " +
Radio1.Value;
else if (Radio2.Checked)
Span1.InnerHtml = "You selected " +
Radio2.Value;
else if (Radio3.Checked)
Span1.InnerHtml = "You selected " +
Radio3.Value;
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlInputRadioButton Sample</h3>
<input type="radio"
id="Radio1"
name="Mode"
value="Radio Button 1"
onserverchange="Server_Change"
runat="server"/>
Option 1
<br />
<input type="radio"
id="Radio2"
name="Mode"
value="Radio Button 2"
onserverchange="Server_Change"
runat="server"/>
Option 2
<br />
<input type="radio"
id="Radio3"
name="Mode"
value="Radio Button 3"
onserverchange="Server_Change"
runat="server"/>
Option 3
<br />
<input type="submit"
id="Button1"
value="Submit"
runat="server"/>
<br />
<span id="Span1"
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>HtmlInputRadioButton Sample</title>
<script runat="server">
Sub Server_Change(sender As Object , e As EventArgs)
If Radio1.Checked Then
Span1.InnerHtml = "You selected " & _
Radio1.Value
ElseIf Radio2.Checked Then
Span1.InnerHtml = "You selected " & _
Radio2.Value
ElseIf Radio3.Checked Then
Span1.InnerHtml = "You selected " & _
Radio3.Value
End If
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlInputRadioButton Sample</h3>
<input type="radio"
id="Radio1"
name="Mode"
value="Radio Button 1"
onserverchange="Server_Change"
runat="server"/>
Option 1
<br />
<input type="radio"
id="Radio2"
name="Mode"
value="Radio Button 2"
onserverchange="Server_Change"
runat="server"/>
Option 2
<br />
<input type="radio"
id="Radio3"
name="Mode"
value="Radio Button 3"
onserverchange="Server_Change"
runat="server"/>
Option 3
<br />
<input type="submit"
id="Button1"
value="Submit"
runat="server"/>
<br />
<span id="Span1"
runat="server"/>
</form>
</body>
</html>
<%@ 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>HtmlInputRadioButton ServerChange Example</title>
<script runat="server">
void Server_Change(object sender, EventArgs e)
{
if (Radio1.Checked)
{
Span1.InnerHtml = "You selected " + Radio1.Value;
}
else if (Radio2.Checked)
{
Span1.InnerHtml = "You selected " + Radio2.Value;
}
else if (Radio3.Checked)
{
Span1.InnerHtml = "You selected " + Radio3.Value;
}
}
void Page_Load(object sender, EventArgs e)
{
// Create an EventHandler delegate for the method you want to
// handle the event, and then add it to the list of methods
// called when the event is raised.
Radio1.ServerChange += new System.EventHandler(this.Server_Change);
Radio2.ServerChange += new System.EventHandler(this.Server_Change);
Radio3.ServerChange += new System.EventHandler(this.Server_Change);
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlInputRadioButton ServerChange Example</h3>
<input type="radio"
id="Radio1"
name="Mode"
value="Radio Button 1"
runat="server"/>
Option 1
<br />
<input type="radio"
id="Radio2"
name="Mode"
value="Radio Button 2"
runat="server"/>
Option 2
<br />
<input type="radio"
id="Radio3"
name="Mode"
value="Radio Button 3"
runat="server"/>
Option 3
<br />
<input type="submit"
id="Button1"
value="Submit"
runat="server"/>
<br />
<span id="Span1"
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>HtmlInputRadioButton ServerChange Example</title>
<script runat="server">
Sub Server_Change(sender As Object, e As EventArgs)
If Radio1.Checked Then
Span1.InnerHtml = "You selected " & Radio1.Value
ElseIf Radio2.Checked Then
Span1.InnerHtml = "You selected " & Radio2.Value
ElseIf Radio3.Checked Then
Span1.InnerHtml = "You selected " & Radio3.Value
End If
End Sub
Sub Page_Load(sender As Object, e As EventArgs)
' Create an EventHandler delegate for the method you want to
' handle the event, and then add it to the list of methods
' called when the event is raised.
AddHandler Radio1.ServerChange, AddressOf Server_Change
AddHandler Radio2.ServerChange, AddressOf Server_Change
AddHandler Radio3.ServerChange, AddressOf Server_Change
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>HtmlInputRadioButton ServerChange Example</h3>
<input type="radio"
id="Radio1"
name="Mode"
value="Radio Button 1"
runat="server"/>
Option 1
<br />
<input type="radio"
id="Radio2"
name="Mode"
value="Radio Button 2"
runat="server"/>
Option 2
<br />
<input type="radio"
id="Radio3"
name="Mode"
value="Radio Button 3"
runat="server"/>
Option 3
<br />
<input type="submit"
id="Button1"
value="Submit"
runat="server"/>
<br />
<span id="Span1"
runat="server" />
</form>
</body>
</html>
Observações
O ServerChange evento é ativado quando a Checked propriedade do HtmlInputRadioButton controlo muda de valor entre publicações para o servidor. Isto permite-lhe criar um gestor de eventos personalizado que executa um conjunto específico de instruções (como validação de dados) quando o evento é gerado.
Note
O controlo deve ter o estado de visualização ativado para que o ServerChange evento funcione corretamente. Para ativar o estado de visualização para todos os controlos na página Web Forms, defina a Page.EnableViewState propriedade para true. Também pode ativar o estado de visualização para um controlo individual definindo a Control.EnableViewState propriedade para true.
Levantar um evento invoca o gestor de eventos através de um delegado. Para mais informações, consulte Manuseio e Levantamento de Eventos.
O OnServerChange método também permite que classes derivadas tratem do evento sem anexar um delegado. Esta é a técnica preferida para lidar com o evento numa classe derivada.
Notas para Herdeiros
Ao substituir OnServerChange(EventArgs) uma classe derivada, certifique-se de chamar o método da OnServerChange(EventArgs) classe base para que os delegados registados recebam o evento.