HtmlInputRadioButton.OnServerChange(EventArgs) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Aciona o evento ServerChange. Isso permite que você crie um manipulador de eventos personalizado quando o evento é gerado.
protected:
virtual void OnServerChange(EventArgs ^ e);protected virtual void OnServerChange (EventArgs e);abstract member OnServerChange : EventArgs -> unit
override this.OnServerChange : EventArgs -> unitProtected Overridable Sub OnServerChange (e As EventArgs)Parâmetros
Exemplos
O exemplo de código a seguir demonstra como especificar e codificar um manipulador para o ServerChange evento. O manipulador de eventos personalizado atualiza um rótulo na página da Web para exibir 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>
Comentários
O ServerChange evento é gerado quando a Checked propriedade do HtmlInputRadioButton controle altera valores entre postagens no servidor. Isso permite que você crie um manipulador de eventos personalizado que executa um conjunto específico de instruções (como validação de dados) quando o evento é gerado.
Observação
O controle deve ter o estado de exibição habilitado para que o ServerChange evento funcione corretamente. Para habilitar o estado de exibição para todos os controles na página Web Forms, defina a Page.EnableViewState propriedade como true. Você também pode habilitar o estado de exibição para um controle individual definindo a Control.EnableViewState propriedade como true.
A geração de um evento invoca o manipulador de eventos por meio de um delegado. Para obter mais informações, consulte Manipulando e levantando eventos.
O OnServerChange método também permite que classes derivadas manipulem o evento sem anexar um delegado. Essa é a técnica preferencial para lidar com o evento em uma classe derivada.
Notas aos Herdeiros
Ao substituir OnServerChange(EventArgs) em uma classe derivada, chame o método da OnServerChange(EventArgs) classe base para que os delegados registrados recebam o evento.
