CustomValidator Klas

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Voert door de gebruiker gedefinieerde validatie uit op een invoerbesturingselement.

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

Overname: Object

Control

WebControl

Label

BaseValidator
CustomValidator

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een besturingselement aan de serverzijde CustomValidator maakt.

Important

Dit voorbeeld heeft een tekstvak dat gebruikersinvoer accepteert. Dit is een mogelijke beveiligingsrisico. Standaard valideren ASP.NET webpagina's dat gebruikersinvoer geen script- of HTML-elementen bevat. Zie Overzicht van Script Exploits voor meer informatie.


<%@ 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>

In het volgende codevoorbeeld ziet u hoe u een besturingselement aan de clientzijde CustomValidator maakt.

<%@ 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>

Opmerkingen

Gebruik het besturingselement om een door de CustomValidator gebruiker gedefinieerde validatiefunctie te bieden voor een invoerbesturingselement. Het CustomValidator besturingselement is een afzonderlijk besturingselement van het invoer besturingselement dat wordt gevalideerd, zodat u kunt bepalen waar het validatiebericht wordt weergegeven.

Validatiebesturingselementen voeren altijd validatie uit op de server. Ze hebben ook een volledige implementatie aan de clientzijde waarmee browsers met scriptfunctionaliteit (zoals Microsoft Internet Explorer 4.0 en hoger) validatie op de client kunnen uitvoeren. Validatie aan de clientzijde verbetert het validatieproces door gebruikersinvoer te controleren voordat deze naar de server wordt verzonden. Hierdoor kunnen fouten op de client worden gedetecteerd voordat het formulier wordt verzonden, waardoor de retour van informatie die nodig is voor validatie aan de serverzijde wordt vermeden.

Als u een validatiefunctie aan de serverzijde wilt maken, geeft u een handler op voor de ServerValidate gebeurtenis die de validatie uitvoert. De tekenreeks van het invoerbesturingselement dat moet worden gevalideerd, kan worden geopend met behulp van de Value eigenschap van het ServerValidateEventArgs object dat is doorgegeven aan de gebeurtenis-handler als parameter. Het resultaat van de validatie wordt vervolgens opgeslagen in de IsValid eigenschap van het ServerValidateEventArgs object.

Als u een validatiefunctie aan de clientzijde wilt maken, voegt u eerst de validatiefunctie aan de serverzijde toe die eerder is beschreven. Voeg vervolgens de validatiescriptfunctie aan de clientzijde toe aan de pagina ASP.NET (.aspx).

Als u Visual Basic Scripting Edition (VBScript) gebruikt, moet de functie in deze vorm staan:

Sub ValidationFunctionName(source, arguments)

Als u JScript gebruikt, moet de functie zich in deze vorm bevinden:

function ValidationFunctionName(source, arguments)

De source parameter is een verwijzing naar het <span-element> dat voor het CustomValidator besturingselement wordt weergegeven. Hiermee kunt u programmatisch de <spantag> beheren, zoals het wijzigen van het InnerHtml kenmerk. De arguments parameter is een object met twee eigenschappen: Waarde en IsValid. Met deze parameter kunt u de waarde van het besturingselement ophalen om te valideren en aan te geven of de waarde geldig is op basis van uw aangepaste validatieroutine.

Gebruik de ClientValidationFunction eigenschap om de naam op te geven van de validatiescriptfunctie aan de clientzijde die aan het CustomValidator besturingselement is gekoppeld. Omdat de scriptfunctie wordt uitgevoerd op de client, moet de functie een taal hebben die door de doelbrowser wordt ondersteund, zoals VBScript of JScript.

Note

Wanneer u het CustomValidator besturingselement in een UpdatePanel besturingselement gebruikt, moet u ervoor zorgen dat het validator-besturingselement en het besturingselement waaraan het is gekoppeld zich in hetzelfde deelvenster bevinden. Zie UpdatePanel voor meer informatie over het gebruik van het besturingselement voor gedeeltelijke pagina-updates.

Net als bij validatie aan de serverzijde wordt de tekenreeks van het invoerbesturingselement om te valideren geopend met behulp van de Value eigenschap van de arguments parameter. Retourneer het resultaat van de validatie door de IsValid eigenschap van de arguments parameter in te stellen.

Caution

Wanneer u validatorbesturingselementen gebruikt, moet u altijd de resultaten van validatie aan de serverzijde controleren voordat u een verwerking uitvoert. Na een postback, maar voordat uw gebeurtenismethoden worden aangeroepen, roept de pagina de validatorbesturingselementen aan en worden de resultaten samengevoegd in de Page.IsValid eigenschap. (U kunt de validatorbesturingselementen ook expliciet aanroepen met behulp van de Validate methode.) In uw eigen code moet u controleren of de Page.IsValid eigenschap wordt geretourneerd true voordat invoer wordt verwerkt. Hoewel browsers met scripts mogelijk voorkomen dat er een postback op de client optreedt als een validatiecontrole is mislukt, moet u servercode altijd inchecken Page.IsValid voordat gevalideerde gegevens worden verwerkt.

Meerdere validatiebesturingselementen kunnen worden gebruikt met een afzonderlijk invoerbesturingselement om verschillende criteria te valideren. U kunt bijvoorbeeld meerdere validatiebesturingselementen toepassen op een TextBox besturingselement waarmee de gebruiker het aantal items kan invoeren dat moet worden toegevoegd aan een winkelwagen. U kunt een CustomValidator besturingselement gebruiken om ervoor te zorgen dat de opgegeven waarde kleiner is dan het bedrag in de voorraad en een RequiredFieldValidator besturingselement om ervoor te zorgen dat de gebruiker een waarde in het TextBox besturingselement invoert.

Note

Als het invoerbeheer leeg is, worden er geen validatiefuncties aangeroepen en slaagt de validatie. Gebruik een RequiredFieldValidator besturingselement om te vereisen dat de gebruiker gegevens invoert in het invoerbeheer.

Het is mogelijk om een CustomValidator besturingselement te gebruiken zonder de ControlToValidate eigenschap in te stellen. Dit wordt meestal gedaan wanneer u meerdere invoerbesturingselementen valideert of invoerbesturingselementen valideert die niet kunnen worden gebruikt met validatiebesturingselementen, zoals het CheckBox besturingselement. In dit geval bevat de Value eigenschap van de arguments parameter die is doorgegeven aan de gebeurtenis-handler voor de ServerValidate gebeurtenis en aan de validatiefunctie aan de clientzijde altijd een lege tekenreeks (""). Deze validatiefuncties worden echter nog steeds aangeroepen, indien van toepassing, om de geldigheid op zowel de server als de client te bepalen. Als u toegang wilt krijgen tot de waarde die moet worden gevalideerd, moet u programmatisch verwijzen naar het invoerbesturingselement dat u wilt valideren en vervolgens de waarde ophalen uit de juiste eigenschap. Als u bijvoorbeeld een CheckBox besturingselement op de server wilt valideren, stelt u de ControlToValidate eigenschap van het validatiebesturingselement niet in en gebruikt u de volgende code voor de handler voor de ServerValidate gebeurtenis.

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);
 }

Zie voor meer informatie over validatiebesturingselementen BaseValidator.

Toegankelijkheid

Zie Accessibility in Visual Studio en ASP.NET and ASP.NET Controls and Accessibility voor informatie over het configureren van dit besturingselement, zodat er markeringen worden gegenereerd die voldoen aan de toegankelijkheidsstandaarden.

Constructors

Name	Description
CustomValidator()	Initialiseert een nieuw exemplaar van de CustomValidator klasse.

Eigenschappen

Name	Description
AccessKey	Hiermee haalt u de toegangssleutel op waarmee u snel naar het webserverbeheer kunt navigeren. (Overgenomen van WebControl)
Adapter	Hiermee haalt u de browserspecifieke adapter voor het besturingselement op. (Overgenomen van Control)
AppRelativeTemplateSourceDirectory	Hiermee haalt u de toepassingsgerelateerde virtuele map op van het Page of UserControl object dat dit besturingselement bevat. (Overgenomen van Control)
AssociatedControlID	Deze eigenschap wordt niet ondersteund. (Overgenomen van BaseValidator)
Attributes	Hiermee haalt u de verzameling willekeurige kenmerken (alleen voor rendering) op die niet overeenkomen met eigenschappen in het besturingselement. (Overgenomen van WebControl)
BackColor	Hiermee haalt u de achtergrondkleur van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl)
BindingContainer	Hiermee haalt u het besturingselement op dat de gegevensbinding van dit besturingselement bevat. (Overgenomen van Control)
BorderColor	Hiermee haalt u de randkleur van het web besturingselement op of stelt u deze in. (Overgenomen van WebControl)
BorderStyle	Hiermee haalt u de randstijl van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl)
BorderWidth	Hiermee haalt u de randbreedte van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl)
ChildControlsCreated	Hiermee wordt een waarde opgehaald die aangeeft of de onderliggende besturingselementen van het serverbesturingselement zijn gemaakt. (Overgenomen van Control)
ClientID	Hiermee haalt u de besturingselement-id op voor HTML-markeringen die worden gegenereerd door ASP.NET. (Overgenomen van Control)
ClientIDMode	Hiermee wordt het algoritme opgehaald of ingesteld dat wordt gebruikt om de waarde van de ClientID eigenschap te genereren. (Overgenomen van Control)
ClientIDSeparator	Hiermee haalt u een tekenwaarde op die het scheidingsteken vertegenwoordigt dat in de ClientID eigenschap wordt gebruikt. (Overgenomen van Control)
ClientValidationFunction	Hiermee haalt u de naam op van de aangepaste scriptfunctie aan de clientzijde die wordt gebruikt voor validatie.
Context	Hiermee wordt het HttpContext object opgehaald dat is gekoppeld aan het serverbeheer voor de huidige webaanvraag. (Overgenomen van Control)
Controls	Hiermee haalt u een ControlCollection object op dat de onderliggende besturingselementen vertegenwoordigt voor een opgegeven serverbesturingselement in de UI-hiërarchie. (Overgenomen van Control)
ControlStyle	Hiermee haalt u de stijl van het besturingselement webserver op. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
ControlStyleCreated	Hiermee wordt een waarde opgehaald die aangeeft of er een Style object is gemaakt voor de ControlStyle eigenschap. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
ControlToValidate	Hiermee haalt u het invoerbeheer op of stelt u dit in om te valideren. (Overgenomen van BaseValidator)
CssClass	Hiermee wordt de CSS-klasse (Cascading Style Sheet) opgehaald of ingesteld die wordt weergegeven door het webserverbeheer op de client. (Overgenomen van WebControl)
DataItemContainer	Hiermee wordt een verwijzing naar de naamgevingscontainer opgehaald als de naamgevingscontainer wordt IDataItemContainergeïmplementeerd. (Overgenomen van Control)
DataKeysContainer	Hiermee wordt een verwijzing naar de naamgevingscontainer opgehaald als de naamgevingscontainer wordt IDataKeysControlgeïmplementeerd. (Overgenomen van Control)
DesignMode	Hiermee wordt een waarde opgehaald die aangeeft of een besturingselement wordt gebruikt op een ontwerpoppervlak. (Overgenomen van Control)
Display	Hiermee wordt het weergavegedrag van het foutbericht in een validatiebeheer op of ingesteld. (Overgenomen van BaseValidator)
EnableClientScript	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of validatie aan de clientzijde is ingeschakeld. (Overgenomen van BaseValidator)
Enabled	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het validatiebeheer is ingeschakeld. (Overgenomen van BaseValidator)
EnableTheming	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of thema's van toepassing zijn op dit besturingselement. (Overgenomen van WebControl)
EnableViewState	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het serverbesturingselement de weergavestatus behoudt en de weergavestatus van onderliggende besturingselementen die het bevat, aan de aanvragende client. (Overgenomen van Control)
ErrorMessage	Hiermee haalt u de tekst op voor het foutbericht dat wordt weergegeven in een ValidationSummary besturingselement wanneer de validatie mislukt. (Overgenomen van BaseValidator)
Events	Hiermee haalt u een lijst met gedelegeerden van de gebeurtenis-handler op voor het besturingselement. Deze eigenschap is alleen-lezen. (Overgenomen van Control)
Font	Hiermee haalt u de lettertype-eigenschappen op die zijn gekoppeld aan het besturingselement webserver. (Overgenomen van WebControl)
ForeColor	Hiermee wordt de kleur van het bericht opgehaald of ingesteld dat wordt weergegeven wanneer de validatie mislukt. (Overgenomen van BaseValidator)
HasAttributes	Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement kenmerken heeft ingesteld. (Overgenomen van WebControl)
HasChildViewState	Hiermee wordt een waarde opgehaald die aangeeft of de onderliggende besturingselementen van het huidige serverbesturingselement instellingen voor de weergavestatus hebben. (Overgenomen van Control)
Height	Hiermee haalt u de hoogte van het webserverbeheer op of stelt u deze in. (Overgenomen van WebControl)
ID	Hiermee wordt de programmatische id opgehaald of ingesteld die aan het serverbeheer is toegewezen. (Overgenomen van Control)
IdSeparator	Hiermee haalt u het teken op dat wordt gebruikt om besturings-id's te scheiden. (Overgenomen van Control)
IsChildControlStateCleared	Hiermee wordt een waarde opgehaald die aangeeft of besturingselementen in dit besturingselement de controlestatus hebben. (Overgenomen van Control)
IsEnabled	Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement is ingeschakeld. (Overgenomen van WebControl)
IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of het serverbeheer wijzigingen opslaat in de weergavestatus. (Overgenomen van Control)
IsUnobtrusive	Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement onopvallende JavaScript genereert. (Overgenomen van BaseValidator)
IsValid	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het bijbehorende invoerbeheer de validatie doorstaat. (Overgenomen van BaseValidator)
IsViewStateEnabled	Hiermee wordt een waarde opgehaald die aangeeft of de weergavestatus is ingeschakeld voor dit besturingselement. (Overgenomen van Control)
LoadViewStateByID	Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement deelneemt aan het laden van de weergavestatus door ID in plaats van index. (Overgenomen van Control)
NamingContainer	Hiermee wordt een verwijzing opgehaald naar de naamgevingscontainer van het serverbesturingselement, waarmee een unieke naamruimte wordt gemaakt voor het onderscheiden tussen serverbesturingselementen met dezelfde ID eigenschapswaarde. (Overgenomen van Control)
Page	Hiermee haalt u een verwijzing op naar het Page exemplaar dat het serverbeheer bevat. (Overgenomen van Control)
Parent	Hiermee haalt u een verwijzing op naar het bovenliggende besturingselement van het serverbeheer in de paginabeheerhiërarchie. (Overgenomen van Control)
PropertiesValid	Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement dat is opgegeven door de ControlToValidate eigenschap een geldig besturingselement is. (Overgenomen van BaseValidator)
RenderingCompatibility	Hiermee wordt een waarde opgehaald waarmee de ASP.NET versie wordt opgegeven waarmee HTML wordt weergegeven, compatibel is met. (Overgenomen van Control)
RenderUplevel	Hiermee wordt een waarde opgehaald die aangeeft of de browser van de client ondersteuning biedt voor 'uplevel'-rendering. (Overgenomen van BaseValidator)
SetFocusOnError	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de focus is ingesteld op het besturingselement dat is opgegeven door de eigenschap wanneer de ControlToValidate validatie mislukt. (Overgenomen van BaseValidator)
Site	Hiermee wordt informatie opgehaald over de container die als host fungeert voor het huidige besturingselement wanneer deze op een ontwerpoppervlak wordt weergegeven. (Overgenomen van Control)
SkinID	Hiermee wordt de huid op de controle toegepast of ingesteld. (Overgenomen van WebControl)
Style	Hiermee haalt u een verzameling tekstkenmerken op die worden weergegeven als een stijlkenmerk op de buitenste tag van het besturingselement webserver. (Overgenomen van WebControl)
SupportsDisabledAttribute	Hiermee wordt een waarde opgehaald die aangeeft of het besturingselement het `disabled` kenmerk van het gerenderde HTML-element moet instellen op 'uitgeschakeld' wanneer de eigenschap van IsEnabled het besturingselement is `false`. (Overgenomen van Label)
TabIndex	Hiermee haalt u de tabindex van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl)
TagKey	Hiermee haalt u de HTML-tag op die wordt gebruikt om het Label besturingselement weer te geven. (Overgenomen van Label)
TagName	Hiermee haalt u de naam van het besturingselementlabel op. Deze eigenschap wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
TemplateControl	Hiermee haalt u een verwijzing op naar de sjabloon die dit besturingselement bevat of stelt u deze in. (Overgenomen van Control)
TemplateSourceDirectory	Hiermee haalt u de virtuele map op van de Page server of UserControl die het huidige serverbeheer bevat. (Overgenomen van Control)
Text	Hiermee wordt de tekst opgehaald of ingesteld die wordt weergegeven in het validatiebeheer wanneer de validatie mislukt. (Overgenomen van BaseValidator)
ToolTip	Hiermee wordt de tekst opgehaald of ingesteld die wordt weergegeven wanneer de muisaanwijzer boven het besturingselement webserver beweegt. (Overgenomen van WebControl)
UniqueID	Hiermee haalt u de unieke, hiërarchisch gekwalificeerde id voor het serverbesturingselement op. (Overgenomen van Control)
ValidateEmptyText	Hiermee wordt een Booleaanse waarde opgehaald of ingesteld die aangeeft of lege tekst moet worden gevalideerd.
ValidateRequestMode	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het besturingselement clientinvoer vanuit de browser controleert op mogelijk gevaarlijke waarden. (Overgenomen van Control)
ValidationGroup	Hiermee haalt u de naam op van de validatiegroep waartoe dit validatiebesturingselement behoort. (Overgenomen van BaseValidator)
ViewState	Hiermee haalt u een woordenlijst met statusgegevens op waarmee u de weergavestatus van een serverbeheer kunt opslaan en herstellen voor meerdere aanvragen voor dezelfde pagina. (Overgenomen van Control)
ViewStateIgnoresCase	Hiermee wordt een waarde opgehaald die aangeeft of het StateBag object niet hoofdlettergevoelig is. (Overgenomen van Control)
ViewStateMode	Hiermee haalt u de weergavestatusmodus van dit besturingselement op of stelt u deze in. (Overgenomen van Control)
Visible	Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of een serverbesturing wordt weergegeven als gebruikersinterface op de pagina. (Overgenomen van Control)
Width	Hiermee haalt u de breedte van het besturingselement webserver op of stelt u deze in. (Overgenomen van WebControl)

Methoden

Name	Description
AddAttributesToRender(HtmlTextWriter)	Hiermee worden de eigenschappen van het CustomValidator besturingselement toegevoegd aan de uitvoerstroom voor rendering op de client.
AddedControl(Control, Int32)	Aangeroepen nadat een onderliggend besturingselement is toegevoegd aan de Controls verzameling van het Control object. (Overgenomen van Control)
AddParsedSubObject(Object)	Hiermee wordt het besturingselement aangegeven dat een element is geparseerd en wordt het element aan het Label besturingselement toegevoegd. (Overgenomen van Label)
ApplyStyle(Style)	Kopieert eventuele niet-lege elementen van de opgegeven stijl naar het web besturingselement, en overschrijft eventuele bestaande stijlelementen van het besturingselement. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
ApplyStyleSheetSkin(Page)	De stijleigenschappen die in het paginamodel zijn gedefinieerd, worden toegepast op het besturingselement. (Overgenomen van Control)
BeginRenderTracing(TextWriter, Object)	Begint met het traceren van ontwerptijd van renderinggegevens. (Overgenomen van Control)
BuildProfileTree(String, Boolean)	Verzamelt informatie over het serverbesturingselement en levert deze aan de Trace eigenschap die moet worden weergegeven wanneer tracering is ingeschakeld voor de pagina. (Overgenomen van Control)
CheckControlValidationProperty(String, String)	Controleert of het opgegeven besturingselement zich op de pagina bevindt en validatie-eigenschappen bevat. (Overgenomen van BaseValidator)
ClearCachedClientID()	Hiermee stelt u de waarde in de cache in ClientID op `null`. (Overgenomen van Control)
ClearChildControlState()	Hiermee verwijdert u de informatie over de controlestatus voor de onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
ClearChildState()	Hiermee verwijdert u de informatie over de weergavestatus en controlestatus voor alle onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
ClearChildViewState()	Hiermee verwijdert u de informatie over de weergavestatus voor alle onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
ClearEffectiveClientIDMode()	Hiermee stelt u de ClientIDMode eigenschap van het huidige besturingselementexemplaren en van alle onderliggende besturingselementen in op Inherit. (Overgenomen van Control)
ControlPropertiesValid()	Controleert de eigenschappen van het besturingselement op geldige waarden.
CopyBaseAttributes(WebControl)	Kopieert de eigenschappen die niet zijn ingekapseld door het Style object van het opgegeven webserverbesturingselement naar het webserverbesturingselement waaruit deze methode wordt aangeroepen. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
CreateChildControls()	Wordt aangeroepen door het ASP.NET paginaframework om serverbesturingselementen op de hoogte te stellen die gebruikmaken van implementatie op basis van samenstelling om onderliggende besturingselementen te maken die ze bevatten ter voorbereiding op het terug plaatsen of weergeven. (Overgenomen van Control)
CreateControlCollection()	Hiermee maakt u een nieuw ControlCollection object voor het opslaan van de onderliggende besturingselementen (zowel letterlijk als server) van het serverbesturingselement. (Overgenomen van Control)
CreateControlStyle()	Hiermee maakt u het stijlobject dat intern door de WebControl klasse wordt gebruikt om alle stijlgerelateerde eigenschappen te implementeren. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
DataBind()	Hiermee wordt een gegevensbron gekoppeld aan het aangeroepen serverbesturingselement en alle onderliggende besturingselementen. (Overgenomen van Control)
DataBind(Boolean)	Hiermee koppelt u een gegevensbron aan het aangeroepen serverbesturingselement en alle onderliggende besturingselementen met een optie om de DataBinding gebeurtenis te genereren. (Overgenomen van Control)
DataBindChildren()	Hiermee wordt een gegevensbron gekoppeld aan de onderliggende besturingselementen van het serverbesturingselement. (Overgenomen van Control)
DetermineRenderUplevel()	Bepaalt of het validatiebesturingselement clientvalidatie kan uitvoeren. (Overgenomen van BaseValidator)
Dispose()	Hiermee kan een serverbesturing definitief worden opgeschoond voordat deze uit het geheugen wordt vrijgegeven. (Overgenomen van Control)
EndRenderTracing(TextWriter, Object)	Hiermee wordt de ontwerptijd van het traceren van renderinggegevens beëindigd. (Overgenomen van Control)
EnsureChildControls()	Bepaalt of het serverbesturingselement onderliggende besturingselementen bevat. Als dat niet het geval is, worden onderliggende besturingselementen gemaakt. (Overgenomen van Control)
EnsureID()	Hiermee maakt u een id voor besturingselementen waaraan geen id is toegewezen. (Overgenomen van Control)
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
EvaluateIsValid()	Overschrijft de EvaluateIsValid() methode.
FindControl(String, Int32)	Hiermee zoekt u in de huidige naamgevingscontainer naar een serverbeheer met het opgegeven en een geheel getal dat is opgegeven `id` in de `pathOffset` parameter, die de zoekopdracht helpt. U moet deze versie van de FindControl methode niet overschrijven. (Overgenomen van Control)
FindControl(String)	Zoekt in de huidige naamgevingscontainer naar een serverbeheer met de opgegeven `id` parameter. (Overgenomen van Control)
Focus()	Hiermee stelt u de invoerfocus in op een besturingselement. (Overgenomen van Control)
GetControlRenderID(String)	Hiermee haalt u de client-id van het opgegeven besturingselement op. (Overgenomen van BaseValidator)
GetControlValidationValue(String)	Hiermee haalt u de waarde op die is gekoppeld aan het opgegeven invoerbeheer. (Overgenomen van BaseValidator)
GetDesignModeState()	Hiermee haalt u ontwerptijdgegevens op voor een besturingselement. (Overgenomen van Control)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetRouteUrl(Object)	Haalt de URL op die overeenkomt met een set routeparameters. (Overgenomen van Control)
GetRouteUrl(RouteValueDictionary)	Haalt de URL op die overeenkomt met een set routeparameters. (Overgenomen van Control)
GetRouteUrl(String, Object)	Haalt de URL op die overeenkomt met een set routeparameters en een routenaam. (Overgenomen van Control)
GetRouteUrl(String, RouteValueDictionary)	Haalt de URL op die overeenkomt met een set routeparameters en een routenaam. (Overgenomen van Control)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
GetUniqueIDRelativeTo(Control)	Retourneert het voorvoegselgedeelte van de UniqueID eigenschap van het opgegeven besturingselement. (Overgenomen van Control)
HasControls()	Bepaalt of het serverbesturingselement onderliggende besturingselementen bevat. (Overgenomen van Control)
HasEvents()	Retourneert een waarde die aangeeft of gebeurtenissen zijn geregistreerd voor het besturingselement of onderliggende besturingselementen. (Overgenomen van Control)
IsLiteralContent()	Bepaalt of het serverbeheer alleen letterlijke inhoud bevat. (Overgenomen van Control)
LoadControlState(Object)	Herstelt controlestatusgegevens van een vorige paginaaanvraag die door de SaveControlState() methode is opgeslagen. (Overgenomen van Control)
LoadViewState(Object)	Laadt de eerder opgeslagen status voor het besturingselement. (Overgenomen van Label)
MapPathSecure(String)	Hiermee haalt u het fysieke pad op waarnaar een virtueel pad, ofwel absoluut of relatief, wordt toegewezen. (Overgenomen van Control)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
MergeStyle(Style)	Kopieert niet-lege elementen van de opgegeven stijl naar het webbesturing, maar overschrijft geen bestaande stijlelementen van het besturingselement. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
OnBubbleEvent(Object, EventArgs)	Bepaalt of de gebeurtenis voor het serverbeheer wordt doorgegeven aan de hiërarchie van de ui-server van de pagina. (Overgenomen van Control)
OnDataBinding(EventArgs)	Hiermee wordt de DataBinding gebeurtenis gegenereerd. (Overgenomen van Control)
OnInit(EventArgs)	Hiermee wordt de Init gebeurtenis gegenereerd. (Overgenomen van BaseValidator)
OnLoad(EventArgs)	Hiermee wordt de Load gebeurtenis gegenereerd. (Overgenomen van Control)
OnPreRender(EventArgs)	Hiermee wordt de PreRender gebeurtenis gegenereerd. (Overgenomen van BaseValidator)
OnServerValidate(String)	Hiermee wordt de ServerValidate gebeurtenis voor het CustomValidator besturingselement gegenereerd.
OnUnload(EventArgs)	Hiermee wordt de Unload gebeurtenis gegenereerd. (Overgenomen van BaseValidator)
OpenFile(String)	Hiermee wordt een Stream bestand gelezen. (Overgenomen van Control)
RaiseBubbleEvent(Object, EventArgs)	Wijst alle bronnen van de gebeurtenis en de bijbehorende informatie toe aan het bovenliggende besturingselement. (Overgenomen van Control)
RegisterValidatorCommonScript()	Registreert code op de pagina voor validatie aan de clientzijde. (Overgenomen van BaseValidator)
RegisterValidatorDeclaration()	Registreert een ECMAScript-matrixdeclaratie met behulp van de matrixnaam `Page_Validators`. (Overgenomen van BaseValidator)
RemovedControl(Control)	Aangeroepen nadat een onderliggend besturingselement is verwijderd uit de Controls verzameling van het Control object. (Overgenomen van Control)
Render(HtmlTextWriter)	Geeft het besturingselement op de client weer. (Overgenomen van BaseValidator)
RenderBeginTag(HtmlTextWriter)	Geeft de HTML-openingstag van het besturingselement weer voor de opgegeven schrijver. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
RenderChildren(HtmlTextWriter)	Hiermee wordt de inhoud van de onderliggende elementen van een serverbeheer uitgevoerd naar een opgegeven HtmlTextWriter object, waarmee de inhoud wordt weggeschreven die op de client moet worden weergegeven. (Overgenomen van Control)
RenderContents(HtmlTextWriter)	Geeft de inhoud van de Label tekst weer in de opgegeven schrijver. (Overgenomen van Label)
RenderControl(HtmlTextWriter, ControlAdapter)	De server beheert inhoud naar een opgegeven HtmlTextWriter object met behulp van een opgegeven ControlAdapter object. (Overgenomen van Control)
RenderControl(HtmlTextWriter)	Hiermee wordt inhoud van de server naar een opgegeven HtmlTextWriter object uitgevoerd en wordt traceringsinformatie over het besturingselement opgeslagen als tracering is ingeschakeld. (Overgenomen van Control)
RenderEndTag(HtmlTextWriter)	Geeft de HTML-slottag van het besturingselement weer in de opgegeven schrijver. Deze methode wordt voornamelijk gebruikt door controleontwikkelaars. (Overgenomen van WebControl)
ResolveAdapter()	Hiermee haalt u de besturingsadapter op die verantwoordelijk is voor het weergeven van het opgegeven besturingselement. (Overgenomen van Control)
ResolveClientUrl(String)	Hiermee haalt u een URL op die door de browser kan worden gebruikt. (Overgenomen van Control)
ResolveUrl(String)	Converteert een URL naar een URL die bruikbaar is voor de aanvragende client. (Overgenomen van Control)
SaveControlState()	Hiermee worden wijzigingen in de status van de servercontrole opgeslagen die zijn opgetreden sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van Control)
SaveViewState()	Hiermee wordt een status opgeslagen die is gewijzigd nadat de TrackViewState() methode is aangeroepen. (Overgenomen van WebControl)
SetDesignModeState(IDictionary)	Hiermee stelt u ontwerptijdgegevens in voor een besturingselement. (Overgenomen van Control)
SetRenderMethodDelegate(RenderMethod)	Hiermee wijst u een gemachtigde van een gebeurtenishandler toe om het serverbeheer en de inhoud ervan weer te geven in het bovenliggende besturingselement. (Overgenomen van Control)
SetTraceData(Object, Object, Object)	Hiermee stelt u traceringsgegevens in voor het traceren van renderinggegevens in ontwerptijd, met behulp van het traceringsobject, de traceringsgegevenssleutel en de traceringsgegevenswaarde. (Overgenomen van Control)
SetTraceData(Object, Object)	Hiermee stelt u traceringsgegevens in voor ontwerptijdtracering van renderinggegevens, met behulp van de traceringsgegevenssleutel en de traceringsgegevenswaarde. (Overgenomen van Control)
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)
TrackViewState()	Hiermee zorgt u ervoor dat het besturingselement wijzigingen in de weergavestatus bijhoudt, zodat deze kunnen worden opgeslagen in de eigenschap van ViewState het object. (Overgenomen van WebControl)
Validate()	Voert validatie uit op het bijbehorende invoerbesturingselement en werkt de IsValid eigenschap bij. (Overgenomen van BaseValidator)

gebeurtenis

Name	Description
DataBinding	Treedt op wanneer het serverbeheer wordt verbonden met een gegevensbron. (Overgenomen van Control)
Disposed	Treedt op wanneer een serverbesturing wordt vrijgegeven uit het geheugen. Dit is de laatste fase van de levenscyclus van serverbeheer wanneer een ASP.NET pagina wordt aangevraagd. (Overgenomen van Control)
Init	Treedt op wanneer het serverbeheer wordt geïnitialiseerd. Dit is de eerste stap in de levenscyclus. (Overgenomen van Control)
Load	Treedt op wanneer het serverbeheer in het Page object wordt geladen. (Overgenomen van Control)
PreRender	Vindt plaats nadat het object is geladen, maar voordat het Control wordt weergegeven. (Overgenomen van Control)
ServerValidate	Treedt op wanneer de validatie wordt uitgevoerd op de server.
Unload	Treedt op wanneer het serverbeheer uit het geheugen wordt verwijderd. (Overgenomen van Control)

Expliciete interface-implementaties

Name	Description
IAttributeAccessor.GetAttribute(String)	Hiermee haalt u een kenmerk van het webbeheer op met de opgegeven naam. (Overgenomen van WebControl)
IAttributeAccessor.SetAttribute(String, String)	Hiermee stelt u een kenmerk van het webbeheer in op de opgegeven naam en waarde. (Overgenomen van WebControl)
IControlBuilderAccessor.ControlBuilder	Zie voor een beschrijving van dit lid ControlBuilder. (Overgenomen van Control)
IControlDesignerAccessor.GetDesignModeState()	Zie voor een beschrijving van dit lid GetDesignModeState(). (Overgenomen van Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Zie voor een beschrijving van dit lid SetDesignModeState(IDictionary). (Overgenomen van Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Zie voor een beschrijving van dit lid SetOwnerControl(Control). (Overgenomen van Control)
IControlDesignerAccessor.UserData	Zie voor een beschrijving van dit lid UserData. (Overgenomen van Control)
IDataBindingsAccessor.DataBindings	Zie voor een beschrijving van dit lid DataBindings. (Overgenomen van Control)
IDataBindingsAccessor.HasDataBindings	Zie voor een beschrijving van dit lid HasDataBindings. (Overgenomen van Control)
IExpressionsAccessor.Expressions	Zie voor een beschrijving van dit lid Expressions. (Overgenomen van Control)
IExpressionsAccessor.HasExpressions	Zie voor een beschrijving van dit lid HasExpressions. (Overgenomen van Control)
IParserAccessor.AddParsedSubObject(Object)	Zie voor een beschrijving van dit lid AddParsedSubObject(Object). (Overgenomen van Control)

Extensiemethoden

Name	Description
FindDataSourceControl(Control)	Retourneert de gegevensbron die is gekoppeld aan het gegevensbeheer voor het opgegeven besturingselement.
FindFieldTemplate(Control, String)	Retourneert de veldsjabloon voor de opgegeven kolom in de naamgevingscontainer van het opgegeven besturingselement.
FindMetaTable(Control)	Retourneert het metatable-object voor het bevattende gegevensbeheer.

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?