CompareValidator Klasse

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Vergleicht den vom Benutzer in einem Eingabesteuerelement eingegebenen Wert mit dem Wert, der in ein anderes Eingabesteuerelement eingegeben wurde, oder mit einem konstanten Wert.

public ref class CompareValidator : System::Web::UI::WebControls::BaseCompareValidator

public class CompareValidator : System.Web.UI.WebControls.BaseCompareValidator

type CompareValidator = class
    inherit BaseCompareValidator

Public Class CompareValidator
Inherits BaseCompareValidator

Vererbung: Object

Control

WebControl

Label

BaseValidator

BaseCompareValidator
CompareValidator

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe eines CompareValidator Steuerelements die Werte in zwei TextBox Steuerelementen vergleichen.

Von Bedeutung

In diesem Beispiel handelt es sich um ein Textfeld, das Benutzereingaben akzeptiert, bei denen es sich um eine potenzielle Sicherheitsrisiken handelt. Standardmäßig überprüfen ASP.NET Webseiten, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter Script Exploits Overview.

<%@ Page Language="C#" AutoEventWireup="True" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>CompareValidator Example</title>
<script runat="server">
 
      void Button_Click(Object sender, EventArgs e) 
      {
 
         if (Page.IsValid) 
         {
            lblOutput.Text = "Result: Valid!";
         }
         else 
         {
            lblOutput.Text = "Result: Not valid!";
         }

      }
 
      void Operator_Index_Changed(Object sender, EventArgs e) 
      {

         Compare1.Operator = (ValidationCompareOperator) ListOperator.SelectedIndex;
         Compare1.Validate();

      }

      void Type_Index_Changed(Object sender, EventArgs e) 
      {

         Compare1.Type = (ValidationDataType) ListType.SelectedIndex;
         Compare1.Validate();

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

      <h3>CompareValidator Example</h3>
      <br />
      Enter a value in each textbox. Select a comparison operator<br />
      and data type. Click "Validate" to compare values.
 
      <table style="background-color:#eeeeee; padding:10">

         <tr valign="top">

            <td>

               <h5>String 1:</h5>
               <asp:TextBox id="TextBox1" 
                    runat="server"/>

            </td>

            <td>

               <h5>Comparison Operator:</h5>
 
               <asp:ListBox id="ListOperator" 
                    OnSelectedIndexChanged="Operator_Index_Changed" 
                    runat="server">

                  <asp:ListItem Selected="True" Value="Equal">Equal</asp:ListItem>
                  <asp:ListItem Value="NotEqual">NotEqual</asp:ListItem>
                  <asp:ListItem Value="GreaterThan">GreaterThan</asp:ListItem>
                  <asp:ListItem Value="GreaterThanEqual">GreaterThanEqual</asp:ListItem>
                  <asp:ListItem Value="LessThan">LessThan</asp:ListItem>
                  <asp:ListItem Value="LessThanEqual">LessThanEqual</asp:ListItem>
                  <asp:ListItem Value="DataTypeCheck">DataTypeCheck</asp:ListItem>

               </asp:ListBox>

            </td>

            <td>

               <h5>String 2:</h5>
               <asp:TextBox id="TextBox2" 
                    runat="server"/>
               <br />
               <asp:Button id="Button1"
                    Text="Validate"  
                    OnClick="Button_Click" 
                    runat="server"/>

            </td>
         </tr>

         <tr>
            <td colspan="3" align="center">

               <h5>Data Type:</h5>

               <asp:ListBox id="ListType" 
                    OnSelectedIndexChanged="Type_Index_Changed" 
                    runat="server">

                  <asp:ListItem Selected="true" Value="String" >String</asp:ListItem>
                  <asp:ListItem Value="Integer" >Integer</asp:ListItem>
                  <asp:ListItem Value="Double" >Double</asp:ListItem>
                  <asp:ListItem Value="Date" >Date</asp:ListItem>
                  <asp:ListItem Value="Currency" >Currency</asp:ListItem>

               </asp:ListBox>
            </td>
         </tr>
      </table>
 
      <asp:CompareValidator id="Compare1" 
           ControlToValidate="TextBox1" 
           ControlToCompare="TextBox2"
           EnableClientScript="False" 
           Type="String" 
           runat="server"/>
 
      <br />
       
      <asp:Label id="lblOutput" 
           Font-Names="verdana" 
           Font-Size="10pt" 
           runat="server"/>
 
   </form>
 
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>CompareValidator Example</title>
<script runat="server">
 
      Sub Button_Click(sender As Object, e As EventArgs) 
 
         If Page.IsValid Then 
         
            lblOutput.Text = "Result: Valid!"
         
         Else 
         
            lblOutput.Text = "Result: Not valid!"
         
         End If

      End Sub
 
      Sub Operator_Index_Changed(sender As Object, e As EventArgs) 

         Compare1.Operator = CType(ListOperator.SelectedIndex, ValidationCompareOperator)
         Compare1.Validate()

      End Sub

      Sub Type_Index_Changed(sender As Object, e As EventArgs) 

         Compare1.Type = CType(ListType.SelectedIndex, ValidationDataType)
         Compare1.Validate()

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

      <h3>CompareValidator Example</h3>
      <br />
      Enter a value in each textbox. Select a comparison operator<br />
      and data type. Click "Validate" to compare values.
 
      <table style="background-color:#eeeeee; padding:10">

         <tr valign="top">

            <td>

               <h5>String 1:</h5>
               <asp:TextBox id="TextBox1" 
                    runat="server"/>

            </td>

            <td>

               <h5>Comparison Operator:</h5>
 
               <asp:ListBox id="ListOperator" 
                    OnSelectedIndexChanged="Operator_Index_Changed" 
                    runat="server">

                  <asp:ListItem Selected="True" Value="Equal">Equal</asp:ListItem>
                  <asp:ListItem Value="NotEqual">NotEqual</asp:ListItem>
                  <asp:ListItem Value="GreaterThan">GreaterThan</asp:ListItem>
                  <asp:ListItem Value="GreaterThanEqual">GreaterThanEqual</asp:ListItem>
                  <asp:ListItem Value="LessThan">LessThan</asp:ListItem>
                  <asp:ListItem Value="LessThanEqual">LessThanEqual</asp:ListItem>
                  <asp:ListItem Value="DataTypeCheck">DataTypeCheck</asp:ListItem>

               </asp:ListBox>

            </td>

            <td>

               <h5>String 2:</h5>
               <asp:TextBox id="TextBox2" 
                    runat="server"/>
               <br />
               <asp:Button id="Button1"
                    Text="Validate"  
                    OnClick="Button_Click" 
                    runat="server"/>

            </td>
         </tr>

         <tr>
            <td colspan="3" align="center">

               <h5>Data Type:</h5>

               <asp:ListBox id="ListType" 
                    OnSelectedIndexChanged="Type_Index_Changed" 
                    runat="server">

                  <asp:ListItem Selected="true" Value="String" >String</asp:ListItem>
                  <asp:ListItem Value="Integer" >Integer</asp:ListItem>
                  <asp:ListItem Value="Double" >Double</asp:ListItem>
                  <asp:ListItem Value="Date" >Date</asp:ListItem>
                  <asp:ListItem Value="Currency" >Currency</asp:ListItem>

               </asp:ListBox>
            </td>
         </tr>
      </table>
 
      <asp:CompareValidator id="Compare1" 
           ControlToValidate="TextBox1" 
           ControlToCompare="TextBox2"
           EnableClientScript="False" 
           Type="String" 
           runat="server"/>
 
      <br />
       
      <asp:Label id="lblOutput" 
           Font-Names="verdana" 
           Font-Size="10pt" 
           runat="server"/>
 
   </form>
 
</body>
</html>

Hinweise

Verwenden Sie das CompareValidator Steuerelement, um den vom Benutzer in einem Eingabesteuerelement eingegebenen Wert zu vergleichen, z. B. ein TextBox Steuerelement, mit dem Wert, der in ein anderes Eingabesteuerelement eingegeben wurde, oder einen konstanten Wert. Das CompareValidator Steuerelement übergibt die Überprüfung, wenn der Wert des Eingabesteuerelements den durch die OperatorEigenschaften , ValueToCompareund/oder ControlToCompare Eigenschaften angegebenen Kriterien entspricht.

Sie können das CompareValidator Steuerelement auch verwenden, um anzugeben, ob der in einem Eingabesteuerelement eingegebene Wert in den durch die BaseCompareValidator.Type Eigenschaft angegebenen Datentyp konvertiert werden kann.

Geben Sie das zu überprüfende Eingabesteuerelement an, indem Sie die ControlToValidate Eigenschaft festlegen. Wenn Sie ein bestimmtes Eingabesteuerelement mit einem anderen Eingabesteuerelement vergleichen möchten, legen Sie die ControlToCompare Eigenschaft fest, um das zu vergleichende Steuerelement anzugeben.

Hinweis

Wenn der in das von der Eigenschaft angegebene Eingabesteuerelement eingegebene Wert nicht in den von der ControlToCompare BaseCompareValidator.Type Eigenschaft angegebenen Datentyp konvertiert werden kann, der in das von der ControlToValidate Eigenschaft angegebene Eingabesteuerelement eingegebene Wert jedoch konvertiert werden kann, wird das überprüfte Eingabesteuerelement als gültig betrachtet. Daher sollten Sie auch ein Steuerelement oder RangeValidator ein CompareValidator Steuerelement auf das von der ControlToCompare Eigenschaft angegebene Eingabesteuerelement platzieren.

Anstatt den Wert eines Eingabesteuerelements mit einem anderen Eingabesteuerelement zu vergleichen, können Sie den Wert eines Eingabesteuerelements mit einem konstanten Wert vergleichen. Geben Sie den konstanten Wert an, mit dem verglichen werden soll, indem Sie die ValueToCompare Eigenschaft festlegen.

Hinweis

Wenn der durch die ValueToCompare Eigenschaft angegebene Wert nicht in den durch die BaseCompareValidator.Type Eigenschaft angegebenen Datentyp konvertiert werden kann, wird eine Ausnahme ausgelöst. Überprüfen Sie unbedingt den Datentyp eines Werts, bevor Sie ihn programmgesteuert der ValueToCompare Eigenschaft zuweisen.

Hinweis

Legen Sie nicht gleichzeitig sowohl die ControlToCompare Eigenschaft als auch die ValueToCompare Eigenschaft fest. Sie können entweder den Wert eines Eingabesteuerelements mit einem anderen Eingabesteuerelement oder mit einem konstanten Wert vergleichen. Wenn beide Eigenschaften festgelegt sind, hat die ControlToCompare Eigenschaft Vorrang.

Verwenden Sie die Operator Eigenschaft, um den auszuführenden Vergleichstyp anzugeben, z. B. größer als, gleich usw. Wenn Sie die Operator Eigenschaft auf ValidationCompareOperator.DataTypeCheckfestlegen, ignoriert das CompareValidator Steuerelement die ControlToCompare eigenschaften und ValueToCompare gibt einfach an, ob der in das Eingabesteuerelement eingegebene Wert in den durch die BaseCompareValidator.Type Eigenschaft angegebenen Datentyp konvertiert werden kann.

Die BaseCompareValidator.Type Eigenschaft wird verwendet, um den Datentyp beider Vergleichswerte anzugeben. Beide Werte werden automatisch in diesen Datentyp konvertiert, bevor der Vergleichsvorgang ausgeführt wird.

Von Bedeutung

Wenn die Type Eigenschaft auf Date den aktuellen Kalendertyp festgelegt ist und der aktuelle Kalendertyp nicht gregorianisch ist, führt der Validator nur serverseitige Überprüfungen durch. Das Validator-Clientskript unterstützt nur gregorianische Kalender.

In der folgenden Tabelle sind die verschiedenen Datentypen aufgeführt, die verglichen werden können.

Datentyp	Beschreibung
`String`	Ein Zeichenfolgendatentyp.
`Integer`	Ein 32-Bit-ganzzahliger Datentyp mit Vorzeichen.
`Double`	Ein Gleitkommazahlen-Datentyp mit doppelter Genauigkeit.
`Date`	Ein Datumsdatentyp.
`Currency`	Ein Dezimaldatentyp. Sie darf keine Währungssymbole enthalten.

Hinweis

Wenn das Eingabesteuerelement leer ist, werden keine Überprüfungsfunktionen aufgerufen und die Überprüfung erfolgreich ausgeführt. Verwenden Sie ein RequiredFieldValidator Steuerelement, um festzulegen, dass der Benutzer Daten in das Eingabesteuerelement eingibt.

Hinweis

Wenn Sie das CompareValidator Steuerelement innerhalb eines UpdatePanel Steuerelements verwenden, stellen Sie sicher, dass sich das Validator-Steuerelement und das Steuerelement, dem es zugeordnet ist, im selben Bereich befinden. Weitere Informationen zur Verwendung des UpdatePanel Steuerelements für Partielle Seitenaktualisierungen finden Sie unter Partial-Page Rendering Overview.

Weitere Informationen zu Überprüfungssteuerelementen finden Sie unter BaseValidator.

Zugänglichkeit

Informationen zum Konfigurieren dieses Steuerelements, sodass es Markup generiert, das den Barrierefreiheitsstandards entspricht, finden Sie unter Barrierefreiheit in Visual Studio und ASP.NET und ASP.NET Steuerelemente und Barrierefreiheit.

Konstruktoren

Name	Beschreibung
CompareValidator()	Initialisiert eine neue Instanz der CompareValidator-Klasse.

Eigenschaften

Name	Beschreibung
AccessKey	Dient zum Abrufen oder Festlegen der Zugriffstaste, mit der Sie schnell zum Webserversteuerelement navigieren können. (Geerbt von WebControl)
Adapter	Ruft den browserspezifischen Adapter für das Steuerelement ab. (Geerbt von Control)
AppRelativeTemplateSourceDirectory	Dient zum Abrufen oder Festlegen des anwendungsrelativen virtuellen Verzeichnisses des Page Objekts UserControl , das dieses Steuerelement enthält. (Geerbt von Control)
AssociatedControlID	Diese Eigenschaft wird nicht unterstützt. (Geerbt von BaseValidator)
Attributes	Ruft die Auflistung beliebiger Attribute (nur für das Rendern) ab, die nicht den Eigenschaften des Steuerelements entsprechen. (Geerbt von WebControl)
BackColor	Dient zum Abrufen oder Festlegen der Hintergrundfarbe des Webserversteuerelements. (Geerbt von WebControl)
BindingContainer	Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Geerbt von Control)
BorderColor	Ruft die Rahmenfarbe des Websteuerelements ab oder legt diese fest. (Geerbt von WebControl)
BorderStyle	Dient zum Abrufen oder Festlegen des Rahmenstils des Webserversteuerelements. (Geerbt von WebControl)
BorderWidth	Ruft die Rahmenbreite des Webserversteuerelements ab oder legt diese fest. (Geerbt von WebControl)
ChildControlsCreated	Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Geerbt von Control)
ClientID	Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird. (Geerbt von Control)
ClientIDMode	Dient zum Abrufen oder Festlegen des Algorithmus, der zum Generieren des Werts der ClientID Eigenschaft verwendet wird. (Geerbt von Control)
ClientIDSeparator	Ruft einen Zeichenwert ab, der das Trennzeichen darstellt, das in der ClientID Eigenschaft verwendet wird. (Geerbt von Control)
Context	Ruft das Objekt ab, das HttpContext dem Serversteuerelement für die aktuelle Webanforderung zugeordnet ist. (Geerbt von Control)
Controls	Ruft ein ControlCollection Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Ui-Hierarchie darstellt. (Geerbt von Control)
ControlStyle	Ruft den Stil des Webserversteuerelements ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl)
ControlStyleCreated	Ruft einen Wert ab, der angibt, ob ein Style Objekt für die ControlStyle Eigenschaft erstellt wurde. Diese Eigenschaft wird in erster Linie von Steuerelemententwicklern verwendet. (Geerbt von WebControl)
ControlToCompare	Ruft ab oder legt das Eingabesteuerelement fest, das mit dem zu überprüfenden Eingabesteuerelement verglichen wird.
ControlToValidate	Ruft das zu überprüfende Eingabesteuerelement ab oder legt es fest. (Geerbt von BaseValidator)
CssClass	Dient zum Abrufen oder Festlegen der Cascading StyleSheet (CSS)-Klasse, die vom Webserversteuerelement auf dem Client gerendert wird. (Geerbt von WebControl)
CultureInvariantValues	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Werte vor dem Vergleich in ein kulturneutrales Format konvertiert werden. (Geerbt von BaseCompareValidator)
DataItemContainer	Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataItemContainerimplementiert wird. (Geerbt von Control)
DataKeysContainer	Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataKeysControlimplementiert wird. (Geerbt von Control)
DesignMode	Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Geerbt von Control)
Display	Dient zum Abrufen oder Festlegen des Anzeigeverhaltens der Fehlermeldung in einem Überprüfungssteuerelement. (Geerbt von BaseValidator)
EnableClientScript	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die clientseitige Überprüfung aktiviert ist. (Geerbt von BaseValidator)
Enabled	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Überprüfungssteuerelement aktiviert ist. (Geerbt von BaseValidator)
EnableTheming	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Designs für dieses Steuerelement gelten. (Geerbt von WebControl)
EnableViewState	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Serversteuerelement den Ansichtszustand und den Ansichtszustand aller enthaltenen untergeordneten Steuerelemente für den anfordernden Client behält. (Geerbt von Control)
ErrorMessage	Ruft den Text für die Fehlermeldung ab, die in einem ValidationSummary Steuerelement angezeigt wird, wenn die Überprüfung fehlschlägt, oder legt diesen fest. (Geerbt von BaseValidator)
Events	Ruft eine Liste von Ereignishandlerdelegatten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Control)
Font	Ruft die Schriftarteigenschaften ab, die dem Webserversteuerelement zugeordnet sind. (Geerbt von WebControl)
ForeColor	Ruft die Farbe der Meldung ab, die angezeigt wird, wenn die Überprüfung fehlschlägt, oder legt sie fest. (Geerbt von BaseValidator)
HasAttributes	Ruft einen Wert ab, der angibt, ob das Steuerelement Attribute festgelegt hat. (Geerbt von WebControl)
HasChildViewState	Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des aktuellen Serversteuerelements über gespeicherte Ansichtszustandseinstellungen verfügen. (Geerbt von Control)
Height	Ruft die Höhe des Webserversteuerelements ab oder legt sie fest. (Geerbt von WebControl)
ID	Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Geerbt von Control)
IdSeparator	Ruft das Zeichen ab, das zum Trennen von Steuerelementbezeichnern verwendet wird. (Geerbt von Control)
IsChildControlStateCleared	Ruft einen Wert ab, der angibt, ob In diesem Steuerelement enthaltene Steuerelemente den Steuerelementstatus aufweisen. (Geerbt von Control)
IsEnabled	Ruft einen Wert ab, der angibt, ob das Steuerelement aktiviert ist. (Geerbt von WebControl)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen am Ansichtszustand speichert. (Geerbt von Control)
IsUnobtrusive	Ruft einen Wert ab, der angibt, ob das Steuerelement unauffälliges JavaScript generiert. (Geerbt von BaseValidator)
IsValid	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das zugeordnete Eingabesteuerelement die Überprüfung bestanden hat. (Geerbt von BaseValidator)
IsViewStateEnabled	Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Geerbt von Control)
LoadViewStateByID	Ruft einen Wert ab, der angibt, ob das Steuerelement am Laden des Ansichtszustands anstelle ID von Index teilnimmt. (Geerbt von Control)
NamingContainer	Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace für die Unterscheidung zwischen Serversteuerelementen mit demselben ID Eigenschaftswert erstellt. (Geerbt von Control)
Operator	Ruft den auszuführenden Vergleichsvorgang ab oder legt diesen fest.
Page	Ruft einen Verweis auf die Page Instanz ab, die das Serversteuerelement enthält. (Geerbt von Control)
Parent	Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Seitensteuerelementhierarchie ab. (Geerbt von Control)
PropertiesValid	Ruft einen Wert ab, der angibt, ob das durch die ControlToValidate Eigenschaft angegebene Steuerelement ein gültiges Steuerelement ist. (Geerbt von BaseValidator)
RenderingCompatibility	Ruft einen Wert ab, der die ASP.NET Version angibt, mit der html gerendert wird, kompatibel ist. (Geerbt von Control)
RenderUplevel	Ruft einen Wert ab, der angibt, ob der Browser des Clients "uplevel"-Rendering unterstützt. (Geerbt von BaseValidator)
SetFocusOnError	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Fokus auf das von der Eigenschaft angegebene Steuerelement festgelegt ist, wenn die ControlToValidate Überprüfung fehlschlägt. (Geerbt von BaseValidator)
Site	Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostt, wenn es auf einer Entwurfsoberfläche gerendert wird. (Geerbt von Control)
SkinID	Ruft die Haut ab, die auf das Steuerelement angewendet werden soll, oder legt sie fest. (Geerbt von WebControl)
Style	Ruft eine Auflistung von Textattributen ab, die als Formatvorlagenattribute auf dem äußeren Tag des Webserversteuerelements gerendert werden. (Geerbt von WebControl)
SupportsDisabledAttribute	Ruft einen Wert ab, der angibt, ob das Steuerelement das `disabled` Attribut des gerenderten HTML-Elements auf "disabled" festlegen soll, wenn die Eigenschaft des Steuerelements IsEnabled ist `false`. (Geerbt von Label)
TabIndex	Dient zum Abrufen oder Festlegen des Registerkartenindex des Webserversteuerelements. (Geerbt von WebControl)
TagKey	Ruft das HTML-Tag ab, das zum Rendern des Label Steuerelements verwendet wird. (Geerbt von Label)
TagName	Ruft den Namen des Steuerelementtags ab. Diese Eigenschaft wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl)
TemplateControl	Dient zum Abrufen oder Festlegen eines Verweises auf die Vorlage, die dieses Steuerelement enthält. (Geerbt von Control)
TemplateSourceDirectory	Ruft das virtuelle Verzeichnis des Page oder UserControl das aktuelle Serversteuerelement ab. (Geerbt von Control)
Text	Ruft den Text ab, der im Überprüfungssteuerelement angezeigt wird, wenn die Überprüfung fehlschlägt, oder legt diesen fest. (Geerbt von BaseValidator)
ToolTip	Ruft den Text ab, der angezeigt wird, wenn der Mauszeiger auf das Webserversteuerelement zeigt, oder legt diesen fest. (Geerbt von WebControl)
Type	Ruft den Datentyp ab, in den die verglichenen Werte konvertiert werden, bevor der Vergleich erfolgt, oder legt diesen fest. (Geerbt von BaseCompareValidator)
UniqueID	Ruft den eindeutigen hierarchisch qualifizierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control)
ValidateRequestMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement Clienteingaben aus dem Browser auf potenziell gefährliche Werte überprüft. (Geerbt von Control)
ValidationGroup	Dient zum Abrufen oder Festlegen des Namens der Überprüfungsgruppe, zu der dieses Überprüfungssteuerelement gehört. (Geerbt von BaseValidator)
ValueToCompare	Dient zum Abrufen oder Festlegen eines Konstantenwerts, der mit dem vom Benutzer eingegebenen Wert im zu überprüfenden Eingabesteuerelement verglichen werden soll.
ViewState	Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements für mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von Control)
ViewStateIgnoresCase	Ruft einen Wert ab, der angibt, ob die Groß-/Kleinschreibung des StateBag Objekts nicht beachtet wird. (Geerbt von Control)
ViewStateMode	Ruft den Ansichtszustandsmodus dieses Steuerelements ab oder legt diesen fest. (Geerbt von Control)
Visible	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Serversteuerelement als Benutzeroberfläche auf der Seite gerendert wird. (Geerbt von Control)
Width	Dient zum Abrufen oder Festlegen der Breite des Webserversteuerelements. (Geerbt von WebControl)

Methoden

Name	Beschreibung
AddAttributesToRender(HtmlTextWriter)	Fügt dem Ausgabedatenstrom zum Rendern auf dem Client die Attribute dieses Steuerelements hinzu.
AddedControl(Control, Int32)	Wird aufgerufen, nachdem der Auflistung des Objekts ein untergeordnetes Control Steuerelement hinzugefügt Controls wurde. (Geerbt von Control)
AddParsedSubObject(Object)	Benachrichtigt das Steuerelement, dass ein Element analysiert wurde, und fügt das Element dem Label Steuerelement hinzu. (Geerbt von Label)
ApplyStyle(Style)	Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, wobei alle vorhandenen Formatvorlagenelemente des Steuerelements überschrieben werden. Diese Methode wird in erster Linie von Steuerelemententwicklern verwendet. (Geerbt von WebControl)
ApplyStyleSheetSkin(Page)	Wendet die im Seitenstylesheet definierten Formatvorlageneigenschaften auf das Steuerelement an. (Geerbt von Control)
BeginRenderTracing(TextWriter, Object)	Beginnt mit der Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control)
BuildProfileTree(String, Boolean)	Sammelt Informationen über das Serversteuerelement und liefert sie an die Eigenschaft, die Trace angezeigt werden soll, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Geerbt von Control)
CheckControlValidationProperty(String, String)	Überprüft, ob sich das angegebene Steuerelement auf der Seite befindet und Überprüfungseigenschaften enthält. (Geerbt von BaseValidator)
ClearCachedClientID()	Legt den zwischengespeicherten ClientID Wert auf `null`. (Geerbt von Control)
ClearChildControlState()	Löscht die Steuerelementstatusinformationen für die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
ClearChildState()	Löscht die Ansichts- und Steuerelementstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
ClearChildViewState()	Löscht die Ansichtsstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
ClearEffectiveClientIDMode()	Legt die ClientIDMode Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit. (Geerbt von Control)
ControlPropertiesValid()	Überprüft die Eigenschaften des Steuerelements auf gültige Werte.
CopyBaseAttributes(WebControl)	Kopiert die Eigenschaften, die nicht vom Objekt aus dem Style angegebenen Webserversteuerelement in das Webserversteuerelement gekapselt werden, von dem diese Methode aufgerufen wird. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl)
CreateChildControls()	Wird vom ASP.NET Seitenframework aufgerufen, um Serversteuerelemente zu benachrichtigen, die kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf das Veröffentlichen von Zurück- oder Rendering enthalten. (Geerbt von Control)
CreateControlCollection()	Erstellt ein neues ControlCollection Objekt, das die untergeordneten Steuerelemente (literal und server) des Serversteuerelements enthält. (Geerbt von Control)
CreateControlStyle()	Erstellt das Formatvorlagenobjekt, das intern von der WebControl Klasse verwendet wird, um alle formatbezogenen Eigenschaften zu implementieren. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl)
DataBind()	Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente. (Geerbt von Control)
DataBind(Boolean)	Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit einer Option zum Auslösen des DataBinding Ereignisses. (Geerbt von Control)
DataBindChildren()	Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
DetermineRenderUplevel()	Bestimmt, ob das Überprüfungssteuerelement für einen neueren Browser ("auf Ebene") gerendert werden kann. (Geerbt von BaseCompareValidator)
Dispose()	Ermöglicht es einem Serversteuerelement, die endgültige Bereinigung durchzuführen, bevor es aus dem Arbeitsspeicher freigegeben wird. (Geerbt von Control)
EndRenderTracing(TextWriter, Object)	Beendet die Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control)
EnsureChildControls()	Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn dies nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Geerbt von Control)
EnsureID()	Erstellt einen Bezeichner für Steuerelemente, denen kein Bezeichner zugewiesen ist. (Geerbt von Control)
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
EvaluateIsValid()	Wenn diese Methode in einer abgeleiteten Klasse überschrieben wird, enthält diese Methode den Code, um zu bestimmen, ob der Wert im Eingabesteuerelement gültig ist.
FindControl(String, Int32)	Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit der angegebenen `id` und einer ganzzahligen Zahl, die `pathOffset` im Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl Methode nicht außer Kraft setzen. (Geerbt von Control)
FindControl(String)	Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit dem angegebenen `id` Parameter. (Geerbt von Control)
Focus()	Legt den Eingabefokus auf ein Steuerelement fest. (Geerbt von Control)
GetControlRenderID(String)	Ruft die Client-ID des angegebenen Steuerelements ab. (Geerbt von BaseValidator)
GetControlValidationValue(String)	Ruft den Wert ab, der dem angegebenen Eingabesteuerelement zugeordnet ist. (Geerbt von BaseValidator)
GetDesignModeState()	Ruft Entwurfszeitdaten für ein Steuerelement ab. (Geerbt von Control)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetRouteUrl(Object)	Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control)
GetRouteUrl(RouteValueDictionary)	Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control)
GetRouteUrl(String, Object)	Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control)
GetRouteUrl(String, RouteValueDictionary)	Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
GetUniqueIDRelativeTo(Control)	Gibt den präfixierten Teil der UniqueID Eigenschaft des angegebenen Steuerelements zurück. (Geerbt von Control)
HasControls()	Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Geerbt von Control)
HasEvents()	Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder untergeordnete Steuerelemente registriert sind. (Geerbt von Control)
IsLiteralContent()	Bestimmt, ob das Serversteuerelement nur Literalinhalte enthält. (Geerbt von Control)
LoadControlState(Object)	Stellt Steuerstatusinformationen aus einer vorherigen Seitenanforderung wieder her, die von der SaveControlState() Methode gespeichert wurde. (Geerbt von Control)
LoadViewState(Object)	Lädt den zuvor gespeicherten Zustand für das Steuerelement. (Geerbt von Label)
MapPathSecure(String)	Ruft den physischen Pfad ab, dem ein virtueller Pfad, entweder absolut oder relativ, zugeordnet ist. (Geerbt von Control)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
MergeStyle(Style)	Kopiert alle nicht leeren Elemente der angegebenen Formatvorlage in das Websteuerelement, überschreibt jedoch keine vorhandenen Formatvorlagenelemente des Steuerelements. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl)
OnBubbleEvent(Object, EventArgs)	Bestimmt, ob das Ereignis für das Serversteuerelement an die Ui-Serversteuerelementhierarchie der Seite übergeben wird. (Geerbt von Control)
OnDataBinding(EventArgs)	Löst das DataBinding-Ereignis aus. (Geerbt von Control)
OnInit(EventArgs)	Löst das Init-Ereignis aus. (Geerbt von BaseValidator)
OnLoad(EventArgs)	Löst das Load-Ereignis aus. (Geerbt von Control)
OnPreRender(EventArgs)	Löst das PreRender-Ereignis aus. (Geerbt von BaseValidator)
OnUnload(EventArgs)	Löst das Unload-Ereignis aus. (Geerbt von BaseValidator)
OpenFile(String)	Ruft einen Stream Verwendeten zum Lesen einer Datei ab. (Geerbt von Control)
RaiseBubbleEvent(Object, EventArgs)	Weist alle Quellen des Ereignisses und dessen Informationen dem übergeordneten Element des Steuerelements zu. (Geerbt von Control)
RegisterValidatorCommonScript()	Registriert Code auf der Seite für die clientseitige Überprüfung. (Geerbt von BaseValidator)
RegisterValidatorDeclaration()	Registriert eine ECMAScript-Arraydeklaration mithilfe des Arraynamens `Page_Validators`. (Geerbt von BaseValidator)
RemovedControl(Control)	Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls Auflistung des Control Objekts entfernt wurde. (Geerbt von Control)
Render(HtmlTextWriter)	Zeigt das Steuerelement auf dem Client an. (Geerbt von BaseValidator)
RenderBeginTag(HtmlTextWriter)	Rendert das HTML-Öffnungstag des Steuerelements an den angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl)
RenderChildren(HtmlTextWriter)	Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements in ein bereitgestelltes HtmlTextWriter Objekt aus, das den inhalt schreibt, der auf dem Client gerendert werden soll. (Geerbt von Control)
RenderContents(HtmlTextWriter)	Rendert den Inhalt des Inhalts in Label den angegebenen Writer. (Geerbt von Label)
RenderControl(HtmlTextWriter, ControlAdapter)	Gibt den Inhalt des Serversteuerelements mithilfe eines bereitgestellten Objekts an ein bereitgestelltes HtmlTextWriter ControlAdapter Objekt aus. (Geerbt von Control)
RenderControl(HtmlTextWriter)	Gibt Den Inhalt des Serversteuerelements an ein bereitgestelltes HtmlTextWriter Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, wenn die Ablaufverfolgung aktiviert ist. (Geerbt von Control)
RenderEndTag(HtmlTextWriter)	Rendert das HTML-Schließen-Tag des Steuerelements in den angegebenen Writer. Diese Methode wird hauptsächlich von Steuerelemententwicklern verwendet. (Geerbt von WebControl)
ResolveAdapter()	Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Geerbt von Control)
ResolveClientUrl(String)	Ruft eine URL ab, die vom Browser verwendet werden kann. (Geerbt von Control)
ResolveUrl(String)	Wandelt eine URL in eine URL um, die auf dem anfordernden Client verwendet werden kann. (Geerbt von Control)
SaveControlState()	Speichert alle Änderungen des Serversteuerelementstatus, die seit dem Zeitpunkt der Zurückpostung der Seite auf dem Server aufgetreten sind. (Geerbt von Control)
SaveViewState()	Speichert jeden Zustand, der geändert wurde, nachdem die TrackViewState() Methode aufgerufen wurde. (Geerbt von WebControl)
SetDesignModeState(IDictionary)	Legt Entwurfszeitdaten für ein Steuerelement fest. (Geerbt von Control)
SetRenderMethodDelegate(RenderMethod)	Weist einen Ereignishandlerdelegat zu, um das Serversteuerelement und dessen Inhalt in seinem übergeordneten Steuerelement zu rendern. (Geerbt von Control)
SetTraceData(Object, Object, Object)	Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des ablaufverfolgungsobjekts, des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control)
SetTraceData(Object, Object)	Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TrackViewState()	Bewirkt, dass das Steuerelement Änderungen am Ansichtszustand nachverfolgt, sodass sie in der Eigenschaft des ViewState Objekts gespeichert werden können. (Geerbt von WebControl)
Validate()	Führt eine Überprüfung des zugehörigen Eingabesteuerelements durch und aktualisiert die IsValid Eigenschaft. (Geerbt von BaseValidator)

Ereignisse

Name	Beschreibung
DataBinding	Tritt auf, wenn das Serversteuerelement eine Bindung an eine Datenquelle ausführt. (Geerbt von Control)
Disposed	Tritt auf, wenn ein Serversteuerelement aus dem Arbeitsspeicher freigegeben wird. Dies ist die letzte Phase des Lebenszyklus des Serversteuerelements, wenn eine ASP.NET Seite angefordert wird. (Geerbt von Control)
Init	Tritt auf, wenn das Serversteuerelement initialisiert wird, was der erste Schritt im Lebenszyklus ist. (Geerbt von Control)
Load	Tritt auf, wenn das Serversteuerelement in das Page Objekt geladen wird. (Geerbt von Control)
PreRender	Tritt ein, nachdem das Control Objekt geladen wurde, aber vor dem Rendern. (Geerbt von Control)
Unload	Tritt auf, wenn das Serversteuerelement aus dem Arbeitsspeicher entladen wird. (Geerbt von Control)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IAttributeAccessor.GetAttribute(String)	Ruft ein Attribut des Websteuerelements mit dem angegebenen Namen ab. (Geerbt von WebControl)
IAttributeAccessor.SetAttribute(String, String)	Legt ein Attribut des Websteuerelements auf den angegebenen Namen und Wert fest. (Geerbt von WebControl)
IControlBuilderAccessor.ControlBuilder	Eine Beschreibung dieses Mitglieds finden Sie unter ControlBuilder. (Geerbt von Control)
IControlDesignerAccessor.GetDesignModeState()	Eine Beschreibung dieses Mitglieds finden Sie unter GetDesignModeState(). (Geerbt von Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Eine Beschreibung dieses Mitglieds finden Sie unter SetDesignModeState(IDictionary). (Geerbt von Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Eine Beschreibung dieses Mitglieds finden Sie unter SetOwnerControl(Control). (Geerbt von Control)
IControlDesignerAccessor.UserData	Eine Beschreibung dieses Mitglieds finden Sie unter UserData. (Geerbt von Control)
IDataBindingsAccessor.DataBindings	Eine Beschreibung dieses Mitglieds finden Sie unter DataBindings. (Geerbt von Control)
IDataBindingsAccessor.HasDataBindings	Eine Beschreibung dieses Mitglieds finden Sie unter HasDataBindings. (Geerbt von Control)
IExpressionsAccessor.Expressions	Eine Beschreibung dieses Mitglieds finden Sie unter Expressions. (Geerbt von Control)
IExpressionsAccessor.HasExpressions	Eine Beschreibung dieses Mitglieds finden Sie unter HasExpressions. (Geerbt von Control)
IParserAccessor.AddParsedSubObject(Object)	Eine Beschreibung dieses Mitglieds finden Sie unter AddParsedSubObject(Object). (Geerbt von Control)

Erweiterungsmethoden

Name	Beschreibung
FindDataSourceControl(Control)	Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist.
FindFieldTemplate(Control, String)	Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück.
FindMetaTable(Control)	Gibt das metatable -Objekt für das enthaltende Datensteuerelement zurück.

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?

Freigeben über

CompareValidator Klasse

Definition

Beispiele

Hinweise

Zugänglichkeit

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Explizite Schnittstellenimplementierungen

Erweiterungsmethoden

Gilt für:

Weitere Informationen

Feedback