CustomValidator Osztály

Definíció

Névtér:: System.Web.UI.WebControls

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Felhasználó által megadott ellenőrzést hajt végre egy bemeneti vezérlőn.

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

Öröklődés: Object

Control

WebControl

Label

BaseValidator
CustomValidator

Példák

Az alábbi példakód bemutatja, hogyan hozhat létre kiszolgálóoldali CustomValidator vezérlőt.

Important

Ebben a példában egy szövegdoboz található, amely elfogadja a felhasználói bemenetet, ami potenciális biztonsági fenyegetés. Alapértelmezés szerint ASP.NET weblapok ellenőrzik, hogy a felhasználói bevitel nem tartalmaz-e szkript- vagy HTML-elemeket. További információ: Szkript kihasználása – áttekintés.


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

Az alábbi példakód bemutatja, hogyan hozható létre ügyféloldali CustomValidator vezérlő.

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

Megjegyzések

A vezérlővel CustomValidator felhasználó által definiált érvényesítési függvényt adhat meg egy bemeneti vezérlőhöz. A CustomValidator vezérlő egy külön vezérlő az általa ellenőrzött beviteli vezérlőtől, amely lehetővé teszi annak szabályozását, hogy hol jelenjen meg az érvényesítési üzenet.

Az érvényesítési vezérlők mindig elvégzik az ellenőrzést a kiszolgálón. Teljes ügyféloldali implementációval is rendelkeznek, amely lehetővé teszi a parancsfájl-kompatibilis böngészők (például Microsoft Internet Explorer 4.0-s és újabb verziók) számára az ellenőrzés végrehajtását az ügyfélen. Az ügyféloldali érvényesítés javítja az érvényesítési folyamatot azáltal, hogy ellenőrzi a felhasználói bemenetet, mielőtt elküldené azt a kiszolgálónak. Ez lehetővé teszi a hibák észlelését az ügyfélen az űrlap elküldése előtt, így elkerülve a kiszolgálóoldali ellenőrzéshez szükséges információk körútját.

Kiszolgálóoldali érvényesítési függvény létrehozásához adjon meg egy kezelőt az ServerValidate érvényesítést végrehajtó eseményhez. Az ellenőrzéshez használt beviteli vezérlő sztringje az eseménykezelőbe paraméterként átadott objektum tulajdonságával Value érhető elServerValidateEventArgs. Az ellenőrzés eredménye ezután az IsValid objektum tulajdonságában ServerValidateEventArgs lesz tárolva.

Ügyféloldali érvényesítési függvény létrehozásához először adja hozzá a korábban ismertetett kiszolgálóoldali érvényesítési függvényt. Ezután adja hozzá az ügyféloldali érvényesítési szkriptfüggvényt a ASP.NET (.aspx) laphoz.

Visual Basic Scripting Edition (VBScript) használata esetén a függvénynek ebben az formában kell lennie:

Sub ValidationFunctionName(source, arguments)

JScript használata esetén a függvénynek ebben az formában kell lennie:

function ValidationFunctionName(source, arguments)

A source paraméter a vezérlőelemhez renderelt span< elemre > mutató hivatkozásCustomValidator. Így programozott módon szabályozhatja a <span> címkét, például módosíthatja az InnerHtml attribútumot. A arguments paraméter egy objektum, amelynek két tulajdonsága van: Érték és IsValid. Ez a paraméter lehetővé teszi a vezérlő értékének érvényesítését, valamint annak jelzését, hogy az érték érvényes-e az egyéni ellenőrzési rutin alapján.

ClientValidationFunction A tulajdonság használatával adja meg a vezérlőelemhez CustomValidator társított ügyféloldali érvényesítési szkriptfüggvény nevét. Mivel a szkriptfüggvény végrehajtása az ügyfélen történik, a függvénynek olyan nyelven kell lennie, amelyet a célböngésző támogat, például VBScript vagy JScript.

Note

Ha egy vezérlőn belül használja a CustomValidator vezérlőt UpdatePanel , győződjön meg arról, hogy az érvényesítő vezérlőelem és a hozzá társított vezérlő ugyanabban a panelen van. A vezérlő részleges oldalfrissítésekhez való használatáról UpdatePanel további információt aPartial-Page Rendering Overview című témakörben talál.

A kiszolgálóoldali ellenőrzéshez hasonlóan az ellenőrzéshez használt beviteli vezérlő sztringje is a Value paraméter tulajdonságával arguments érhető el. Az ellenőrzés eredményét a paraméter tulajdonságának IsValid beállításával arguments adja vissza.

Figyelmeztetés

Az érvényesítő vezérlők használatakor a feldolgozás előtt mindig ellenőrizze a kiszolgálóoldali ellenőrzés eredményeit. A visszavétel után, de az esemény metódusainak meghívása előtt az oldal meghívja az érvényesítő vezérlőket, és összesíti az eredményeket a Page.IsValid tulajdonságban. (Az érvényesítő vezérlőket explicit módon is meghívhatja a Validate metódus használatával.) A saját kódjában ellenőrizze, hogy a tulajdonság visszatér-e Page.IsValid a true bemenet feldolgozása előtt. Annak ellenére, hogy a parancsfájlokkal kompatibilis böngészők megakadályozhatják, hogy az ellenőrzés sikertelen ellenőrzése esetén utóvisszaküldés történjen az ügyfélen, az érvényesített adatok feldolgozása előtt mindig ellenőrizze Page.IsValid a kiszolgáló kódját is.

A különböző feltételek érvényesítéséhez több érvényesítési vezérlő is használható egyéni beviteli vezérlővel. Például több érvényesítési vezérlőt is alkalmazhat egy TextBox vezérlőre, amely lehetővé teszi a felhasználó számára, hogy megadja a bevásárlókocsihoz hozzáadni kívánt elemek mennyiségét. Egy vezérlővel CustomValidator gondoskodhat arról, hogy a megadott érték kisebb legyen a készletben lévő mennyiségnél, és RequiredFieldValidator egy vezérlővel győződjön meg arról, hogy a felhasználó beír egy értéket a TextBox vezérlőbe.

Note

Ha a bemeneti vezérlő üres, a rendszer nem hív meg érvényesítési függvényeket, és az ellenőrzés sikeres lesz. RequiredFieldValidator Egy vezérlő használatával megkövetelheti, hogy a felhasználó adatokat adjon meg a beviteli vezérlőben.

A vezérlők a tulajdonság beállítása CustomValidator nélkül is használhatókControlToValidate. Ez általában akkor fordul elő, ha több bemeneti vezérlőt érvényesít, vagy olyan bemeneti vezérlőket érvényesít, amelyek nem használhatók érvényesítési vezérlőkkel, például a CheckBox vezérlővel. Ebben az esetben az Valuearguments esemény eseménykezelőjének és az ügyféloldali érvényesítési függvénynek ServerValidate átadott paraméter tulajdonsága mindig tartalmaz egy üres sztringet (""). Ezeket az érvényesítési függvényeket azonban szükség esetén továbbra is meghívja a kiszolgáló és az ügyfél érvényességének meghatározásához. Az érvényesítendő érték eléréséhez programozott módon hivatkoznia kell az érvényesíteni kívánt beviteli vezérlőre, majd le kell kérnie az értéket a megfelelő tulajdonságból. Ha például ellenőrizni szeretne egy vezérlőt CheckBox a kiszolgálón, ne állítsa be az ControlToValidate érvényesítési vezérlő tulajdonságát, és használja az esemény kezelőjének ServerValidate következő kódját.

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

Az érvényesítési vezérlőkkel kapcsolatos további információkért lásd: BaseValidator.

Accessibility

A vezérlő akadálymentességi szabványoknak megfelelő korrektúra létrehozására való konfigurálásáról további információt a Megfelelőség Visual Studio és ASP.NET és ASP.NET Vezérlők és kisegítő lehetőségek című témakörben talál.

Konstruktorok

Name	Description
CustomValidator()	Inicializálja a CustomValidator osztály új példányát.

Tulajdonságok

Name	Description
AccessKey	Lekéri vagy beállítja a hozzáférési kulcsot, amely lehetővé teszi a webkiszolgáló-vezérlő gyors navigálását. (Öröklődés forrása WebControl)
Adapter	Lekéri a vezérlő böngészőspecifikus adapterét. (Öröklődés forrása Control)
AppRelativeTemplateSourceDirectory	Lekéri vagy beállítja a vezérlőt tartalmazó objektum Page alkalmazás-relatív virtuális könyvtárátUserControl. (Öröklődés forrása Control)
AssociatedControlID	Ez a tulajdonság nem támogatott. (Öröklődés forrása BaseValidator)
Attributes	Lekéri a vezérlőelem tulajdonságainak nem megfelelő tetszőleges attribútumok gyűjteményét (csak rendereléshez). (Öröklődés forrása WebControl)
BackColor	Lekéri vagy beállítja a webkiszolgáló-vezérlő háttérszínét. (Öröklődés forrása WebControl)
BindingContainer	Lekéri a vezérlő adatkötését tartalmazó vezérlőt. (Öröklődés forrása Control)
BorderColor	Lekéri vagy beállítja a webes vezérlő szegélyszínét. (Öröklődés forrása WebControl)
BorderStyle	Lekéri vagy beállítja a webkiszolgáló-vezérlő szegélystílusát. (Öröklődés forrása WebControl)
BorderWidth	Lekéri vagy beállítja a webkiszolgáló-vezérlő szegélyszélességét. (Öröklődés forrása WebControl)
ChildControlsCreated	Beolvas egy értéket, amely jelzi, hogy a kiszolgálóvezérlő gyermekvezérlői létrejöttek-e. (Öröklődés forrása Control)
ClientID	Lekéri a ASP.NET által létrehozott HTML-korrektúra vezérlőazonosítóját. (Öröklődés forrása Control)
ClientIDMode	Lekéri vagy beállítja a tulajdonság értékének létrehozásához használt algoritmust ClientID . (Öröklődés forrása Control)
ClientIDSeparator	Beolvas egy karakterértéket, amely a tulajdonságban használt elválasztó karaktert ClientID jelöli. (Öröklődés forrása Control)
ClientValidationFunction	Lekéri vagy beállítja az ellenőrzéshez használt egyéni ügyféloldali szkriptfüggvény nevét.
Context	Lekéri az HttpContext aktuális webkérelem kiszolgálóvezérlőjével társított objektumot. (Öröklődés forrása Control)
Controls	ControlCollection Lekéri az objektumot, amely egy adott kiszolgálóvezérlő gyermekvezérlőit jelöli a felhasználói felületi hierarchiában. (Öröklődés forrása Control)
ControlStyle	Lekéri a webkiszolgáló-vezérlő stílusát. Ezt a tulajdonságot elsősorban a vezérlő fejlesztők használják. (Öröklődés forrása WebControl)
ControlStyleCreated	Beolvas egy értéket, amely jelzi, hogy létre lett-e hozva egy Style objektum a ControlStyle tulajdonsághoz. Ezt a tulajdonságot elsősorban a vezérlőfejlesztők használják. (Öröklődés forrása WebControl)
ControlToValidate	Lekéri vagy beállítja a bemeneti vezérlő érvényesítését. (Öröklődés forrása BaseValidator)
CssClass	Lekéri vagy beállítja az ügyfél webkiszolgáló-vezérlője által renderelt Kaszkádolt stíluslap (CSS) osztályt. (Öröklődés forrása WebControl)
DataItemContainer	Az elnevezési tárolóra mutató hivatkozás lekérdezése, ha az elnevezési tároló implementálva van IDataItemContainer. (Öröklődés forrása Control)
DataKeysContainer	Az elnevezési tárolóra mutató hivatkozás lekérdezése, ha az elnevezési tároló implementálva van IDataKeysControl. (Öröklődés forrása Control)
DesignMode	Lekéri az értéket, amely jelzi, hogy egy vezérlőt használ-e a tervezőfelületen. (Öröklődés forrása Control)
Display	Lekéri vagy beállítja a hibaüzenet megjelenítési viselkedését egy érvényesítési vezérlőben. (Öröklődés forrása BaseValidator)
EnableClientScript	Lekéri vagy beállít egy értéket, amely jelzi, hogy az ügyféloldali ellenőrzés engedélyezve van-e. (Öröklődés forrása BaseValidator)
Enabled	Lekéri vagy beállít egy értéket, amely jelzi, hogy az érvényesítési vezérlő engedélyezve van-e. (Öröklődés forrása BaseValidator)
EnableTheming	Lekéri vagy beállít egy értéket, amely jelzi, hogy a témák vonatkoznak-e erre a vezérlőre. (Öröklődés forrása WebControl)
EnableViewState	Lekéri vagy beállít egy értéket, amely jelzi, hogy a kiszolgálóvezérlő megőrzi-e a nézetállapotát, és hogy a gyermekvezérlők nézetállapota megmarad-e a kérést kérő ügyfélnek. (Öröklődés forrása Control)
ErrorMessage	Lekéri vagy beállítja a vezérlőben ValidationSummary megjelenő hibaüzenet szövegét, ha az ellenőrzés sikertelen. (Öröklődés forrása BaseValidator)
Events	Lekéri a vezérlő eseménykezelő delegáltjainak listáját. Ez a tulajdonság írásvédett. (Öröklődés forrása Control)
Font	Lekéri a webkiszolgáló-vezérlőhöz társított betűtípus-tulajdonságokat. (Öröklődés forrása WebControl)
ForeColor	Lekéri vagy beállítja az ellenőrzés sikertelensége esetén megjelenő üzenet színét. (Öröklődés forrása BaseValidator)
HasAttributes	Beolvas egy értéket, amely jelzi, hogy a vezérlő rendelkezik-e attribútumokkal. (Öröklődés forrása WebControl)
HasChildViewState	Beolvas egy értéket, amely jelzi, hogy az aktuális kiszolgálóvezérlő gyermekvezérlői rendelkeznek-e mentett nézetállapot-beállításokkal. (Öröklődés forrása Control)
Height	Lekéri vagy beállítja a webkiszolgáló-vezérlő magasságát. (Öröklődés forrása WebControl)
ID	Lekéri vagy beállítja a kiszolgálóvezérlőhöz rendelt programozott azonosítót. (Öröklődés forrása Control)
IdSeparator	Lekéri a vezérlőazonosítók elválasztásához használt karaktert. (Öröklődés forrása Control)
IsChildControlStateCleared	Beolvas egy értéket, amely jelzi, hogy a vezérlőben található vezérlők rendelkeznek-e vezérlőállapotmal. (Öröklődés forrása Control)
IsEnabled	Beolvas egy értéket, amely jelzi, hogy a vezérlő engedélyezve van-e. (Öröklődés forrása WebControl)
IsTrackingViewState	Beolvas egy értéket, amely jelzi, hogy a kiszolgálóvezérlő menti-e a nézetállapot módosításait. (Öröklődés forrása Control)
IsUnobtrusive	Olyan értéket kap, amely jelzi, hogy a vezérlő nem zavaró JavaScriptet hoz-e létre. (Öröklődés forrása BaseValidator)
IsValid	Lekéri vagy beállít egy értéket, amely jelzi, hogy a társított beviteli vezérlő megfelel-e az ellenőrzésnek. (Öröklődés forrása BaseValidator)
IsViewStateEnabled	Beolvas egy értéket, amely jelzi, hogy a nézet állapota engedélyezve van-e ehhez a vezérlőelemhez. (Öröklődés forrása Control)
LoadViewStateByID	Beolvas egy értéket, amely jelzi, hogy a vezérlő részt vesz-e a nézet állapotának index helyett való ID betöltésében. (Öröklődés forrása Control)
NamingContainer	Lekéri a kiszolgálóvezérlő elnevezési tárolójára mutató hivatkozást, amely egyedi névteret hoz létre az azonos ID tulajdonságértékkel rendelkező kiszolgálóvezérlők megkülönböztetéséhez. (Öröklődés forrása Control)
Page	A kiszolgálóvezérlőt tartalmazó példányra Page mutató hivatkozást kap. (Öröklődés forrása Control)
Parent	Hivatkozás lekéri a kiszolgálóvezérlő szülővezérlőjét a lapvezérlő hierarchiájában. (Öröklődés forrása Control)
PropertiesValid	Olyan értéket kap, amely jelzi, hogy a tulajdonság által ControlToValidate megadott vezérlőelem érvényes vezérlőelem-e. (Öröklődés forrása BaseValidator)
RenderingCompatibility	Olyan értéket kap, amely meghatározza, hogy a HTML-renderelt ASP.NET verzió kompatibilis lesz-e. (Öröklődés forrása Control)
RenderUplevel	Olyan értéket kap, amely jelzi, hogy az ügyfél böngészője támogatja-e az "uplevel" renderelést. (Öröklődés forrása BaseValidator)
SetFocusOnError	Lekéri vagy beállít egy értéket, amely jelzi, hogy a fókusz a tulajdonság által megadott vezérlőelemre van-e beállítva, ha az ControlToValidate ellenőrzés sikertelen. (Öröklődés forrása BaseValidator)
Site	Információt kap arról a tárolóról, amely az aktuális vezérlőt üzemelteti, amikor egy tervezőfelületen rendereli. (Öröklődés forrása Control)
SkinID	Lekéri vagy beállítja a bőrt, hogy alkalmazza a vezérlőt. (Öröklődés forrása WebControl)
Style	Beolvas egy szövegattribútum-gyűjteményt, amely stílusattribútumként jelenik meg a webkiszolgáló-vezérlő külső címkéjén. (Öröklődés forrása WebControl)
SupportsDisabledAttribute	Egy olyan értéket kap, amely jelzi, hogy a vezérlőnek a renderelt HTML-elem attribútumát "letiltott" értékre kell-e állítania`disabled`, ha a vezérlő tulajdonsága IsEnabled .`false` (Öröklődés forrása Label)
TabIndex	Lekéri vagy beállítja a webkiszolgáló-vezérlő tabulátorindexét. (Öröklődés forrása WebControl)
TagKey	Lekéri a vezérlő megjelenítéséhez használt HTML-címkét Label . (Öröklődés forrása Label)
TagName	Lekéri a vezérlőcímke nevét. Ezt a tulajdonságot elsősorban a vezérlő fejlesztők használják. (Öröklődés forrása WebControl)
TemplateControl	Lekéri vagy beállítja a vezérlőt tartalmazó sablonra mutató hivatkozást. (Öröklődés forrása Control)
TemplateSourceDirectory	Lekéri az aktuális kiszolgálóvezérlő virtuális Page könyvtárátUserControl. (Öröklődés forrása Control)
Text	Lekéri vagy beállítja az érvényesítési vezérlőben megjelenő szöveget, ha az ellenőrzés sikertelen. (Öröklődés forrása BaseValidator)
ToolTip	Lekéri vagy beállítja azt a szöveget, amely akkor jelenik meg, amikor az egérmutató rámutat a webkiszolgáló vezérlőelemre. (Öröklődés forrása WebControl)
UniqueID	Lekéri a kiszolgálóvezérlő egyedi, hierarchikusan minősített azonosítót. (Öröklődés forrása Control)
ValidateEmptyText	Logikai értéket kap vagy állít be, amely jelzi, hogy ellenőrizni kell-e az üres szöveget.
ValidateRequestMode	Lekéri vagy beállít egy értéket, amely jelzi, hogy a vezérlő ellenőrzi-e a böngészőből érkező ügyfélbemenetet a potenciálisan veszélyes értékekért. (Öröklődés forrása Control)
ValidationGroup	Lekéri vagy beállítja annak az érvényesítési csoportnak a nevét, amelyhez ez az ellenőrzési vezérlő tartozik. (Öröklődés forrása BaseValidator)
ViewState	Lekéri az állapotinformációk szótárát, amely lehetővé teszi egy kiszolgálóvezérlő nézetállapotának mentését és visszaállítását ugyanazon lap több kérése között. (Öröklődés forrása Control)
ViewStateIgnoresCase	Olyan értéket kap, amely jelzi, hogy az StateBag objektum kis- és nagybetűket nem érzékelyítő-e. (Öröklődés forrása Control)
ViewStateMode	Lekéri vagy beállítja ennek a vezérlőelemnek a nézetállapot-módját. (Öröklődés forrása Control)
Visible	Lekéri vagy beállít egy értéket, amely jelzi, hogy egy kiszolgálóvezérlő felhasználói felületként jelenik-e meg a lapon. (Öröklődés forrása Control)
Width	Lekéri vagy beállítja a webkiszolgáló-vezérlő szélességét. (Öröklődés forrása WebControl)

Metódusok

Name	Description
AddAttributesToRender(HtmlTextWriter)	Hozzáadja a vezérlő tulajdonságait a CustomValidator kimeneti streamhez az ügyfélen való megjelenítéshez.
AddedControl(Control, Int32)	A rendszer meghívja, miután egy gyermekvezérlőt hozzáadtak az Controls Control objektum gyűjteményéhez. (Öröklődés forrása Control)
AddParsedSubObject(Object)	Értesíti a vezérlőt arról, hogy egy elem elemzése megtörtént, és hozzáadja az elemet a Label vezérlőhöz. (Öröklődés forrása Label)
ApplyStyle(Style)	A megadott stílus nem üres elemeit átmásolja a webes vezérlőbe, felülírva a vezérlőelem meglévő stíluselemét. Ezt a módszert elsősorban a vezérlőfejlesztők használják. (Öröklődés forrása WebControl)
ApplyStyleSheetSkin(Page)	Alkalmazza a lapstíluslapon definiált stílustulajdonságokat a vezérlőelemre. (Öröklődés forrása Control)
BeginRenderTracing(TextWriter, Object)	Megkezdi a renderelési adatok tervezési idejének nyomon követését. (Öröklődés forrása Control)
BuildProfileTree(String, Boolean)	Adatokat gyűjt a kiszolgálóvezérlőről, és elküldi azt a Trace tulajdonságnak, amely akkor jelenik meg, ha a nyomkövetés engedélyezve van az oldalon. (Öröklődés forrása Control)
CheckControlValidationProperty(String, String)	Ellenőrzi, hogy a megadott vezérlő szerepel-e a lapon, és tartalmaz-e érvényesítési tulajdonságokat. (Öröklődés forrása BaseValidator)
ClearCachedClientID()	A gyorsítótárazott ClientID érték beállítása a következőre `null`: . (Öröklődés forrása Control)
ClearChildControlState()	Törli a kiszolgálóvezérlő gyermekvezérlőinek vezérlőállapot-adatait. (Öröklődés forrása Control)
ClearChildState()	Törli a kiszolgálóvezérlő gyermekvezérlőinek nézetállapot- és vezérlőállapot-információit. (Öröklődés forrása Control)
ClearChildViewState()	Törli a kiszolgálóvezérlő gyermekvezérlőinek nézetállapot-adatait. (Öröklődés forrása Control)
ClearEffectiveClientIDMode()	ClientIDMode Az aktuális vezérlőpéldány és a gyermekvezérlők tulajdonságát a következőre Inheritállítja be: . (Öröklődés forrása Control)
ControlPropertiesValid()	Ellenőrzi a vezérlő tulajdonságait az érvényes értékeknél.
CopyBaseAttributes(WebControl)	Másolja az objektum által Style nem beágyazott tulajdonságokat a megadott webkiszolgáló-vezérlőből a metódus meghívására használt webkiszolgáló-vezérlőbe. Ezt a módszert elsősorban a vezérlő fejlesztők használják. (Öröklődés forrása WebControl)
CreateChildControls()	A ASP.NET lap keretrendszere meghívta, hogy értesítse a kompozícióalapú implementációt használó kiszolgálóvezérlőket az általuk tartalmazott gyermekvezérlők létrehozására a visszaküldésre vagy a renderelésre való felkészüléshez. (Öröklődés forrása Control)
CreateControlCollection()	Létrehoz egy új ControlCollection objektumot a kiszolgálóvezérlő gyermekvezérlőinek (konstans és kiszolgáló) tárolásához. (Öröklődés forrása Control)
CreateControlStyle()	Létrehozza azt a stílusobjektumot, amelyet az osztály belsőleg használ az WebControl összes stílushoz kapcsolódó tulajdonság implementálásához. Ezt a módszert elsősorban a vezérlő fejlesztők használják. (Öröklődés forrása WebControl)
DataBind()	Az adatforrást a meghívott kiszolgálóvezérlőhöz és annak összes gyermekvezérlőihez köti. (Öröklődés forrása Control)
DataBind(Boolean)	Az adatforrást a meghívott kiszolgálóvezérlőhöz és annak gyermekvezérlőihez köti, és lehetőséget ad az DataBinding esemény elindítására. (Öröklődés forrása Control)
DataBindChildren()	Adatforrás kötése a kiszolgálóvezérlő gyermekvezérlőihez. (Öröklődés forrása Control)
DetermineRenderUplevel()	Meghatározza, hogy az érvényesítési vezérlő képes-e ügyféloldali érvényesítésre. (Öröklődés forrása BaseValidator)
Dispose()	Lehetővé teszi a kiszolgálóvezérlők számára a végleges törlést, mielőtt felszabadítanák a memóriából. (Öröklődés forrása Control)
EndRenderTracing(TextWriter, Object)	Befejezi a renderelési adatok tervezési idejének nyomon követését. (Öröklődés forrása Control)
EnsureChildControls()	Meghatározza, hogy a kiszolgálóvezérlő tartalmaz-e gyermekvezérlőket. Ha nem, gyermekvezérlőket hoz létre. (Öröklődés forrása Control)
EnsureID()	Azonosítót hoz létre azokhoz a vezérlőkhöz, amelyekhez nincs hozzárendelve azonosító. (Öröklődés forrása Control)
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
EvaluateIsValid()	Felülbírálja a metódust EvaluateIsValid() .
FindControl(String, Int32)	Az aktuális elnevezési tárolóban keres egy kiszolgálóvezérlőt a megadott `id` és a paraméterben `pathOffset` megadott egész számmal, amely segíti a keresést. Nem bírálhatja felül a FindControl metódus ezen verzióját. (Öröklődés forrása Control)
FindControl(String)	Az aktuális elnevezési tárolóban keres egy kiszolgálóvezérlőt a megadott `id` paraméterrel. (Öröklődés forrása Control)
Focus()	Vezérlőre állítja a bemeneti fókuszt. (Öröklődés forrása Control)
GetControlRenderID(String)	Lekéri a megadott vezérlő ügyfél-azonosítóját. (Öröklődés forrása BaseValidator)
GetControlValidationValue(String)	Lekéri a megadott beviteli vezérlőhöz társított értéket. (Öröklődés forrása BaseValidator)
GetDesignModeState()	Lekéri a vezérlők tervezési idejének adatait. (Öröklődés forrása Control)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetRouteUrl(Object)	Lekéri az útvonalparamétereknek megfelelő URL-címet. (Öröklődés forrása Control)
GetRouteUrl(RouteValueDictionary)	Lekéri az útvonalparamétereknek megfelelő URL-címet. (Öröklődés forrása Control)
GetRouteUrl(String, Object)	Lekéri az útvonalparamétereknek és az útvonalnévnek megfelelő URL-címet. (Öröklődés forrása Control)
GetRouteUrl(String, RouteValueDictionary)	Lekéri az útvonalparamétereknek és az útvonalnévnek megfelelő URL-címet. (Öröklődés forrása Control)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
GetUniqueIDRelativeTo(Control)	A megadott vezérlőelem tulajdonságának UniqueID előtaggal jelölt részét adja vissza. (Öröklődés forrása Control)
HasControls()	Meghatározza, hogy a kiszolgálóvezérlő tartalmaz-e gyermekvezérlőket. (Öröklődés forrása Control)
HasEvents()	Egy értéket ad vissza, amely jelzi, hogy az események regisztrálva vannak-e a vezérlőelemhez vagy bármely gyermekvezérlőhöz. (Öröklődés forrása Control)
IsLiteralContent()	Meghatározza, hogy a kiszolgálóvezérlő csak literális tartalmat tartalmaz-e. (Öröklődés forrása Control)
LoadControlState(Object)	Visszaállítja a vezérlőállapot adatait egy korábbi lapkérésből, amelyet a SaveControlState() metódus mentett. (Öröklődés forrása Control)
LoadViewState(Object)	Betölti a vezérlőelemhez korábban mentett állapotot. (Öröklődés forrása Label)
MapPathSecure(String)	Lekéri azt a fizikai útvonalat, amelybe egy virtuális elérési út abszolút vagy relatív értékként van leképezve. (Öröklődés forrása Control)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
MergeStyle(Style)	A megadott stílus nem üres elemeit átmásolja a webes vezérlőbe, de nem írja felül a vezérlőelem meglévő stíluselemét. Ezt a módszert elsősorban a vezérlő fejlesztők használják. (Öröklődés forrása WebControl)
OnBubbleEvent(Object, EventArgs)	Meghatározza, hogy a kiszolgálóvezérlő eseménye átadva van-e a lap felhasználói felület kiszolgálóvezérlő hierarchiájának. (Öröklődés forrása Control)
OnDataBinding(EventArgs)	Az eseményt emeli DataBinding ki. (Öröklődés forrása Control)
OnInit(EventArgs)	Az eseményt emeli Init ki. (Öröklődés forrása BaseValidator)
OnLoad(EventArgs)	Az eseményt emeli Load ki. (Öröklődés forrása Control)
OnPreRender(EventArgs)	Az eseményt emeli PreRender ki. (Öröklődés forrása BaseValidator)
OnServerValidate(String)	ServerValidate A vezérlő eseményét emeli CustomValidator ki.
OnUnload(EventArgs)	Az eseményt emeli Unload ki. (Öröklődés forrása BaseValidator)
OpenFile(String)	Lekéri a Stream fájl olvasásához használt fájlokat. (Öröklődés forrása Control)
RaiseBubbleEvent(Object, EventArgs)	Hozzárendeli az esemény minden forrását és információját a vezérlő szülőjének. (Öröklődés forrása Control)
RegisterValidatorCommonScript()	Az ügyféloldali ellenőrzéshez regisztrálja a kódot az oldalon. (Öröklődés forrása BaseValidator)
RegisterValidatorDeclaration()	ECMAScript-tömbdeklarációt regisztrál a tömbnév `Page_Validators`használatával. (Öröklődés forrása BaseValidator)
RemovedControl(Control)	A rendszer meghívja a gyermekvezérlőt az Controls objektum gyűjteményéből való Control eltávolítása után. (Öröklődés forrása Control)
Render(HtmlTextWriter)	Megjeleníti a vezérlőt az ügyfélen. (Öröklődés forrása BaseValidator)
RenderBeginTag(HtmlTextWriter)	Megjeleníti a vezérlőelem HTML-nyitó címkéjét a megadott írónak. Ezt a módszert elsősorban a vezérlő fejlesztők használják. (Öröklődés forrása WebControl)
RenderChildren(HtmlTextWriter)	Egy kiszolgálóvezérlő gyermekeinek tartalmát egy megadott HtmlTextWriter objektumba adja ki, amely megírja a megjelenítendő tartalmat az ügyfélen. (Öröklődés forrása Control)
RenderContents(HtmlTextWriter)	A megadott íróba rendereli a Label tartalom tartalmát. (Öröklődés forrása Label)
RenderControl(HtmlTextWriter, ControlAdapter)	A kiszolgáló egy megadott objektum tartalmát egy megadott HtmlTextWriter ControlAdapter objektummal vezérli. (Öröklődés forrása Control)
RenderControl(HtmlTextWriter)	A kiszolgáló által egy megadott HtmlTextWriter objektumra vezérlő tartalmat ad ki, és ha engedélyezve van a nyomkövetés, a vezérlő nyomkövetési információit tárolja. (Öröklődés forrása Control)
RenderEndTag(HtmlTextWriter)	A vezérlőelem HTML-záró címkéjét a megadott íróba jeleníti meg. Ezt a módszert elsősorban a vezérlő fejlesztők használják. (Öröklődés forrása WebControl)
ResolveAdapter()	Lekéri a megadott vezérlő megjelenítéséért felelős vezérlőadaptert. (Öröklődés forrása Control)
ResolveClientUrl(String)	Lekéri a böngésző által használható URL-címet. (Öröklődés forrása Control)
ResolveUrl(String)	Átalakít egy URL-címet a kérelmező ügyfélen használhatóvá. (Öröklődés forrása Control)
SaveControlState()	Menti azokat a kiszolgálóvezérlő-állapotváltozásokat, amelyek a lap kiszolgálóra való visszatérése óta történtek. (Öröklődés forrása Control)
SaveViewState()	Menti a metódus meghívása TrackViewState() után módosított állapotokat. (Öröklődés forrása WebControl)
SetDesignModeState(IDictionary)	Beállítja a vezérlőelemek tervezési idejének adatait. (Öröklődés forrása Control)
SetRenderMethodDelegate(RenderMethod)	Hozzárendel egy eseménykezelő delegáltat, hogy a kiszolgálóvezérlőt és annak tartalmát a szülővezérlőbe renderelje. (Öröklődés forrása Control)
SetTraceData(Object, Object, Object)	Nyomkövetési adatokat állít be a renderelési adatok tervezési idejű nyomkövetéséhez a nyomkövetési objektum, a nyomkövetési adatkulcs és a nyomkövetési adatérték használatával. (Öröklődés forrása Control)
SetTraceData(Object, Object)	Nyomkövetési adatokat állít be a renderelési adatok tervezési idejű nyomon követéséhez a nyomkövetési adatkulcs és a nyomkövetési adatérték használatával. (Öröklődés forrása Control)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)
TrackViewState()	Ez azt eredményezi, hogy a vezérlő nyomon követi a nézetállapot változásait, hogy azok az objektum ViewState tulajdonságában tárolhatók legyenek. (Öröklődés forrása WebControl)
Validate()	Elvégzi az ellenőrzést a társított bemeneti vezérlőn, és frissíti a tulajdonságot IsValid . (Öröklődés forrása BaseValidator)

esemény

Name	Description
DataBinding	Akkor fordul elő, ha a kiszolgálóvezérlő egy adatforráshoz kapcsolódik. (Öröklődés forrása Control)
Disposed	Akkor fordul elő, ha egy kiszolgálóvezérlő felszabadul a memóriából, amely a kiszolgálóvezérlő életciklusának utolsó szakasza, amikor egy ASP.NET lapot kérnek. (Öröklődés forrása Control)
Init	A kiszolgálóvezérlő inicializálásakor következik be, amely az életciklus első lépése. (Öröklődés forrása Control)
Load	Akkor fordul elő, ha a kiszolgálóvezérlő be van töltve az Page objektumba. (Öröklődés forrása Control)
PreRender	Az objektum betöltése után Control , de a renderelés előtt következik be. (Öröklődés forrása Control)
ServerValidate	Ez akkor fordul elő, ha az ellenőrzés a kiszolgálón történik.
Unload	Akkor fordul elő, ha a kiszolgálóvezérlő ki van ürítve a memóriából. (Öröklődés forrása Control)

Explicit interfész-implementációk

Name	Description
IAttributeAccessor.GetAttribute(String)	Lekéri a webvezérlő attribútumát a megadott névvel. (Öröklődés forrása WebControl)
IAttributeAccessor.SetAttribute(String, String)	Beállítja a webvezérlő attribútumát a megadott névre és értékre. (Öröklődés forrása WebControl)
IControlBuilderAccessor.ControlBuilder	Ennek a tagnak a leírását lásd ControlBuilder: . (Öröklődés forrása Control)
IControlDesignerAccessor.GetDesignModeState()	Ennek a tagnak a leírását lásd GetDesignModeState(): . (Öröklődés forrása Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Ennek a tagnak a leírását lásd SetDesignModeState(IDictionary): . (Öröklődés forrása Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Ennek a tagnak a leírását lásd SetOwnerControl(Control): . (Öröklődés forrása Control)
IControlDesignerAccessor.UserData	Ennek a tagnak a leírását lásd UserData: . (Öröklődés forrása Control)
IDataBindingsAccessor.DataBindings	Ennek a tagnak a leírását lásd DataBindings: . (Öröklődés forrása Control)
IDataBindingsAccessor.HasDataBindings	Ennek a tagnak a leírását lásd HasDataBindings: . (Öröklődés forrása Control)
IExpressionsAccessor.Expressions	Ennek a tagnak a leírását lásd Expressions: . (Öröklődés forrása Control)
IExpressionsAccessor.HasExpressions	Ennek a tagnak a leírását lásd HasExpressions: . (Öröklődés forrása Control)
IParserAccessor.AddParsedSubObject(Object)	Ennek a tagnak a leírását lásd AddParsedSubObject(Object): . (Öröklődés forrása Control)

Bővítő metódusok

Name	Description
FindDataSourceControl(Control)	A megadott vezérlőhöz tartozó adatforrást adja vissza.
FindFieldTemplate(Control, String)	Visszaadja a megadott oszlop mezősablonját a megadott vezérlő elnevezési tárolójában.
FindMetaTable(Control)	Az adatvezérlő metatáblás objektumát adja vissza.

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?