CustomValidator Třída

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Provádí uživatelem definované ověřování na vstupním ovládacím prvku.

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

Dědičnost: Object

Control

WebControl

Label

BaseValidator
CustomValidator

Příklady

Následující příklad kódu ukazuje, jak vytvořit ovládací prvek na straně CustomValidator serveru.

Důležité

Tento příklad obsahuje textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že vstup uživatele neobsahuje skripty ani elementy HTML. Další informace naleznete v tématu Přehled zneužití skriptů.


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

Následující příklad kódu ukazuje, jak vytvořit ovládací prvek na straně CustomValidator klienta.

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

Poznámky

CustomValidator Pomocí ovládacího prvku můžete zadat uživatelsky definovanou ověřovací funkci pro vstupní ovládací prvek. Ovládací CustomValidator prvek je samostatný ovládací prvek od vstupního ovládacího prvku, který ověří, což umožňuje určit, kde se zobrazí ověřovací zpráva.

Ověřovací ovládací prvky vždy provádějí ověření na serveru. Mají také úplnou implementaci na straně klienta, která umožňuje prohlížečům s podporou skriptů (například Microsoft Internet Explorer 4.0 a novější) provádět ověřování v klientovi. Ověření na straně klienta vylepšuje proces ověřování tím, že před odesláním na server zkontroluje vstup uživatele. To umožňuje zjistit chyby na klientovi před odesláním formuláře, a tím se vyhnout odezvě informací nezbytných pro ověření na straně serveru.

Chcete-li vytvořit funkci ověření na straně serveru, zadejte obslužnou rutinu ServerValidate události, která provádí ověření. K řetězci ze vstupního ovládacího prvku, který se má ověřit, lze získat přístup pomocí Value vlastnosti ServerValidateEventArgs objektu předaného obslužné rutině události jako parametru. Výsledek ověření se pak uloží do IsValid vlastnosti objektu ServerValidateEventArgs .

Pokud chcete vytvořit funkci ověření na straně klienta, nejprve přidejte funkci ověření na straně serveru popsanou výše. Dále na stránku ASP.NET (.aspx) přidejte funkci ověřovacího skriptu na straně klienta.

Pokud používáte Visual Basic Scripting Edition (VBScript), musí být funkce v tomto formátu:

Sub ValidationFunctionName(source, arguments)

Pokud používáte JScript, musí být funkce v tomto formátu:

function ValidationFunctionName(source, arguments)

Parametr source je odkazem na <element span> vykreslený pro CustomValidator ovládací prvek. To umožňuje programově řídit značku rozsahu<>, například úpravu atributuInnerHtml. Parametr arguments je objekt se dvěma vlastnostmi: Value a IsValid. Tento parametr umožňuje získat hodnotu ovládacího prvku k ověření a označit, zda je hodnota platná na základě vlastní ověřovací rutiny.

ClientValidationFunction Pomocí vlastnosti zadejte název ověřovací funkce ověřovacího skriptu na straně klienta přidruženého k ovládacímu CustomValidator prvku. Vzhledem k tomu, že je funkce skriptu spuštěna v klientovi, musí být funkce v jazyce, který cílový prohlížeč podporuje, například VBScript nebo JScript.

Poznámka:

Při použití CustomValidator ovládacího prvku uvnitř UpdatePanel ovládacího prvku se ujistěte, že ovládací prvek validátoru a ovládací prvek, ke kterému je přidružen, jsou na stejném panelu. Další informace o použití UpdatePanel ovládacího prvku pro částečné aktualizace stránky najdete v tématu Partial-Page Přehled vykreslování.

Podobně jako ověřování na straně serveru se k řetězci ze vstupního ovládacího prvku pro ověření přistupuje pomocí Value vlastnosti parametru arguments . Vrátí výsledek ověření nastavením IsValid vlastnosti parametru arguments .

Upozornění

Při použití ovládacích prvků validátoru byste před provedením jakéhokoli zpracování měli vždy zkontrolovat výsledky ověření na straně serveru. Po zpětném odeslání, ale před voláním metod událostí stránka volá ovládací prvky validátoru a agreguje jejich výsledky do Page.IsValid vlastnosti. (Můžete také volat ovládací prvky validátoru Validate explicitně pomocí metody.) Ve vlastním kódu byste měli zkontrolovat, že Page.IsValid se vlastnost vrací true před zpracováním vstupu. I když prohlížeče s podporou skriptů můžou zabránit tomu, aby se v klientovi v případě selhání kontroly ověření vyskytla zpětná vazba, měli byste před zpracováním ověřených dat vždy vrátit se změnami Page.IsValid kód serveru.

K ověření různých kritérií je možné použít více ověřovacích ovládacích prvků s jednotlivými vstupními ovládacími prvky. U ovládacího prvku můžete například použít více ovládacích prvků TextBox ověření, které uživateli umožní zadat množství položek, které se mají přidat do nákupního košíku. Pomocí ovládacího prvku můžete CustomValidator zajistit, aby zadaná hodnota byla menší než množství v inventáři a RequiredFieldValidator ovládací prvek, aby uživatel zadal hodnotu do TextBox ovládacího prvku.

Poznámka:

Pokud je vstupní ovládací prvek prázdný, nebudou volány žádné ověřovací funkce a ověření proběhne úspěšně. RequiredFieldValidator Pomocí ovládacího prvku potřebujete, aby uživatel zadal data do vstupního ovládacího prvku.

Ovládací prvek je možné použít CustomValidator bez nastavení ControlToValidate vlastnosti. To se obvykle provádí při ověřování více vstupních ovládacích prvků nebo ověřování vstupních ovládacích prvků, které nelze použít s ověřovacími ovládacími prvky, jako CheckBox je například ovládací prvek. V tomto případě Value vlastnost arguments parametru předaného obslužné rutině události události ServerValidate a ověřovací funkce na straně klienta vždy obsahuje prázdný řetězec (""). Tyto ověřovací funkce se však stále volají, pokud je to vhodné, aby bylo možné určit platnost serveru i klienta. Pokud chcete získat přístup k hodnotě, kterou chcete ověřit, musíte programově odkazovat na vstupní ovládací prvek, který chcete ověřit, a pak načíst hodnotu z příslušné vlastnosti. Chcete-li například ověřit CheckBox ovládací prvek na serveru, nenastavujte ControlToValidate vlastnost ověřovacího ovládacího prvku a pro obslužnou rutinu ServerValidate události použijte následující kód.

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

Další informace o ověřovacích ovládacích prvcích naleznete v tématu BaseValidator.

Přístupnost

Informace o tom, jak tento ovládací prvek nakonfigurovat tak, aby vygeneroval značky odpovídající standardům přístupnosti, najdete v tématu Přístupnost v sadě Visual Studio a ASP.NET a ASP.NET ovládací prvky a přístupnost.

Konstruktory

Name	Description
CustomValidator()	Inicializuje novou instanci CustomValidator třídy.

Vlastnosti

Name	Description
AccessKey	Získá nebo nastaví přístupový klíč, který umožňuje rychle přejít na ovládací prvek webového serveru. (Zděděno od WebControl)
Adapter	Získá adaptér specifický pro prohlížeč pro ovládací prvek. (Zděděno od Control)
AppRelativeTemplateSourceDirectory	Získá nebo nastaví relativní virtuální adresář Page aplikace nebo UserControl objektu, který obsahuje tento ovládací prvek. (Zděděno od Control)
AssociatedControlID	Tato vlastnost není podporována. (Zděděno od BaseValidator)
Attributes	Získá kolekci libovolných atributů (pouze pro vykreslování), které neodpovídají vlastnostem ovládacího prvku. (Zděděno od WebControl)
BackColor	Získá nebo nastaví barvu pozadí ovládacího prvku webového serveru. (Zděděno od WebControl)
BindingContainer	Získá ovládací prvek, který obsahuje datovou vazbu tohoto ovládacího prvku. (Zděděno od Control)
BorderColor	Získá nebo nastaví barvu ohraničení webového ovládacího prvku. (Zděděno od WebControl)
BorderStyle	Získá nebo nastaví styl ohraničení ovládacího prvku webového serveru. (Zděděno od WebControl)
BorderWidth	Získá nebo nastaví šířku ohraničení ovládacího prvku webového serveru. (Zděděno od WebControl)
ChildControlsCreated	Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClientID	Získá ID ovládacího prvku pro kód HTML, který je generován ASP.NET. (Zděděno od Control)
ClientIDMode	Získá nebo nastaví algoritmus, který se používá k vygenerování hodnoty ClientID vlastnosti. (Zděděno od Control)
ClientIDSeparator	Získá hodnotu znaku představující oddělovač znak použitý ve ClientID vlastnosti. (Zděděno od Control)
ClientValidationFunction	Získá nebo nastaví název vlastní funkce skriptu na straně klienta použité k ověření.
Context	HttpContext Získá objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek. (Zděděno od Control)
Controls	ControlCollection Získá objekt, který představuje podřízené ovládací prvky pro zadaný server ovládací prvek v hierarchii uživatelského rozhraní. (Zděděno od Control)
ControlStyle	Získá styl ovládacího prvku webového serveru. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebControl)
ControlStyleCreated	Získá hodnotu určující, zda Style objekt byl vytvořen pro ControlStyle vlastnost. Tuto vlastnost primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl)
ControlToValidate	Získá nebo nastaví vstupní ovládací prvek k ověření. (Zděděno od BaseValidator)
CssClass	Získá nebo nastaví cascading style sheet (CSS) třídy vykreslované ovládacím prvkem webového serveru v klientovi. (Zděděno od WebControl)
DataItemContainer	Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataItemContainer. (Zděděno od Control)
DataKeysContainer	Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataKeysControl. (Zděděno od Control)
DesignMode	Získá hodnotu určující, zda se ovládací prvek používá na návrhové ploše. (Zděděno od Control)
Display	Získá nebo nastaví chování zobrazení chybové zprávy v ověřovacím ovládacím prvku. (Zděděno od BaseValidator)
EnableClientScript	Získá nebo nastaví hodnotu označující, zda je povoleno ověření na straně klienta. (Zděděno od BaseValidator)
Enabled	Získá nebo nastaví hodnotu, která označuje, zda je ověřovací ovládací prvek povolen. (Zděděno od BaseValidator)
EnableTheming	Získá nebo nastaví hodnotu označující, zda motivy platí pro tento ovládací prvek. (Zděděno od WebControl)
EnableViewState	Získá nebo nastaví hodnotu určující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, do žádajícího klienta. (Zděděno od Control)
ErrorMessage	Získá nebo nastaví text chybové zprávy zobrazené v ovládacím ValidationSummary prvku při selhání ověření. (Zděděno od BaseValidator)
Events	Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen ke čtení. (Zděděno od Control)
Font	Získá vlastnosti písma přidružené k webovému serveru ovládacího prvku. (Zděděno od WebControl)
ForeColor	Získá nebo nastaví barvu zprávy zobrazenou při selhání ověření. (Zděděno od BaseValidator)
HasAttributes	Získá hodnotu určující, zda ovládací prvek má nastaveny atributy. (Zděděno od WebControl)
HasChildViewState	Získá hodnotu určující, zda aktuální serverový ovládací prvky podřízené ovládací prvky mají jakékoli uložené nastavení stavu zobrazení. (Zděděno od Control)
Height	Získá nebo nastaví výšku ovládacího prvku webového serveru. (Zděděno od WebControl)
ID	Získá nebo nastaví programový identifikátor přiřazený ovládacímu prvku serveru. (Zděděno od Control)
IdSeparator	Získá znak použitý k oddělení identifikátorů ovládacích prvků. (Zděděno od Control)
IsChildControlStateCleared	Získá hodnotu určující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav ovládacího prvku. (Zděděno od Control)
IsEnabled	Získá hodnotu označující, zda je ovládací prvek povolen. (Zděděno od WebControl)
IsTrackingViewState	Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do jeho stavu zobrazení. (Zděděno od Control)
IsUnobtrusive	Získá hodnotu, která označuje, zda ovládací prvek generuje nevěrný JavaScript. (Zděděno od BaseValidator)
IsValid	Získá nebo nastaví hodnotu, která označuje, zda přidružený vstupní ovládací prvek předává ověření. (Zděděno od BaseValidator)
IsViewStateEnabled	Získá hodnotu označující, zda je pro tento ovládací prvek povolen stav zobrazení. (Zděděno od Control)
LoadViewStateByID	Získá hodnotu určující, zda se ovládací prvek účastní načítání jeho stavu zobrazení namísto ID indexu. (Zděděno od Control)
NamingContainer	Získá odkaz na kontejner pojmenování ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro odlišné mezi serverovými ovládacími prvky se stejnou ID hodnotou vlastnosti. (Zděděno od Control)
Page	Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek. (Zděděno od Control)
Parent	Získá odkaz na nadřazený ovládací prvek ovládacího prvku serveru v hierarchii ovládacích prvků stránky. (Zděděno od Control)
PropertiesValid	Získá hodnotu, která určuje, zda ovládací prvek určený ControlToValidate vlastností je platný ovládací prvek. (Zděděno od BaseValidator)
RenderingCompatibility	Získá hodnotu, která určuje ASP.NET verzi, která vykreslený KÓD HTML bude kompatibilní s. (Zděděno od Control)
RenderUplevel	Získá hodnotu, která označuje, zda prohlížeč klienta podporuje vykreslování "uplevel". (Zděděno od BaseValidator)
SetFocusOnError	Získá nebo nastaví hodnotu, která určuje, zda je fokus nastaven na ovládací prvek určený ControlToValidate vlastností při ověření selže. (Zděděno od BaseValidator)
Site	Získá informace o kontejneru, který je hostitelem aktuálního ovládacího prvku při vykreslení na návrhové ploše. (Zděděno od Control)
SkinID	Získá nebo nastaví kůži, která se použije na ovládací prvek. (Zděděno od WebControl)
Style	Získá kolekci text atributy, které budou vykresleny jako atribut stylu na vnější značce webového serveru ovládacího prvku. (Zděděno od WebControl)
SupportsDisabledAttribute	Získá hodnotu, která určuje, zda ovládací prvek má nastavit `disabled` atribut vykresleného HTML elementu na "zakázáno" při vlastnosti ovládacího prvku IsEnabled je `false`. (Zděděno od Label)
TabIndex	Získá nebo nastaví index karty ovládacího prvku webového serveru. (Zděděno od WebControl)
TagKey	Získá HTML značku, která se používá k vykreslení Label ovládacího prvku. (Zděděno od Label)
TagName	Získá název značky ovládacího prvku. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebControl)
TemplateControl	Získá nebo nastaví odkaz na šablonu, která obsahuje tento ovládací prvek. (Zděděno od Control)
TemplateSourceDirectory	Získá virtuální adresář Page nebo UserControl který obsahuje aktuální server řízení. (Zděděno od Control)
Text	Získá nebo nastaví text zobrazený v ověřovacím ovládacím prvku při selhání ověření. (Zděděno od BaseValidator)
ToolTip	Získá nebo nastaví text zobrazený, když ukazatel myši najede myší na ovládací prvek webového serveru. (Zděděno od WebControl)
UniqueID	Získá jedinečný hierarchicky kvalifikovaný identifikátor pro ovládací prvek serveru. (Zděděno od Control)
ValidateEmptyText	Získá nebo nastaví logickou hodnotu označující, zda má být prázdný text ověřen.
ValidateRequestMode	Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek kontroluje vstup klienta z prohlížeče pro potenciálně nebezpečné hodnoty. (Zděděno od Control)
ValidationGroup	Získá nebo nastaví název ověřovací skupiny, do které patří tento ověřovací ovládací prvek. (Zděděno od BaseValidator)
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení ovládacího prvku serveru napříč několika požadavky na stejnou stránku. (Zděděno od Control)
ViewStateIgnoresCase	Získá hodnotu, která určuje, zda StateBag objekt nerozlišuje malá a velká písmena. (Zděděno od Control)
ViewStateMode	Získá nebo nastaví režim zobrazení-stav tohoto ovládacího prvku. (Zděděno od Control)
Visible	Získá nebo nastaví hodnotu, která určuje, zda je serverový ovládací prvek vykreslen jako uživatelské rozhraní na stránce. (Zděděno od Control)
Width	Získá nebo nastaví šířku ovládacího prvku webového serveru. (Zděděno od WebControl)

Metody

Name	Description
AddAttributesToRender(HtmlTextWriter)	Přidá vlastnosti ovládacího prvku do výstupního datového CustomValidator proudu pro vykreslení v klientovi.
AddedControl(Control, Int32)	Volá se po přidání podřízeného ovládacího prvku do Controls kolekce objektu Control . (Zděděno od Control)
AddParsedSubObject(Object)	Upozorní ovládací prvek, že prvek byl analyzován a přidá prvek do Label ovládacího prvku. (Zděděno od Label)
ApplyStyle(Style)	Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku a přepíše všechny existující prvky stylu ovládacího prvku. Tuto metodu primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl)
ApplyStyleSheetSkin(Page)	Použije vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek. (Zděděno od Control)
BeginRenderTracing(TextWriter, Object)	Začíná trasování doby návrhu vykreslovacích dat. (Zděděno od Control)
BuildProfileTree(String, Boolean)	Shromažďuje informace o ovládacím prvku serveru a doručuje ho Trace vlastnosti, která se má zobrazit při povolení trasování stránky. (Zděděno od Control)
CheckControlValidationProperty(String, String)	Ověřuje, zda je zadaný ovládací prvek na stránce a obsahuje vlastnosti ověření. (Zděděno od BaseValidator)
ClearCachedClientID()	Nastaví hodnotu uloženou ClientID v mezipaměti na `null`hodnotu . (Zděděno od Control)
ClearChildControlState()	Odstraní informace o stavu řízení pro podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClearChildState()	Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClearChildViewState()	Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control)
ClearEffectiveClientIDMode()	ClientIDMode Nastaví vlastnost aktuální instance ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control)
ControlPropertiesValid()	Zkontroluje vlastnosti ovládacího prvku pro platné hodnoty.
CopyBaseAttributes(WebControl)	Zkopíruje vlastnosti, které nejsou zapouzdřeny objektem Style ze zadaného ovládacího prvku webového serveru do ovládacího prvku webového serveru, ze kterého je tato metoda volána. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl)
CreateChildControls()	Volal ASP.NET stránkovací rámec, který informuje serverové ovládací prvky, které používají implementaci založenou na složení k vytvoření podřízených ovládacích prvků, které obsahují při přípravě na publikování zpět nebo vykreslování. (Zděděno od Control)
CreateControlCollection()	Vytvoří nový ControlCollection objekt pro uložení podřízených ovládacích prvků (literálu i serveru) ovládacího prvku serveru. (Zděděno od Control)
CreateControlStyle()	Vytvoří objekt stylu, který je interně WebControl používán třídou k implementaci všech vlastností souvisejících se stylem. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl)
DataBind()	Vytvoří vazbu zdroje dat na vyvolaný ovládací prvek serveru a všechny jeho podřízené ovládací prvky. (Zděděno od Control)
DataBind(Boolean)	Vytvoří vazbu zdroje dat na vyvolaný serverový ovládací prvek a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost. (Zděděno od Control)
DataBindChildren()	Vytvoří vazbu zdroje dat k podřízeným ovládacím prvkům ovládacího prvku serveru. (Zděděno od Control)
DetermineRenderUplevel()	Určuje, zda může ověřovací ovládací prvek provádět ověřování na straně klienta. (Zděděno od BaseValidator)
Dispose()	Umožňuje ovládacímu prvku serveru provést konečné vyčištění před uvolněním z paměti. (Zděděno od Control)
EndRenderTracing(TextWriter, Object)	Ukončí trasování vykreslování dat v době návrhu. (Zděděno od Control)
EnsureChildControls()	Určuje, zda ovládací prvek serveru obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky. (Zděděno od Control)
EnsureID()	Vytvoří identifikátor pro ovládací prvky, které nemají přiřazený identifikátor. (Zděděno od Control)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
EvaluateIsValid()	Přepíše metodu EvaluateIsValid() .
FindControl(String, Int32)	Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným `id` a celé číslo zadané v parametru `pathOffset` , který pomáhá při hledání. Tuto verzi FindControl metody byste neměli přepsat. (Zděděno od Control)
FindControl(String)	Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným `id` parametrem. (Zděděno od Control)
Focus()	Nastaví vstupní fokus na ovládací prvek. (Zděděno od Control)
GetControlRenderID(String)	Získá ID klienta zadaného ovládacího prvku. (Zděděno od BaseValidator)
GetControlValidationValue(String)	Získá hodnotu přidruženou k zadanému vstupnímu ovládacímu prvku. (Zděděno od BaseValidator)
GetDesignModeState()	Získá data v době návrhu pro ovládací prvek. (Zděděno od Control)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetRouteUrl(Object)	Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control)
GetRouteUrl(RouteValueDictionary)	Získá adresu URL, která odpovídá sadě parametrů trasy. (Zděděno od Control)
GetRouteUrl(String, Object)	Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control)
GetRouteUrl(String, RouteValueDictionary)	Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
GetUniqueIDRelativeTo(Control)	Vrátí předponu části UniqueID vlastnosti zadaného ovládacího prvku. (Zděděno od Control)
HasControls()	Určuje, zda serverový ovládací prvek obsahuje jakékoli podřízené ovládací prvky. (Zděděno od Control)
HasEvents()	Vrátí hodnotu určující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky. (Zděděno od Control)
IsLiteralContent()	Určuje, zda ovládací prvek serveru obsahuje pouze literálový obsah. (Zděděno od Control)
LoadControlState(Object)	Obnoví informace o stavu řízení z předchozího požadavku na stránku, který byla uložena metodou SaveControlState() . (Zděděno od Control)
LoadViewState(Object)	Načte dříve uložený stav ovládacího prvku. (Zděděno od Label)
MapPathSecure(String)	Načte fyzickou cestu, na kterou se mapuje virtuální cesta ( absolutní nebo relativní). (Zděděno od Control)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
MergeStyle(Style)	Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku, ale nepřepíše žádné existující prvky stylu ovládacího prvku. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl)
OnBubbleEvent(Object, EventArgs)	Určuje, zda je událost pro ovládací prvek serveru předána hierarchii ovládacích prvků uživatelského rozhraní stránky. (Zděděno od Control)
OnDataBinding(EventArgs)	DataBinding Vyvolá událost. (Zděděno od Control)
OnInit(EventArgs)	Init Vyvolá událost. (Zděděno od BaseValidator)
OnLoad(EventArgs)	Load Vyvolá událost. (Zděděno od Control)
OnPreRender(EventArgs)	PreRender Vyvolá událost. (Zděděno od BaseValidator)
OnServerValidate(String)	ServerValidate Vyvolá událost pro CustomValidator ovládací prvek.
OnUnload(EventArgs)	Unload Vyvolá událost. (Zděděno od BaseValidator)
OpenFile(String)	Stream Získá použité ke čtení souboru. (Zděděno od Control)
RaiseBubbleEvent(Object, EventArgs)	Přiřadí všechny zdroje události a její informace nadřazené ovládacího prvku. (Zděděno od Control)
RegisterValidatorCommonScript()	Zaregistruje kód na stránce pro ověření na straně klienta. (Zděděno od BaseValidator)
RegisterValidatorDeclaration()	Zaregistruje deklaraci pole ECMAScript pomocí názvu `Page_Validators`pole . (Zděděno od BaseValidator)
RemovedControl(Control)	Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control . (Zděděno od Control)
Render(HtmlTextWriter)	Zobrazí ovládací prvek v klientovi. (Zděděno od BaseValidator)
RenderBeginTag(HtmlTextWriter)	Vykreslí počáteční značku HTML ovládacího prvku určenému zapisovači. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl)
RenderChildren(HtmlTextWriter)	Vypíše obsah podřízených položek ovládacího prvku serveru do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control)
RenderContents(HtmlTextWriter)	Vykreslí obsah zadaného Label zapisovače. (Zděděno od Label)
RenderControl(HtmlTextWriter, ControlAdapter)	Výstupy obsahu ovládacího prvku serveru do poskytnutého HtmlTextWriter objektu pomocí poskytnutého ControlAdapter objektu. (Zděděno od Control)
RenderControl(HtmlTextWriter)	Výstupy obsahu ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je povoleno trasování. (Zděděno od Control)
RenderEndTag(HtmlTextWriter)	Vykreslí zavírací značku HTML ovládacího prvku do zadaného zapisovače. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl)
ResolveAdapter()	Získá adaptér ovládacího prvku zodpovědný za vykreslení zadaného ovládacího prvku. (Zděděno od Control)
ResolveClientUrl(String)	Získá adresu URL, kterou může prohlížeč používat. (Zděděno od Control)
ResolveUrl(String)	Převede adresu URL na adresu URL, která je použitelná u žádajícího klienta. (Zděděno od Control)
SaveControlState()	Uloží všechny změny stavu řízení serveru, ke kterým došlo od doby, kdy byla stránka odeslána zpět na server. (Zděděno od Control)
SaveViewState()	Uloží jakýkoli stav, který byl změněn po TrackViewState() vyvolání metody. (Zděděno od WebControl)
SetDesignModeState(IDictionary)	Nastaví data návrhu pro ovládací prvek. (Zděděno od Control)
SetRenderMethodDelegate(RenderMethod)	Přiřadí delegáta obslužné rutiny události k vykreslení ovládacího prvku serveru a jeho obsahu do nadřazeného ovládacího prvku. (Zděděno od Control)
SetTraceData(Object, Object, Object)	Nastaví trasovací data pro trasování doby návrhu vykreslovacích dat pomocí trasovaného objektu, klíče dat trasování a hodnoty dat trasování. (Zděděno od Control)
SetTraceData(Object, Object)	Nastaví data trasování pro trasování vykreslování dat v době návrhu pomocí klíče dat trasování a hodnoty dat trasování. (Zděděno od Control)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TrackViewState()	Způsobí, že ovládací prvek bude sledovat změny stavu zobrazení, aby je bylo možné uložit do vlastnosti objektu ViewState . (Zděděno od WebControl)
Validate()	Provádí ověření přidruženého vstupního ovládacího prvku a aktualizuje IsValid vlastnost. (Zděděno od BaseValidator)

Událost

Name	Description
DataBinding	Nastane, když ovládací prvek serveru vytvoří vazbu ke zdroji dat. (Zděděno od Control)
Disposed	Nastane, když je serverový ovládací prvek uvolněn z paměti, což je poslední fáze životního cyklu řízení serveru při vyžádání ASP.NET stránky. (Zděděno od Control)
Init	Nastane při inicializaci ovládacího prvku serveru, což je první krok v jeho životním cyklu. (Zděděno od Control)
Load	Nastane, když je serverový ovládací prvek načten do objektu Page . (Zděděno od Control)
PreRender	Nastane po načtení objektu Control , ale před vykreslením. (Zděděno od Control)
ServerValidate	Nastane při ověření na serveru.
Unload	Nastane, když je serverový ovládací prvek uvolněn z paměti. (Zděděno od Control)

Explicitní implementace rozhraní

Name	Description
IAttributeAccessor.GetAttribute(String)	Získá atribut webového ovládacího prvku se zadaným názvem. (Zděděno od WebControl)
IAttributeAccessor.SetAttribute(String, String)	Nastaví atribut webového ovládacího prvku na zadaný název a hodnotu. (Zděděno od WebControl)
IControlBuilderAccessor.ControlBuilder	Popis tohoto člena naleznete v tématu ControlBuilder. (Zděděno od Control)
IControlDesignerAccessor.GetDesignModeState()	Popis tohoto člena naleznete v tématu GetDesignModeState(). (Zděděno od Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Popis tohoto člena naleznete v tématu SetDesignModeState(IDictionary). (Zděděno od Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Popis tohoto člena naleznete v tématu SetOwnerControl(Control). (Zděděno od Control)
IControlDesignerAccessor.UserData	Popis tohoto člena naleznete v tématu UserData. (Zděděno od Control)
IDataBindingsAccessor.DataBindings	Popis tohoto člena naleznete v tématu DataBindings. (Zděděno od Control)
IDataBindingsAccessor.HasDataBindings	Popis tohoto člena naleznete v tématu HasDataBindings. (Zděděno od Control)
IExpressionsAccessor.Expressions	Popis tohoto člena naleznete v tématu Expressions. (Zděděno od Control)
IExpressionsAccessor.HasExpressions	Popis tohoto člena naleznete v tématu HasExpressions. (Zděděno od Control)
IParserAccessor.AddParsedSubObject(Object)	Popis tohoto člena naleznete v tématu AddParsedSubObject(Object). (Zděděno od Control)

Metody rozšíření

Name	Description
FindDataSourceControl(Control)	Vrátí zdroj dat přidružený k ovládacímu prvku dat pro zadaný ovládací prvek.
FindFieldTemplate(Control, String)	Vrátí šablonu pole pro zadaný sloupec v kontejneru pojmenování zadaného ovládacího prvku.
FindMetaTable(Control)	Vrátí objekt metatable pro ovládací prvek obsahující data.

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?