CustomValidator.ClientValidationFunction-Eigenschaft
Ruft den Namen der benutzerdefinierten Clientskriptfunktion für die Validierung ab oder legt diesen fest.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<ThemeableAttribute(False)> _
Public Property ClientValidationFunction As String
'Usage
Dim instance As CustomValidator
Dim value As String
value = instance.ClientValidationFunction
instance.ClientValidationFunction = value
[ThemeableAttribute(false)]
public string ClientValidationFunction { get; set; }
[ThemeableAttribute(false)]
public:
property String^ ClientValidationFunction {
String^ get ();
void set (String^ value);
}
/** @property */
public String get_ClientValidationFunction ()
/** @property */
public void set_ClientValidationFunction (String value)
public function get ClientValidationFunction () : String
public function set ClientValidationFunction (value : String)
Eigenschaftenwert
Der Name der benutzerdefinierten Clientskriptfunktion für die Validierung. Der Standardwert ist String.Empty und gibt an, dass diese Eigenschaft nicht festgelegt ist.
Hinweis
Der Funktionsname darf keine Klammern oder Parameter enthalten.
Hinweise
Legen Sie diese Eigenschaft auf den Namen der Funktion fest, die die clientseitige Validierung durchführt.
Da die clientseitige Validierungsfunktion auf dem Zielbrowser ausgeführt wird, muss die Funktion in einer vom Browser unterstützten Skriptsprache geschrieben sein, z. B. JScript oder VBScript.
Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und Übersicht über ASP.NET-Designs und ASP.NET-Skins.
| 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 |
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe der ClientValidationFunction-Eigenschaft der Name der Funktion angegeben wird, die die clientseitige Validierung durchführt. Die Validierungsfunktion sucht nach geraden Zahlen.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
Sub ValidateBtn_OnClick(sender As Object, e As EventArgs)
' Display whether the page passed validation.
If Page.IsValid Then
Message.Text = "Page is valid."
Else
Message.Text = "Page is not valid!"
End If
End Sub
Sub ServerValidation(source As Object, args As ServerValidateEventArgs)
Try
' Test whether the value entered into the text box is even.
Dim num As Integer = Integer.Parse(args.Value)
args.IsValid = ((num mod 2) = 0)
Catch ex As Exception
args.IsValid = false
End Try
End Sub
</script>
</head>
<body>
<form runat="server">
<h3>CustomValidator ServerValidate Example</h3>
<asp:Label id="Message"
Text="Enter an even number:"
Font-Name="Verdana"
Font-Size="10pt"
runat="server"/>
<p>
<asp:TextBox id="Text1"
runat="server" />
<asp:CustomValidator id="CustomValidator1"
ControlToValidate="Text1"
ClientValidationFunction="ClientValidate"
OnServerValidate="ServerValidation"
Display="Static"
ErrorMessage="Not an even number!"
ForeColor="green"
Font-Name="verdana"
Font-Size="10pt"
runat="server"/>
<p>
<asp:Button id="Button1"
Text="Validate"
OnClick="ValidateBtn_OnClick"
runat="server"/>
</form>
</body>
</html>
<script language="vbscript">
<!--
Sub ClientValidate(source, arguments)
If (arguments.Value mod 2) = 0 Then
arguments.IsValid=true
Else
arguments.IsValid=false
End If
End Sub
' -->
</script>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
void ValidateBtn_OnClick(object sender, EventArgs e)
{
// Display whether the page passed validation.
if (Page.IsValid)
{
Message.Text = "Page is valid.";
}
else
{
Message.Text = "Page is not valid!";
}
}
void ServerValidation(object source, ServerValidateEventArgs args)
{
try
{
// Test whether the value entered into the text box is even.
int i = int.Parse(args.Value);
args.IsValid = ((i%2) == 0);
}
catch(Exception ex)
{
args.IsValid = false;
}
}
</script>
</head>
<body>
<form runat="server">
<h3>CustomValidator ServerValidate Example</h3>
<asp:Label id="Message"
Text="Enter an even number:"
Font-Name="Verdana"
Font-Size="10pt"
runat="server"/>
<p>
<asp:TextBox id="Text1"
runat="server" />
<asp:CustomValidator id="CustomValidator1"
ControlToValidate="Text1"
ClientValidationFunction="ClientValidate"
OnServerValidate="ServerValidation"
Display="Static"
ErrorMessage="Not an even number!"
ForeColor="green"
Font-Name="verdana"
Font-Size="10pt"
runat="server"/>
<p>
<asp:Button id="Button1"
Text="Validate"
OnClick="ValidateBtn_OnClick"
runat="server"/>
</form>
</body>
</html>
<script language="vbscript">
<!--
Sub ClientValidate(source, arguments)
If (arguments.Value mod 2) = 0 Then
arguments.IsValid=true
Else
arguments.IsValid=false
End If
End Sub
' -->
</script>
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
CustomValidator-Klasse
CustomValidator-Member
System.Web.UI.WebControls-Namespace
String.Empty