Freigeben über


ValidationSummary.HeaderText-Eigenschaft

Ruft den Kopfzeilentext ab, der am Anfang der Zusammenfassung angezeigt wird, oder legt diesen fest.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
<LocalizableAttribute(True)> _
Public Property HeaderText As String
'Usage
Dim instance As ValidationSummary
Dim value As String

value = instance.HeaderText

instance.HeaderText = value
[LocalizableAttribute(true)] 
public string HeaderText { get; set; }
[LocalizableAttribute(true)] 
public:
property String^ HeaderText {
    String^ get ();
    void set (String^ value);
}
/** @property */
public String get_HeaderText ()

/** @property */
public void set_HeaderText (String value)
public function get HeaderText () : String

public function set HeaderText (value : String)

Eigenschaftenwert

Der Kopfzeilentext, der am Anfang der Zusammenfassung angezeigt wird. Der Standardwert ist String.Empty.

Hinweise

Mit dieser Eigenschaft können Sie einen Titel für das ValidationSummary-Steuerelement anzeigen.

Die HeaderText-Eigenschaft ist nicht HTML-codiert. Daher können HTML-Tags in HeaderText einbezogen werden.

Wenn der Wert dieser Eigenschaft festgelegt ist, kann er mithilfe eines Designertools automatisch in einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute und ASP.NET-Globalisierung und -Lokalisierung.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mit der HeaderText-Eigenschaft einen Titel für das ValidationSummary-Steuerelement anzeigen.

<%@ Page Language="VB"%>

<html>
  <body>
    <form 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="C#"%>

<html>
  <body>
    <form 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>
 

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ValidationSummary-Klasse
ValidationSummary-Member
System.Web.UI.WebControls-Namespace