BaseValidator Třída
Definice
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í.
Slouží jako abstraktní základní třída pro ověřovací ovládací prvky.
public ref class BaseValidator abstract : System::Web::UI::WebControls::Label, System::Web::UI::IValidator
public abstract class BaseValidator : System.Web.UI.WebControls.Label, System.Web.UI.IValidator
type BaseValidator = class
inherit Label
interface IValidator
Public MustInherit Class BaseValidator
Inherits Label
Implements IValidator
- Dědičnost
- Odvozené
- Implementuje
Příklady
Následující příklad kódu ukazuje, jak pomocí více ověřovacích ovládacích prvků ověřit, že uživatel zadá platnou hodnotu do ovládacího prvku TextBox.
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 Script Exploits Overview.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void Button_Click(Object sender, EventArgs e)
{
if (Page.IsValid)
{
MessageLabel.Text = "Page submitted successfully.";
}
else
{
MessageLabel.Text = "There is an error on the page.";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Validator Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Validator Example</h3>
Enter a number from 1 to 10.
<asp:textbox id="NumberTextBox"
runat="server"/>
<asp:rangevalidator id="NumberCompareValidator"
controltovalidate="NumberTextBox"
enableclientscript="False"
type="Integer"
display="Dynamic"
errormessage="Please enter a value from 1 to 10."
maximumvalue="10"
minimumvalue="1"
text="*"
runat="server"/>
<asp:requiredfieldvalidator id="TextBoxRequiredValidator"
controltovalidate="NumberTextBox"
enableclientscript="False"
display="Dynamic"
errormessage="Please enter a value."
text="*"
runat="server"/>
<br /><br />
<asp:button id="SubmitButton"
text="Submit"
onclick="Button_Click"
runat="server"/>
<br /><br />
<asp:label id="MessageLabel"
runat="server"/>
<br /><br />
<asp:validationsummary
id="ErrorSummary"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="False" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub Button_Click(ByVal sender As Object, ByVal e As EventArgs) Handles SubmitButton.Click
If Page.IsValid Then
MessageLabel.Text = "Page submitted successfully."
Else
MessageLabel.Text = "There is an error on the page."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Validator Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Validator Example</h3>
Enter a number from 1 to 10.
<asp:textbox id="NumberTextBox"
runat="server"/>
<asp:rangevalidator id="NumberCompareValidator"
controltovalidate="NumberTextBox"
enableclientscript="False"
type="Integer"
display="Dynamic"
errormessage="Please enter a value from 1 to 10."
maximumvalue="10"
minimumvalue="1"
text="*"
runat="server"/>
<asp:requiredfieldvalidator id="TextBoxRequiredValidator"
controltovalidate="NumberTextBox"
enableclientscript="False"
display="Dynamic"
errormessage="Please enter a value."
text="*"
runat="server"/>
<br /><br />
<asp:button id="SubmitButton"
text="Submit"
runat="server"/>
<br /><br />
<asp:label id="MessageLabel"
runat="server"/>
<br /><br />
<asp:validationsummary
id="ErrorSummary"
runat="server"/>
</form>
</body>
</html>
Poznámky
Třída BaseValidator poskytuje základní implementaci pro všechny ověřovací ovládací prvky. Ověřovací ovládací prvky slouží k ověření uživatelského vstupu v přidruženém vstupním ovládacím prvku. Když uživatel zadá hodnotu, která selže ověření, zobrazí ověřovací ovládací prvek chybovou zprávu. Vzhledem k tomu, že ověřovací ovládací prvek je oddělený od vstupního ovládacího prvku, můžete chybovou zprávu umístit kdekoli na stránce vzhledem ke vstupnímu ovládacímu prvku. ASP.NET poskytuje několik ověřovacích ovládacích prvků, které provádějí konkrétní typy ověření. Následující tabulka popisuje tyto ovládací prvky.
Ověřovací ovládací prvek | Popis |
---|---|
CompareValidator | Ověří hodnotu proti hodnotě zadané do jiného vstupního ovládacího prvku, proti konstantní hodnotě nebo správnému datovému typu nastavením vlastnosti CompareValidator.Operator na ValidationCompareOperator.DataTypeCheck. |
CustomValidator | Ověří hodnotu pomocí vlastní ověřovací rutiny poskytnuté uživatelem. |
RangeValidator | Ověří, jestli je hodnota v rozsahu hodnot. |
RegularExpressionValidator | Ověří hodnotu pomocí regulárního výrazu. |
RequiredFieldValidator | Ověří, že hodnota byla zadána do požadovaného pole. |
Ověřovací ovládací prvky vždy ověřují přidružený vstupní ovládací prvek na serveru. Ovládací prvky ověřování mají také úplnou implementaci na straně klienta, která umožňuje prohlížečům s podporou skriptů (jako je Microsoft Internet Explorer verze 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 vyhnout se tak odezvě informací nezbytných pro ověření na straně 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. Například u TextBox ovládacího prvku můžete použít více ovládacích prvků ověřování. Ovládací prvek RangeValidator můžete použít k zajištění, aby hodnota zadaná v ovládacím prvku TextBox byla v nastaveném rozsahu, a ovládací prvek RequiredFieldValidator, který zajistí, že uživatel zadá hodnotu.
ASP.NET poskytuje mnoho ovládacích prvků, které mají možnost publikovat zpět na server. Pokud jeden z těchto ovládacích prvků má jeho CausesValidation
vlastnost nastavena na true
, ověřování se provádí, když ovládací prvek publikuje zpět na server. Následující ovládací prvky mají možnost publikovat zpět na server:
Poznámka
Některé z těchto ovládacích prvků se publikují zpět na server pouze v případech, kdy je vlastnost AutoPostBack
nastavena na true
.
Tyto ovládací prvky mají ValidationGroup
vlastnost, která při nastavení ověří pouze ověřovací ovládací prvky v zadané skupině, když ovládací prvek aktivuje příspěvek zpět na server. Chcete-li seskupit ovládací prvky ověřování, nastavte vlastnost ValidationGroup každého ověřovacího ovládacího prvku na stejnou hodnotu.
Chcete-li přidružit vstupní ovládací prvek k ověřovacímu ovládacímu prvku, použijte vlastnost ControlToValidate. Chcete-li zadat text, který se má zobrazit v ověřovacím ovládacím prvku při selhání ověření, použijte vlastnost Text. Pomocí ovládacího prvku ValidationSummary můžete také zobrazit souhrn všech ovládacích prvků, které na stránce selžou ověření. Chcete-li zadat text, který se má zobrazit v ovládacím prvku ValidationSummary, použijte vlastnost ErrorMessage.
Poznámka
Pokud nastavíte vlastnost ErrorMessage bez nastavení vlastnosti Text, zobrazí se v ověřovacím ovládacím prvku také hodnota vlastnosti ErrorMessage.
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á validátor ovládací prvky a agreguje jejich výsledky do Page.IsValid vlastnosti. (Ovládací prvky validátoru můžete také volat explicitně pomocí metody Validate
.) Ve vlastním kódu byste měli zkontrolovat, že vlastnost Page.IsValid 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í nepovedla, měli byste před zpracováním ověřených dat vždy zkontrolovat Page.IsValid v kódu serveru.
Ověření můžete provést také ručně. K ověření všech ověřovacích ovládacích prvků na stránce použijte metodu Page.Validate. Jednotlivé ověřovací ovládací prvky lze ověřit pomocí Validate metody ovládacího prvku.
Poznámka
Pokud v metodě Page_Load
použijete vlastnost Page.IsValid, musíte nejprve explicitně volat metodu Page.Validate. Vzhledem k tomu, že k ověření dochází po Control.Load události stránky, ale před obslužnou rutinou události pro Click
nebo Command
události, Page.IsValid vlastnost není aktualizována, dokud nebude volána metoda Page.Validate. Jako alternativu můžete kód umístit do obslužné rutiny události pro Click
nebo Command
událost místo metody Page_Load
.
Ne všechny ovládací prvky webového serveru podporují ověřovací ovládací prvky. Standardní ovládací prvky, které lze ověřit pomocí ověřovacího ovládacího prvku, jsou:
Poznámka
Aby bylo možné ověřit vstupní ovládací prvek, musí být u ovládacího prvku použit atribut System.Web.UI.ValidationPropertyAttribute.
Poznámka
Pokud používáte ovládací prvky validátoru odvozené z BaseValidator uvnitř ovládacího prvku UpdatePanel, ujistěte se, ž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í ovládacího prvku UpdatePanel pro částečné aktualizace stránky naleznete v tématu Partial-Page Přehled vykreslování.
Pokud se ověření nezdaří, můžete nastavit fokus na přidružený vstupní ovládací prvek nastavením vlastnosti SetFocusOnError na true
.
Seznam počátečních hodnot vlastností pro instanci BaseValidatornaleznete v konstruktoru BaseValidator.
Přístupnost
Informace o tom, jak tento ovládací prvek nakonfigurovat tak, aby vygeneroval značky, které odpovídají standardům přístupnosti, najdete v tématu Přístupnost v sadě Visual Studio a ASP.NET a ASP.NET ovládací prvky apřístupnosti .
Poznámky pro implementátory
Když dědíte z třídy BaseValidator, musíte přepsat následující člen: EvaluateIsValid().
Konstruktory
BaseValidator() |
Inicializuje novou instanci BaseValidator třídy. |
Vlastnosti
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í aplikační relativní virtuální adresář Page nebo UserControl objektu, který obsahuje tento ovládací prvek. (Zděděno od Control) |
AssociatedControlID |
Tato vlastnost není podporována. |
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 vlastnost. (Zděděno od Control) |
ClientIDSeparator |
Získá znak hodnotu představující oddělovač znak použitý v ClientID vlastnost. (Zděděno od Control) |
Context |
Získá HttpContext objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek. (Zděděno od Control) |
Controls |
Získá ControlCollection 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í. |
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. |
EnableClientScript |
Získá nebo nastaví hodnotu označující, zda je povoleno ověření na straně klienta. |
Enabled |
Získá nebo nastaví hodnotu, která označuje, zda je ověřovací ovládací prvek povolen. |
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 prvku ValidationSummary při selhání ověření. |
Events |
Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen pro č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í. |
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. |
IsValid |
Získá nebo nastaví hodnotu, která označuje, zda přidružený vstupní ovládací prvek předává ověření. |
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í ID místo 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 oddělení mezi serverovými ovládacími prvky se stejnou hodnotou vlastnosti ID. (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. |
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". |
SetFocusOnError |
Získá nebo nastaví hodnotu, která určuje, zda je fokus nastaven na ovládací prvek určený ControlToValidate vlastnost při selhání ověření. |
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 |
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í serverový ovládací prvek. (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í. |
Text |
Získá nebo nastaví textový obsah Label ovládacího prvku. (Zděděno od Label) |
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) |
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. |
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
AddAttributesToRender(HtmlTextWriter) |
Přidá atributy a styly HTML, které je potřeba vykreslit pro ovládací prvek do zadaného HtmlTextWriter objektu. |
AddedControl(Control, Int32) |
Volá se po přidání podřízeného ovládacího prvku do Controls kolekce Control objektu. (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 do vlastnosti Trace, 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í. |
ClearCachedClientID() |
Nastaví hodnotu ClientID uloženou v mezipaměti na |
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() |
Nastaví vlastnost ClientIDMode 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() |
Určuje, zda ovládací prvek určený vlastností ControlToValidate je platný ovládací prvek. |
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ý objekt ControlCollection 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ý se interně používá WebControl třídy 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. |
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ři přepsání v odvozené třídě tato metoda obsahuje kód pro určení, zda hodnota ve vstupním ovládacím prvku je platná. |
FindControl(String, Int32) |
Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným |
FindControl(String) |
Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným parametrem |
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. |
GetControlValidationValue(String) |
Získá hodnotu přidruženou k zadanému vstupnímu ovládacímu prvku. |
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 vlastnosti UniqueID zadaného ovládacího prvku. (Zděděno od Control) |
GetValidationProperty(Object) |
Určuje vlastnost ověření ovládacího prvku (pokud existuje). |
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ý byl uložen 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) |
Vyvolá událost DataBinding. (Zděděno od Control) |
OnInit(EventArgs) |
Vyvolá událost Init. |
OnLoad(EventArgs) |
Vyvolá událost Load. (Zděděno od Control) |
OnPreRender(EventArgs) |
Vyvolá událost PreRender. |
OnUnload(EventArgs) |
Vyvolá událost Unload. |
OpenFile(String) |
Získá Stream slouží 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. |
RegisterValidatorDeclaration() |
Zaregistruje deklaraci pole ECMAScript pomocí názvu pole |
RemovedControl(Control) |
Volá se po odebrání podřízeného ovládacího prvku z kolekce Controls objektu Control. (Zděděno od Control) |
Render(HtmlTextWriter) |
Zobrazí ovládací prvek v klientovi. |
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 objektu HtmlTextWriter, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control) |
RenderContents(HtmlTextWriter) |
Vykreslí obsah Label do zadaného zapisovače. (Zděděno od Label) |
RenderControl(HtmlTextWriter, ControlAdapter) |
Výstupem obsahu ovládacího prvku serveru do zadaného objektu HtmlTextWriter pomocí poskytnutého objektu ControlAdapter. (Zděděno od Control) |
RenderControl(HtmlTextWriter) |
Výstupy obsahu ovládacího prvku serveru do zadaného objektu HtmlTextWriter 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 vyvolání metody TrackViewState(). (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 ViewState objektu. (Zděděno od WebControl) |
Validate() |
Provádí ověření u přidruženého vstupního ovládacího prvku a aktualizuje vlastnost IsValid. |
Událost
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 Page objektu. (Zděděno od Control) |
PreRender |
Nastane po načtení Control objektu, ale před vykreslením. (Zděděno od Control) |
Unload |
Nastane, když je serverový ovládací prvek uvolněn z paměti. (Zděděno od Control) |
Explicitní implementace rozhraní
Metody rozšíření
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. |