RequiredFieldValidator-Klasse
Legt das verknüpfte Eingabesteuerelement als erforderliches Feld fest.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Public Class RequiredFieldValidator
Inherits BaseValidator
'Usage
Dim instance As RequiredFieldValidator
public class RequiredFieldValidator : BaseValidator
public ref class RequiredFieldValidator : public BaseValidator
public class RequiredFieldValidator extends BaseValidator
public class RequiredFieldValidator extends BaseValidator
Hinweise
Mit diesem Steuerelement können Sie ein Eingabesteuerelement als erforderliches Feld festlegen. Die Validierung des Eingabesteuerelements schlägt fehl, wenn der Wert beim Verlust des Fokus nicht von der InitialValue-Eigenschaft abweicht.
Einem Eingabesteuerelement können mehrere Bestätigungen zugeordnet werden. Beispielsweise kann mit RequiredFieldValidator sichergestellt werden, dass eine Eingabe im Steuerelement erfolgt, und gleichzeitig kann mit RangeValidator sichergestellt werden, dass die Eingabe in einem bestimmten Datenbereich liegt.
Weitere Informationen zu Validierungssteuerelementen finden Sie unter BaseValidator.
Eingabehilfen
Das für dieses Steuerelement standardmäßig wiedergegebene Markup entspricht eventuell nicht den Standards für die Eingabehilfen wie beispielsweise den Richtlinien der Web Content Accessibility Guidelines 1.0 (WCAG) mit der Priorität 1. Details über die Unterstützung von Eingabehilfen für dieses Steuerelement finden Sie unter Steuerelemente und Eingabehilfen von ASP.NET.
Beispiel
Das folgende Beispiel veranschaulicht, wie mithilfe des RequiredFieldValidator-Steuerelements sichergestellt werden kann, dass der Benutzer einen Wert in das Textfeld eingibt.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
Sub ValidateBtn_Click(sender As Object, e As EventArgs)
If Page.IsValid Then
lblOutput.Text = "Required field is filled!"
Else
lblOutput.Text = "Required field is empty!"
End If
End Sub
</script>
</head>
<body>
<form runat="server">
<h3>RequiredField Validator Example</h3>
<table bgcolor="#eeeeee" cellpadding="10">
<tr valign="top">
<td colspan="3">
<asp:Label ID="lblOutput"
Text="Fill in the required field below"
runat="server"/>
<br>
</td>
</tr>
<tr>
<td colspan="3">
<b>Credit Card Information</b>
</td>
</tr>
<tr>
<td align="right">
Card Number:
</td>
<td>
<asp:TextBox id="TextBox1"
runat="server"/>
</td>
<td>
<asp:RequiredFieldValidator id="RequiredFieldValidator2"
ControlToValidate="TextBox1"
Display="Static"
ErrorMessage="*"
runat="server"/>
</td>
</tr>
<tr>
<td></td>
<td>
<asp:Button id="Button1"
Text="Validate"
OnClick="ValidateBtn_Click"
runat="server"/>
</td>
<td></td>
</tr>
</table>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
void ValidateBtn_Click(Object sender, EventArgs e)
{
if (Page.IsValid)
{
lblOutput.Text = "Required field is filled!";
}
else
{
lblOutput.Text = "Required field is empty!";
}
}
</script>
</head>
<body>
<form runat="server">
<h3>RequiredField Validator Example</h3>
<table bgcolor="#eeeeee" cellpadding="10">
<tr valign="top">
<td colspan="3">
<asp:Label ID="lblOutput"
Text="Fill in the required field below"
runat="server"/>
<br>
</td>
</tr>
<tr>
<td colspan="3">
<b>Credit Card Information</b>
</td>
</tr>
<tr>
<td align="right">
Card Number:
</td>
<td>
<asp:TextBox id="TextBox1"
runat="server"/>
</td>
<td>
<asp:RequiredFieldValidator id="RequiredFieldValidator2"
ControlToValidate="TextBox1"
Display="Static"
ErrorMessage="*"
runat="server"/>
</td>
</tr>
<tr>
<td></td>
<td>
<asp:Button id="Button1"
Text="Validate"
OnClick="ValidateBtn_Click"
runat="server"/>
</td>
<td></td>
</tr>
</table>
</form>
</body>
</html>
<html>
<head>
<script language="C#" runat=server>
void ValidateBtn_Click(Object sender, EventArgs e) {
if (Page.IsValid == true) {
lblOutput.Text = "Required field is filled!";
}
else {
lblOutput.Text = "Required field is empty!";
}
}
</script>
</head>
<body>
<h3><font face="Verdana">RequiredField Validator Sample</font></h3>
<p>
<form runat="server">
<table bgcolor="#eeeeee" cellpadding=10>
<tr valign="top">
<td colspan=3>
<asp:Label ID="lblOutput"
Text="Fill in the required field below"
ForeColor="red"
Font-Name="Verdana"
Font-Size="10" runat=server /><br>
</td>
</tr>
<tr>
<td colspan=3>
<font face=Verdana size=2><b>Credit Card Information</b></font>
</td>
</tr>
<tr>
<td align=right>
<font face=Verdana size=2>Card Number:</font>
</td>
<td>
<asp:TextBox id=TextBox1 runat=server />
</td>
<td>
<asp:RequiredFieldValidator id="RequiredFieldValidator2"
ControlToValidate="TextBox1"
Display="Static"
Width="100%" runat=server>
</asp:RequiredFieldValidator>
</td>
</tr>
<tr>
<td></td>
<td>
<asp:Button id=Button1
text="Validate"
OnClick="ValidateBtn_Click"
runat=server />
</td>
<td></td>
</tr>
</table>
</form>
</body>
</html>
Vererbungshierarchie
System.Object
System.Web.UI.Control
System.Web.UI.WebControls.WebControl
System.Web.UI.WebControls.Label
System.Web.UI.WebControls.BaseValidator
System.Web.UI.WebControls.RequiredFieldValidator
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
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
RequiredFieldValidator-Member
System.Web.UI.WebControls-Namespace
RangeValidator-Klasse
InitialValue