HtmlInputImage.ValidationGroup Propriedade
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.
Obtém ou define o grupo de controlos para os quais o controlo HtmlInputImage causa validação quando é enviado de volta ao servidor.
public:
virtual property System::String ^ ValidationGroup { System::String ^ get(); void set(System::String ^ value); };public virtual string ValidationGroup { get; set; }member this.ValidationGroup : string with get, setPublic Overridable Property ValidationGroup As StringValor de Propriedade
O grupo de controlos para o qual o controlo HtmlInputImage causa validação quando é enviado de volta ao servidor. O valor padrão é uma cadeia vazia (""), indicando que esta propriedade não está definida.
Exemplos
O exemplo de código seguinte demonstra como usar a ValidationGroup propriedade para especificar os controlos a validar quando um HtmlInputImage controlo é enviado de volta ao servidor. A página contém duas caixas de texto para capturar dados do utilizador e dois RequiredFieldValidator controlos para garantir que o utilizador não deixa uma caixa de texto em branco. O RequiredFieldValidator controlo para a primeira caixa de texto está no CityInfoGroup grupo de validação e o RequiredFieldValidator controlo para a segunda caixa está no StateInfoGroup grupo de validação. Quando é clicado CityQueryButton , apenas o controlo no CityInfoGroup grupo de validação é validado. Quando é clicado StateQueryButton , apenas o controlo no StateInfoGroup grupo de validação é validado.
<%@ 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 SubmitButton_Click(Object sender, ImageClickEventArgs e)
{
// Determine which button was clicked.
switch (((HtmlInputImage)sender).ID)
{
case "CityQueryButton":
// Take the appropriate action if the controls pass validation.
if (CityReqValidator.IsValid)
{
Message.InnerHtml = "You have chosen to run a query for the following city: " +
CityTextBox.Value;
}
break;
case "StateQueryButton":
// Take the appropriate action if the controls pass validation.
if (StateReqValidator.IsValid)
{
Message.InnerHtml = "You have chosen to run a query for the following state: " +
StateTextBox.Value;
}
break;
default:
// If the button clicked is not recognized, erase the message on the page.
Message.InnerHtml = "";
break;
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> HtmlInputImage CausesValidation Example </title>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlInputImage CausesValidation Example </h3>
<table border="1" cellpadding="10">
<tr>
<td>
<b>Enter city to query.</b> <br />
<input id="CityTextBox"
type="Text"
runat="server"/>
<asp:RequiredFieldValidator
ID="CityReqValidator"
ControlToValidate="CityTextBox"
ValidationGroup="CityInfoGroup"
ErrorMessage="<br />Please enter a city."
Display="Dynamic"
EnableClientScript="False"
runat="server"/>
</td>
<td valign="bottom">
<input id="CityQueryButton"
alt="City Submit button"
type="Image"
src="Image.jpg"
causesvalidation="true"
validationgroup="CityInfoGroup"
onserverclick="SubmitButton_Click"
runat="server"/>
</td>
</tr>
<tr>
<td>
<b>Enter state to query.</b> <br />
<input id="StateTextBox"
type="Text"
runat="server"/>
<asp:RequiredFieldValidator ID="StateReqValidator"
ControlToValidate="StateTextBox"
ValidationGroup="StateInfoGroup"
ErrorMessage="<br />Please enter a state."
Display="Dynamic"
EnableClientScript="False"
runat="server"/>
</td>
<td valign="bottom">
<input id="StateQueryButton"
alt="State Submit button"
type="Image"
src="Image.jpg"
causesvalidation="True"
validationgroup="StateInfoGroup"
onserverclick="SubmitButton_Click"
runat="server"/>
</td>
</tr>
</table>
<br /><br />
<span 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">
<script runat="server">
Sub SubmitButton_Click(ByVal sender As Object, ByVal e As ImageClickEventArgs)
' Determine which button was clicked.
Select Case (CType(sender, HtmlInputImage)).ID
Case "CityQueryButton"
' Take the appropriate action if the controls pass validation.
If CityReqValidator.IsValid Then
Message.InnerHtml = "You have chosen to run a query for the following city: " & _
CityTextBox.Value
End If
Case "StateQueryButton"
' Take the appropriate action if the controls pass validation.
If StateReqValidator.IsValid Then
Message.InnerHtml = "You have chosen to run a query for the following state: " & _
StateTextBox.Value
End If
Case Else
' If the button clicked is not recognized, erase the message on the page.
Message.InnerHtml = ""
End Select
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title> HtmlInputImage CausesValidation Example </title>
</head>
<body>
<form id="form1" runat="server">
<h3> HtmlInputImage CausesValidation Example </h3>
<table border="1" cellpadding="10">
<tr>
<td>
<b>Enter city to query.</b> <br />
<input id="CityTextBox"
type="Text"
runat="server"/>
<asp:RequiredFieldValidator ID="CityReqValidator"
ControlToValidate="CityTextBox"
ValidationGroup="CityInfoGroup"
ErrorMessage="<br />Please enter a city."
Display="Dynamic"
EnableClientScript="False"
runat="server"/>
</td>
<td valign="bottom">
<input id="CityQueryButton"
alt="City Submit button"
type="Image"
src="Image.jpg"
causesvalidation="True"
validationgroup="CityInfoGroup"
onserverclick="SubmitButton_Click"
runat="server"/>
</td>
</tr>
<tr>
<td>
<b>Enter state to query.</b> <br />
<input id="StateTextBox"
type="Text"
runat="server"/>
<asp:RequiredFieldValidator ID="StateReqValidator"
ControlToValidate="StateTextBox"
ValidationGroup="StateInfoGroup"
ErrorMessage="<br />Please enter a state."
Display="Dynamic"
EnableClientScript="False"
runat="server"/>
</td>
<td valign="bottom">
<input id="StateQueryButton"
alt="State Submit button"
type="Image"
src="Image.jpg"
causesvalidation="True"
validationgroup="StateInfoGroup"
onserverclick="SubmitButton_Click"
runat="server"/>
</td>
</tr>
</table>
<br /><br />
<span id="Message"
runat="Server"/>
</form>
</body>
</html>
Observações
Os grupos de validação permitem-lhe atribuir controlos de validação numa página a uma categoria específica. Cada grupo de validação pode ser validado independentemente dos outros grupos de validação na página. Use a ValidationGroup propriedade para especificar o nome do grupo de validação para o qual o HtmlInputImage controlo causa validação quando é publicado de volta para o servidor.
Esta propriedade só tem efeito quando o valor da CausesValidation propriedade é definido para true. Quando especifica um valor para a ValidationGroup propriedade, apenas os controlos de validação que fazem parte do grupo especificado são validados quando o controlo HtmlInputImage é enviado de volta ao servidor. Se não especificar um valor para esta propriedade e a CausesValidation propriedade for definida para true, todos os controlos de validação na página que não estejam atribuídos a um grupo de validação são validados quando o controlo é enviado de volta ao servidor.