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.
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