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

Führt eine benutzerdefinierte Überprüfung für ein Eingabesteuerelement aus.

public ref class CustomValidator : System::Web::UI::WebControls::BaseValidator

public class CustomValidator : System.Web.UI.WebControls.BaseValidator

type CustomValidator = class
    inherit BaseValidator

Public Class CustomValidator
Inherits BaseValidator

Vererbung: Object

Control

WebControl

Label

BaseValidator
CustomValidator

Beispiele

Im folgenden Codebeispiel wird das Erstellen eines serverseitigen CustomValidator Steuerelements veranschaulicht.

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>CustomValidator ServerValidate Example</title>
<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 id="form1" runat="server">
  
      <h3>CustomValidator ServerValidate Example</h3>

      <asp:Label id="Message"  
           Text="Enter an even number:" 
           Font-Names="Verdana" 
           Font-Size="10pt" 
           runat="server"
           AssociatedControlID="Text1"/>

      <br />

      <asp:TextBox id="Text1" 
           runat="server" />
    
        

      <asp:CustomValidator id="CustomValidator1"
           ControlToValidate="Text1"
           Display="Static"
           ErrorMessage="Not an even number!"
           ForeColor="green"
           Font-Names="verdana" 
           Font-Size="10pt"
           OnServerValidate="ServerValidation"
           runat="server"/>

      <br />
 
      <asp:Button id="Button1"
           Text="Validate" 
           OnClick="ValidateBtn_OnClick" 
           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>CustomValidator ServerValidate Example</title>
<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 id="form1" runat="server">
  
      <h3>CustomValidator ServerValidate Example</h3>

      <asp:Label id="Message"
           Text="Enter an even number:" 
           Font-Names="Verdana" 
           Font-Size="10pt" 
           runat="server"
           AssociatedControlID="Text1" />

      <br />

      <asp:TextBox id="Text1" 
           runat="server" />
    
        

      <asp:CustomValidator id="CustomValidator1"
           ControlToValidate="Text1"
           Display="Static"
           ErrorMessage="Not an even number!"
           ForeColor="green"
           Font-Names="verdana" 
           Font-Size="10pt"
           OnServerValidate="ServerValidation"
           runat="server"/>

      <br />
 
      <asp:Button id="Button1"
           Text="Validate" 
           OnClick="ValidateBtn_OnClick" 
           runat="server"/>

   </form>
  
</body>
</html>

Im folgenden Codebeispiel wird das Erstellen eines clientseitigen CustomValidator Steuerelements veranschaulicht.

<%@ 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 id="Form1" 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="javascript"> 
   function ClientValidate(source, arguments)
   {
        if (arguments.Value % 2 == 0 ){
            arguments.IsValid = true;
        } else {
            arguments.IsValid = false;
        }
   }
</script>

<%@ 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 id="Form1" 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="javascript">
   function ClientValidate(source, arguments)
   {
        if (arguments.Value % 2 == 0 ){
            arguments.IsValid = true;
        } else {
            arguments.IsValid = false;
        }
   }
</script>

Hinweise

Verwenden Sie das CustomValidator Steuerelement, um eine benutzerdefinierte Überprüfungsfunktion für ein Eingabesteuerelement bereitzustellen. Das CustomValidator Steuerelement ist ein separates Steuerelement vom zu überprüfenden Eingabesteuerelement, mit dem Sie steuern können, wo die Überprüfungsmeldung angezeigt wird.

Überprüfungssteuerelemente führen immer eine Überprüfung auf dem Server durch. Sie verfügen außerdem über eine vollständige clientseitige Implementierung, mit der skriptfähige Browser (z. B. Microsoft Internet Explorer 4.0 und höher) eine Überprüfung auf dem Client durchführen können. Die clientseitige Überprüfung verbessert den Überprüfungsprozess, indem die Benutzereingabe überprüft wird, bevor sie an den Server gesendet wird. Auf diese Weise können Fehler auf dem Client erkannt werden, bevor das Formular übermittelt wird, wodurch der Roundtrip von Informationen vermieden wird, die für die serverseitige Validierung erforderlich sind.

Um eine serverseitige Überprüfungsfunktion zu erstellen, stellen Sie einen Handler für das ServerValidate Ereignis bereit, das die Überprüfung durchführt. Auf die Zeichenfolge des zu überprüfenden Eingabesteuerelements kann mithilfe der Value Eigenschaft des ServerValidateEventArgs Objekts zugegriffen werden, das als Parameter an den Ereignishandler übergeben wird. Das Ergebnis der Überprüfung wird dann in der IsValid Eigenschaft des ServerValidateEventArgs Objekts gespeichert.

Um eine clientseitige Überprüfungsfunktion zu erstellen, fügen Sie zuerst die zuvor beschriebene serverseitige Überprüfungsfunktion hinzu. Fügen Sie als Nächstes die clientseitige Überprüfungsskriptfunktion zur seite ASP.NET (.aspx) hinzu.

Wenn Sie Visual Basic Scripting Edition (VBScript) verwenden, muss sich die Funktion in diesem Format befinden:

Sub ValidationFunctionName(source, arguments)

Wenn Sie JScript verwenden, muss sich die Funktion in dieser Form befinden:

function ValidationFunctionName(source, arguments)

Der source Parameter ist ein Verweis auf das span-Element>, das <für das CustomValidator Steuerelement gerendert wird. Auf diese Weise können Sie das <Spantag> programmgesteuert steuern, z. B. das Ändern des InnerHtml Attributs. Der arguments Parameter ist ein Objekt mit zwei Eigenschaften: Value und IsValid. Mit diesem Parameter können Sie den Wert des Steuerelements abrufen, um zu überprüfen und anzugeben, ob der Wert basierend auf Ihrer benutzerdefinierten Überprüfungsroutine gültig ist.

Verwenden Sie die ClientValidationFunction Eigenschaft, um den Namen der clientseitigen Überprüfungsskriptfunktion anzugeben, die dem CustomValidator Steuerelement zugeordnet ist. Da die Skriptfunktion auf dem Client ausgeführt wird, muss die Funktion in einer Sprache sein, die der Zielbrowser unterstützt, z. B. VBScript oder JScript.

Hinweis

Wenn Sie das CustomValidator 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.

Wie bei der serverseitigen Überprüfung wird mithilfe Value der Eigenschaft des arguments Parameters auf die Zeichenfolge des zu überprüfenden Eingabesteuerelements zugegriffen. Geben Sie das Ergebnis der Überprüfung zurück, indem Sie die IsValid Eigenschaft des arguments Parameters festlegen.

Vorsicht

Bei verwendung von Validator-Steuerelementen sollten Sie immer die Ergebnisse der serverseitigen Überprüfung überprüfen, bevor Sie eine Verarbeitung durchführen. Nach einem Postback, aber bevor Die Ereignismethoden aufgerufen werden, ruft die Seite die Validator-Steuerelemente auf und aggregiert ihre Ergebnisse in der Page.IsValid Eigenschaft. (Sie können die Validator-Steuerelemente auch explizit mithilfe der Validate Methode aufrufen.) In Ihrem eigenen Code sollten Sie überprüfen, ob die Eigenschaft vor der Verarbeitung der Page.IsValid Eingabe zurückgegeben wird true . Obwohl skriptfähige Browser möglicherweise verhindern, dass ein Postback auf dem Client auftritt, wenn eine Überprüfung fehlgeschlagen ist, sollten Sie vor der Verarbeitung überprüfter Daten immer auch den Servercode einchecken Page.IsValid .

Mehrere Überprüfungssteuerelemente können mit einem einzelnen Eingabesteuerelement verwendet werden, um verschiedene Kriterien zu überprüfen. Sie können z. B. mehrere Überprüfungssteuerelemente auf ein TextBox Steuerelement anwenden, mit dem der Benutzer die Menge der Elemente eingeben kann, die einem Einkaufswagen hinzugefügt werden sollen. Sie können ein CustomValidator Steuerelement verwenden, um sicherzustellen, dass der angegebene Wert kleiner als der Inventurwert und ein RequiredFieldValidator Steuerelement ist, um sicherzustellen, dass der Benutzer einen Wert in das TextBox Steuerelement eingibt.

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.

Es ist möglich, ein CustomValidator Steuerelement zu verwenden, ohne die ControlToValidate Eigenschaft festzulegen. Dies geschieht in der Regel, wenn Sie mehrere Eingabesteuerelemente überprüfen oder Eingabesteuerelemente überprüfen, die nicht mit Überprüfungssteuerelementen wie dem CheckBox Steuerelement verwendet werden können. In diesem Fall enthält die Value Eigenschaft des arguments Parameters, der an den Ereignishandler für das ServerValidate Ereignis übergeben wird, und an die clientseitige Überprüfungsfunktion immer eine leere Zeichenfolge (""). Diese Überprüfungsfunktionen werden jedoch gegebenenfalls weiterhin aufgerufen, um die Gültigkeit sowohl auf dem Server als auch auf dem Client zu ermitteln. Um auf den zu überprüfenden Wert zuzugreifen, müssen Sie programmgesteuert auf das Eingabesteuerelement verweisen, das Sie überprüfen möchten, und dann den Wert aus der entsprechenden Eigenschaft abrufen. Wenn Sie beispielsweise ein CheckBox Steuerelement auf dem Server überprüfen möchten, legen Sie die ControlToValidate Eigenschaft des Überprüfungssteuerelements nicht fest, und verwenden Sie den folgenden Code für den Handler für das ServerValidate Ereignis.

Sub ServerValidation (source As object, args As ServerValidateEventArgs)
    args.IsValid = (CheckBox1.Checked = True)
 End Sub

void ServerValidation (object source, ServerValidateEventArgs args)
 {
    args.IsValid = (CheckBox1.Checked == true);
 }

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
CustomValidator()	Initialisiert eine neue Instanz der CustomValidator-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)
ClientValidationFunction	Dient zum Abrufen oder Festlegen des Namens der benutzerdefinierten clientseitigen Skriptfunktion, die für die Überprüfung verwendet wird.
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)
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)
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)
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)
UniqueID	Ruft den eindeutigen hierarchisch qualifizierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control)
ValidateEmptyText	Dient zum Abrufen oder Festlegen eines booleschen Werts, der angibt, ob leerer Text überprüft werden soll.
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)
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 die Eigenschaften des CustomValidator Steuerelements zum Rendern auf dem Client zum Ausgabedatenstrom 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 clientseitige Überprüfungen ausführen kann. (Geerbt von BaseValidator)
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()	Überschreibt die EvaluateIsValid() Methode.
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)
OnServerValidate(String)	Löst das ServerValidate Ereignis für das CustomValidator Steuerelement aus.
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)
ServerValidate	Tritt auf, wenn die Überprüfung auf dem Server ausgeführt wird.
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?