ValidationSummary.HeaderText 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.
Recebe ou define o texto do cabeçalho apresentado no topo do resumo.
public:
property System::String ^ HeaderText { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public string HeaderText { get; set; }
public string HeaderText { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.HeaderText : string with get, set
member this.HeaderText : string with get, set
Public Property HeaderText As String
Valor de Propriedade
O texto do cabeçalho mostrado no topo do resumo. A predefinição é Empty.
- Atributos
Exemplos
O exemplo de código seguinte demonstra como usar a HeaderText propriedade para mostrar um título para o ValidationSummary controlo.
<%@ 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 runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
Name:<br/>
<asp:textbox id="NameTextBox"
runat="server"/>
<asp:requiredfieldvalidator id="NameTextBoxRequiredValidator"
controltovalidate="NameTextBox"
errormessage="Name field."
text="Please enter your name"
runat="server"/>
<br/>
City:<br/>
<asp:textbox id="CityTextBox"
runat="server"/>
<asp:requiredfieldvalidator id="CityTextBoxRequiredValidator"
controltovalidate="CityTextBox"
errormessage="City field."
text="Please enter the city."
runat="server"/>
<br/>
<asp:Button id="SubmitButton"
text="Submit"
runat="server"/>
<hr/>
<asp:ValidationSummary
id="valSum"
displaymode="BulletList"
headertext="You must enter a value in the following fields:"
runat="server"/>
</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 runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
Name:<br/>
<asp:textbox id="NameTextBox"
runat="server"/>
<asp:requiredfieldvalidator id="NameTextBoxRequiredValidator"
controltovalidate="NameTextBox"
errormessage="Name field."
text="Please enter your name"
runat="server"/>
<br/>
City:<br/>
<asp:textbox id="CityTextBox"
runat="server"/>
<asp:requiredfieldvalidator id="CityTextBoxRequiredValidator"
controltovalidate="CityTextBox"
errormessage="City field."
text="Please enter the city."
runat="server"/>
<br/>
<asp:Button id="SubmitButton"
text="Submit"
runat="server"/>
<hr/>
<asp:ValidationSummary
id="valSum"
displaymode="BulletList"
headertext="You must enter a value in the following fields:"
runat="server"/>
</form>
</body>
</html>
Observações
Use esta propriedade para mostrar um título para o ValidationSummary controlo.
A HeaderText propriedade não está codificada em HTML. Portanto, as etiquetas HTML podem ser incluídas em HeaderText.
O valor desta propriedade, quando definido, pode ser guardado automaticamente num ficheiro de recurso usando uma ferramenta de design. Para mais informações, consulte LocalizableAttribute e ASP.NET Globalização e Localização.