CompareValidator.ValueToCompare-Eigenschaft

Artikel
08/20/2007

Ruft einen konstanten Wert ab, der mit dem vom Benutzer im validierten Eingabesteuerelement eingegebenen Wert verglichen werden soll, oder legt diesen fest.

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

Syntax

'Declaration
<ThemeableAttribute(False)> _
Public Property ValueToCompare As String
'Usage
Dim instance As CompareValidator
Dim value As String

value = instance.ValueToCompare

instance.ValueToCompare = value

[ThemeableAttribute(false)] 
public string ValueToCompare { get; set; }

[ThemeableAttribute(false)] 
public:
property String^ ValueToCompare {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_ValueToCompare ()

/** @property */
public void set_ValueToCompare (String value)

public function get ValueToCompare () : String

public function set ValueToCompare (value : String)

Eigenschaftenwert

Der konstante Wert, der mit dem vom Benutzer im validierten Eingabesteuerelement eingegebenen Wert verglichen werden soll. Der Standardwert ist String.Empty.

Hinweise

Geben Sie mit der ValueToCompare-Eigenschaft einen konstanten Wert an, der mit dem vom Benutzer im validierten Eingabesteuerelement eingegebenen Wert verglichen werden soll. Wenn der durch diese Eigenschaft angegebene konstante Wert nicht in den durch die BaseCompareValidator.Type-Eigenschaft angegebenen Datentyp konvertiert werden kann, wird eine Ausnahme ausgelöst.

Hinweis

Legen Sie nicht gleichzeitig die ControlToCompare-Eigenschaft und die ValueToCompare-Eigenschaft fest. Sie können den Wert eines Eingabesteuerelements mit dem eines anderen Eingabesteuerelements oder mit einem konstanten Wert vergleichen. Wenn beide Eigenschaften festgelegt sind, hat die ControlToCompare-Eigenschaft Vorrang.

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.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie der vom Benutzer in einem TextBox-Steuerelement eingegebene Wert mithilfe der ValueToCompare-Eigenschaft mit einem konstanten Wert verglichen wird.

<%@ Page Language="VB" AutoEventWireup="True" %>
 
<html>
<head>
   <script runat="server">
 
      Sub Button_Click(sender As Object, e As EventArgs) 

         Dim rand_number As New Random()

         Compare1.ValueToCompare = rand_number.Next(1, 10).ToString()
         Compare1.Validate()
 
         If Page.IsValid Then 
         
            lblOutput.Text = "You guessed correctly!!"
         
         Else 
         
            lblOutput.Text = "You guessed poorly"
         
         End If

         lblOutput.Text &= "<br><br>" & "The number is: " & Compare1.ValueToCompare

      End Sub
 
   </script>
 
</head>
<body>
 
   <form runat="server">

      <h3>CompareValidator ValueToCompare Example</h3>

      <h5><Pick a number between 1 and 10:</h5>
      <asp:TextBox id="TextBox1" 
           runat="server"/>

      <br><br>

      <asp:Button id="Button1"
           Text="Submit"
           OnClick="Button_Click"
           runat="server"/>

      <br><br>
       
      <asp:CompareValidator id="Compare1" 
           ControlToValidate="TextBox1"
           ValueToCompare="0"  
           Type="Integer"
           EnableClientScript="False" 
           runat="server"/>
 
      <br>
       
      <asp:Label id="lblOutput" 
           Font-Name="verdana" 
           Font-Size="10pt" 
           runat="server"/>
 
   </form>
 
</body>
</html>

<%@ Page Language="C#" AutoEventWireup="True" %>
 
<html>
<head>
   <script runat="server">
 
      void Button_Click(Object sender, EventArgs e) 
      {

         Random rand_number = new Random();

         Compare1.ValueToCompare = rand_number.Next(1, 10).ToString();
         Compare1.Validate();
 
         if (Page.IsValid) 
         {
            lblOutput.Text = "You guessed correctly!!";
         }
         else 
         {
            lblOutput.Text = "You guessed poorly";
         }

         lblOutput.Text += "<br><br>" + "The number is: " + Compare1.ValueToCompare;

      }
 
   </script>
 
</head>
<body>
 
   <form runat="server">

      <h3>CompareValidator ValueToCompare Example</h3>

      <h5><Pick a number between 1 and 10:</h5>
      <asp:TextBox id="TextBox1" 
           runat="server"/>

      <br><br>

      <asp:Button id="Button1"
           Text="Submit"
           OnClick="Button_Click"
           runat="server"/>

      <br><br>
       
      <asp:CompareValidator id="Compare1" 
           ControlToValidate="TextBox1"
           ValueToCompare="0"  
           Type="Integer"
           EnableClientScript="False" 
           runat="server"/>
 
      <br>
       
      <asp:Label id="lblOutput" 
           Font-Name="verdana" 
           Font-Size="10pt" 
           runat="server"/>
 
   </form>
 
</body>
</html>

<%@ Page Language="JScript" AutoEventWireup="True" %>
 
<html>
<head>
   <script runat="server">
 
      function Button_Click(sender, e : EventArgs) 
      {

         var rand_number : Random = new Random();

         Compare1.ValueToCompare = rand_number.Next(1, 10).ToString();
         Compare1.Validate();
 
         if (Page.IsValid) 
         {
            lblOutput.Text = "You guessed correctly!!";
         }
         else 
         {
            lblOutput.Text = "You guessed poorly";
         }

         lblOutput.Text += "<br><br>" + "The number is: " + Compare1.ValueToCompare;

      }
 
   </script>
 
</head>
<body>
 
   <form runat="server">

      <h3>CompareValidator ValueToCompare Example</h3>

      <h5><Pick a number between 1 and 10:</h5>
      <asp:TextBox id="TextBox1" 
           runat="server"/>

      <br><br>

      <asp:Button id="Button1"
           Text="Submit"
           OnClick="Button_Click"
           runat="server"/>

      <br><br>
       
      <asp:CompareValidator id="Compare1" 
           ControlToValidate="TextBox1"
           ValueToCompare="0"  
           Type="Integer"
           EnableClientScript="False" 
           runat="server"/>
 
      <br>
       
      <asp:Label id="lblOutput" 
           Font-Name="verdana" 
           Font-Size="10pt" 
           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

CompareValidator-Klasse
CompareValidator-Member
System.Web.UI.WebControls-Namespace
CompareValidator.ControlToCompare-Eigenschaft
BaseCompareValidator.Type-Eigenschaft
BaseValidator.IsValid-Eigenschaft
String.Empty

Freigeben über