Freigeben über


BaseValidator.ErrorMessage-Eigenschaft

Ruft den Text für die Fehlermeldung ab, die in einem ValidationSummary-Steuerelement angezeigt wird, wenn die Validierung fehlschlägt, oder legt diesen Text fest.

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

Syntax

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

value = instance.ErrorMessage

instance.ErrorMessage = value
[LocalizableAttribute(true)] 
public string ErrorMessage { get; set; }
[LocalizableAttribute(true)] 
public:
virtual property String^ ErrorMessage {
    String^ get () sealed;
    void set (String^ value) sealed;
}
/** @property */
public final String get_ErrorMessage ()

/** @property */
public final void set_ErrorMessage (String value)
public final function get ErrorMessage () : String

public final function set ErrorMessage (value : String)

Eigenschaftenwert

Die Fehlermeldung, die in einem ValidationSummary-Steuerelement angezeigt wird, wenn die Validierung fehlschlägt. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass diese Eigenschaft nicht festgelegt ist.

Hinweise

Wenn Sie ein ValidationSummary-Steuerelement verwenden, geben Sie mithilfe der ErrorMessage-Eigenschaft den Text an, der im ValidationSummary-Steuerelement angezeigt werden soll, wenn die Validierung für das aktuelle Validierungssteuerelement fehlschlägt. Geben Sie mit der Text-Eigenschaft den Text an, der im Validierungssteuerelement selbst angezeigt werden soll.

Hinweis

Wenn Sie die ErrorMessage-Eigenschaft festlegen, ohne die Text-Eigenschaft festzulegen, wird der Wert der ErrorMessage-Eigenschaft ebenfalls im Validierungssteuerelement angezeigt.

Der Wert dieser Eigenschaft (falls festgelegt) kann automatisch in einer Ressourcendatei gespeichert werden, wenn ein Designertool verwendet wird. Weitere Informationen finden Sie unter LocalizableAttribute und ASP.NET-Globalisierung und -Lokalisierung.

Thema Position
Exemplarische Vorgehensweise: Validieren der Benutzereingabe in einer Web Forms-Seite Erstellen von ASP.NET-Webanwendungen in Visual Studio
Exemplarische Vorgehensweise: Validieren der Benutzereingabe in einer Web Forms-Seite Erstellen von Anwendungen mit Visual Web Developer
Gewusst wie: Validierung anhand von Werten in einer Datenbank für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand eines Wertebereichs für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand eines bestimmten Werts für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand eines Datentyps für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Angeben des Layouts für direkte Meldungen in ASP.NET-Serversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung erforderlicher Einträge für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Anzeigen von benutzerdefinierten Validierungsmeldungen des Servers für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Testen der Validierung für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand von Mustern für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Validieren für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Formatieren von Validierungsfehlermeldungen für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung mit einer benutzerdefinierten Funktion für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Deaktivieren der Validierung für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand von Werten in einer Datenbank für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand eines Wertebereichs für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand eines bestimmten Werts für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand eines Datentyps für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Angeben des Layouts für direkte Meldungen in ASP.NET-Serversteuerelementen Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung erforderlicher Einträge für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Anzeigen von benutzerdefinierten Validierungsmeldungen des Servers für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Testen der Validierung für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand von Mustern für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Programmgesteuertes Validieren für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Formatieren von Validierungsfehlermeldungen für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung mit einer benutzerdefinierten Funktion für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Deaktivieren der Validierung für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen in Visual Studio
Gewusst wie: Validierung anhand von Werten in einer Datenbank für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Validierung anhand eines Wertebereichs für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Validierung anhand eines bestimmten Werts für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Validierung anhand eines Datentyps für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Angeben des Layouts für direkte Meldungen in ASP.NET-Serversteuerelementen Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Validierung erforderlicher Einträge für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Anzeigen von benutzerdefinierten Validierungsmeldungen des Servers für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Programmgesteuertes Testen der Validierung für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Validierung anhand von Mustern für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Programmgesteuertes Validieren für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Formatieren von Validierungsfehlermeldungen für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Validierung mit einer benutzerdefinierten Funktion für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen
Gewusst wie: Deaktivieren der Validierung für ASP.NET-Serversteuerelemente Erstellen von ASP.NET-Webanwendungen

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mit der ErrorMessage-Eigenschaft verschiedene Meldungen für die Steuerelemente ValidationSummary, RequiredFieldValidator und CompareValidator angeben.

<%@ Page Language="VB" AutoEventWireup="False" %>

<script runat="server">
 
  Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs) Handles SubmitButton.Click
 
    If Page.IsValid Then
    
      MessageLabel.Text = "Page submitted successfully."
    
    Else
    
      MessageLabel.Text = "There is an error on the page."
    
    End If
    
  End Sub
 
</script>

<html>
  <body>
    <form runat="server">

      <h3>Validator Example</h3>
     
      Enter a number from 1 to 10.
      <asp:textbox id="NumberTextBox" 
        runat="server"/>

      <asp:rangevalidator id="NumberCompareValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"  
        type="Integer"
        display="Dynamic" 
        errormessage="Please enter a value from 1 to 10."
        maximumvalue="10"
        minimumvalue="1"  
        text="*"
        runat="server"/>

      <asp:requiredfieldvalidator id="TextBoxRequiredValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"
        display="Dynamic" 
        errormessage="Please enter a value."
        text="*"
        runat="server"/>

      <br><br>

      <asp:button id="SubmitButton"
        text="Submit"
        runat="server"/>
 
      <br><br>
       
      <asp:label id="MessageLabel" 
        runat="server"/>

      <br><br>

      <asp:validationsummary
        id="ErrorSummary"
        runat="server"/>
 
    </form>
  </body>
</html>
<%@ Page Language="C#" %>

<script runat="server">
 
  void Button_Click(Object sender, EventArgs e) 
  {
    if (Page.IsValid)
    {
      MessageLabel.Text = "Page submitted successfully.";
    }
    else
    {
      MessageLabel.Text = "There is an error on the page.";
    }
  }
 
</script>

<html>
  <body>
    <form runat="server">

      <h3>Validator Example</h3>
     
      Enter a number from 1 to 10.
      <asp:textbox id="NumberTextBox" 
        runat="server"/>

      <asp:rangevalidator id="NumberCompareValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"  
        type="Integer"
        display="Dynamic" 
        errormessage="Please enter a value from 1 to 10."
        maximumvalue="10"
        minimumvalue="1"  
        text="*"
        runat="server"/>

      <asp:requiredfieldvalidator id="TextBoxRequiredValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"
        display="Dynamic" 
        errormessage="Please enter a value."
        text="*"
        runat="server"/>

      <br><br>

      <asp:button id="SubmitButton"
        text="Submit"
        onclick="Button_Click"
        runat="server"/>
 
      <br><br>
       
      <asp:label id="MessageLabel" 
        runat="server"/>

      <br><br>

      <asp:validationsummary
        id="ErrorSummary"
        runat="server"/>
 
    </form>
  </body>
</html>
<%@ Page Language="JScript" %>

<script runat="server">
 
  function Button_Click(sender, e : EventArgs) 
  {
    if (Page.IsValid)
    {
      MessageLabel.Text = "Page submitted successfully.";
    }
    else
    {
      MessageLabel.Text = "There is an error on the page.";
    }
  }
 
</script>

<html>
  <body>
    <form runat="server">

      <h3>Validator Example</h3>
     
      Enter a number from 1 to 10.
      <asp:textbox id="NumberTextBox" 
        runat="server"/>

      <asp:rangevalidator id="NumberCompareValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"  
        type="Integer"
        display="Dynamic" 
        errormessage="Please enter a value from 1 to 10."
        maximumvalue="10"
        minimumvalue="1"  
        text="*"
        runat="server"/>

      <asp:requiredfieldvalidator id="TextBoxRequiredValidator" 
        controltovalidate="NumberTextBox"
        enableclientscript="False"
        display="Dynamic" 
        errormessage="Please enter a value."
        text="*"
        runat="server"/>

      <br><br>

      <asp:button id="SubmitButton"
        text="Submit"
        onclick="Button_Click"
        runat="server"/>
 
      <br><br>
       
      <asp:label id="MessageLabel" 
        runat="server"/>

      <br><br>

      <asp:validationsummary
        id="ErrorSummary"
        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

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