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::IValidatorpublic abstract class BaseValidator : System.Web.UI.WebControls.Label, System.Web.UI.IValidatortype BaseValidator = class
inherit Label
interface IValidatorPublic MustInherit Class BaseValidator
Inherits Label
Implements IValidator- Dědičnost
- Odvozené
- Implementuje
Příklady
Následující příklad kódu ukazuje, jak použít více ověřovacích ovládacích prvků k ověření, že uživatel zadá platnou hodnotu v ovládacím 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ěřte, že uživatelský vstup neobsahuje skript nebo elementy HTML. Další informace najdete v tématu Přehled zneužití skriptů.
<%@ 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 se používají k ověření vstupu uživatele v přidruženém vstupním ovládacím prvku. Když uživatel zadá hodnotu, která ověření selže, 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 k ovládacímu prvku vstupu. ASP.NET poskytuje několik ověřovacích ovládacích prvků, které provádějí konkrétní typy ověřování. Tyto ovládací prvky jsou popsány v následující tabulce.
| Ověřovací ovládací prvek | Description |
|---|---|
| CompareValidator | Ověří hodnotu proti hodnotě zadané do jiného vstupního ovládacího prvku, konstantní hodnotě nebo správnému datovému typu nastavením CompareValidator.Operator vlastnosti 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ěří, jestli byla do požadovaného pole zadána hodnota. |
Ověřovací ovládací prvky vždy ověřují přidružený vstupní ovládací prvek na serveru. Ověřovací ovládací prvky mají také úplnou implementaci na straně klienta, která umožňuje ověřování klienta v prohlížečích s podporou skriptů (například Microsoft Internet Explorer verze 4.0 a novější). Ověřování na straně klienta vylepšuje proces ověřování tím, že kontroluje vstup uživatele před jeho odesláním na server. To umožňuje detekovat chyby na klientovi před odesláním formuláře a vyhnout se tak odezvě informací nezbytných pro ověření na straně serveru.
Několik ověřovacích ovládacích prvků lze použít s jednotlivými vstupními ovládacími prvky k ověření různých kritérií. U ovládacího prvku můžete například použít více ověřovacích ovládacích prvků TextBox . Pomocí ovládacího prvku můžete RangeValidator zajistit, aby hodnota zadaná v ovládacím TextBox prvku byla v nastaveném rozsahu RequiredFieldValidator , a ovládací prvek, který zajistí, že uživatel zadá hodnotu.
ASP.NET poskytuje mnoho ovládacích prvků, které mohou publikovat zpět na server. Pokud má jeden z těchto ovládacích prvků vlastnost CausesValidation nastavenou na true, ověření se provede, když se ovládací prvek odešle zpět na server. Následující ovládací prvky mají možnost odeslat příspěvek zpět na server:
Poznámka
Některé z těchtoovládacích AutoPostBacktrue
Každý z těchto ovládacích prvků má ValidationGroup vlastnost, která při nastavení ověřuje pouze ověřovací ovládací prvky v rámci zadané skupiny, když ovládací prvek aktivuje příspěvek zpět na server. Pokud chcete ověřovací ovládací prvky seskupit, nastavte ValidationGroup vlastnost každého ověřovacího ovládacího prvku na stejnou hodnotu.
Pokud chcete přidružit vstupní ovládací prvek k ověřovacímu ovládacímu ControlToValidate prvku, použijte vlastnost . Pokud chcete určit text, který se má zobrazit v ověřovacím ovládacím prvku, když se ověření nezdaří, použijte Text vlastnost . Pomocí ovládacího prvku můžete také na stránce ValidationSummary zobrazit souhrn všech ovládacích prvků, které se nepodaří ověřit. Pokud chcete zadat text, který se má zobrazit v ovládacím ValidationSummary prvku, použijte ErrorMessage vlastnost .
Poznámka
Pokud nastavíte ErrorMessage vlastnost bez nastavení Text vlastnosti , hodnota ErrorMessage vlastnosti se zobrazí také v ověřovacím ovládacím prvku.
Při použití ovládacích prvků validátoru byste měli vždy zkontrolovat výsledky ověření na straně serveru před provedením jakéhokoli zpracování. 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 . (Ovládací prvky validátoru můžete také volat explicitně pomocí Validate metody .) Ve vlastním kódu byste měli před zpracováním vstupu zkontrolovat, že Page.IsValid se vlastnost vrací true . I když prohlížeče s podporou skriptů můžou zabránit zpětnému odeslání v klientovi v případě selhání ověřovací kontroly, měli byste před zpracováním ověřených dat vždy také zkontrolovat Page.IsValid kód 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 je možné ověřit pomocí Validate metody ovládacího prvku.
Poznámka
Pokud použijete Page.IsValid vlastnost v Page_Load metodě, musíte nejprve explicitně volat metodu Page.Validate . Vzhledem k tomu, že ověření probíhá po Control.Load události pro stránku, ale před obslužnou rutinou ClickCommand události nebo událostí, Page.IsValid není vlastnost aktualizována, dokud Page.Validate není volána metoda. Alternativně můžete kód umístit do obslužné rutiny události nebo ClickCommandPage_Load namísto do metody .
Ne všechny ovládací prvky webového serveru podporují ovládací prvky ověřování. Standardní ovládací prvky, které je možné ověřit pomocí ověřovacího ovládacího prvku, jsou:
Poznámka
Aby bylo možné ověřit vstupní ovládací prvek, System.Web.UI.ValidationPropertyAttribute musí být u ovládacího prvku použit atribut .
Poznámka
Pokud používáte ovládací prvky validátoruUpdatePanel, které jsou odvozené z BaseValidator uvnitř ovládacího prvku, 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í UpdatePanel ovládacího prvku pro částečné aktualizace stránky najdete v tématu Přehled vykreslování částečné stránky.
Pokud se ověření nezdaří, můžete nastavit fokus na přidružený vstupní ovládací prvek nastavením SetFocusOnError vlastnosti na true.
Seznam počátečních hodnot vlastností pro instanci BaseValidatornaleznete v konstruktoru BaseValidator .
Usnadnění
Informace o konfiguraci tohoto ovládacího prvku tak, aby vygeneroval značky, které odpovídají standardům přístupnosti, najdete v tématech Usnadnění v sadě Visual Studio a ASP.NET a ASP.NET Ovládací prvky a přístupnost.
Poznámky pro implementátory
Když dědíte z BaseValidator třídy , 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í aplikace relativní virtuální adresář nebo UserControl objektuPage, 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 datové vazby 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í znak oddělovače použitý ve ClientID vlastnosti. (Zděděno od Control) |
| 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 označ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í ovládací prvek vstupu k ověření. |
| CssClass |
Získá nebo nastaví kaskádové šablony stylů (CSS) třídy vykreslené ovládacím prvkem webového serveru v klientovi. (Zděděno od WebControl) |
| DataItemContainer |
Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataItemContainer. (Zděděno od Control) |
| DataKeysContainer |
Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataKeysControl. (Zděděno od Control) |
| DesignMode |
Získá hodnotu označující, zda je ovládací prvek použit na návrhové ploše. (Zděděno od Control) |
| Display |
Získá nebo nastaví chování zobrazení chybové zprávy v ovládacím prvku ověření. |
| 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 povolen ovládací prvek ověření. |
| EnableTheming |
Získá nebo nastaví hodnotu označující, zda motivy použít 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, pro žádajícího klienta. (Zděděno od Control) |
| ErrorMessage |
Získá nebo nastaví text pro chybovou zprávu zobrazenou 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 ke čtení. (Zděděno od Control) |
| Font |
Získá vlastnosti písma přidružené k ovládacímu prvku webového serveru. (Zděděno od WebControl) |
| ForeColor |
Získá nebo nastaví barvu zprávy zobrazené při ověření se nezdaří. |
| HasAttributes |
Získá hodnotu označující, zda ovládací prvek má nastaveny atributy. (Zděděno od WebControl) |
| HasChildViewState |
Získá hodnotu označující, zda podřízené ovládací prvky aktuálního serveru mají 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ý k 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 označující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav řízení. (Zděděno od Control) |
| IsEnabled |
Získá hodnotu označující, zda je povolen ovládací prvek. (Zděděno od WebControl) |
| IsTrackingViewState |
Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do stavu zobrazení. (Zděděno od Control) |
| IsUnobtrusive |
Získá hodnotu, která označuje, zda ovládací prvek generuje nevtíravý JavaScript. |
| IsValid |
Získá nebo nastaví hodnotu, která označuje, zda přidružený vstupní ovládací prvek projde ověřením. |
| 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 označující, zda se ovládací prvek účastní načítání stavu ID zobrazení místo indexu. (Zděděno od Control) |
| NamingContainer |
Získá odkaz na názvový kontejner ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro rozdíl 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 serverový ovládací prvek nadřazený ovládací prvek v hierarchii ovládacích prvků stránky. (Zděděno od Control) |
| PropertiesValid |
Získá hodnotu, která označuje, zda je ovládací prvek určený ControlToValidate vlastností platný ovládací prvek. |
| RenderingCompatibility |
Získá hodnotu, která určuje ASP.NET verze, která vykreslí HTML bude kompatibilní s. (Zděděno od Control) |
| RenderUplevel |
Získá hodnotu, která označuje, zda prohlížeč klienta podporuje "uplevel" vykreslování. |
| SetFocusOnError |
Získá nebo nastaví hodnotu, která označuje, zda je fokus nastaven na ovládací prvek určený ControlToValidate vlastností při ověření se nezdaří. |
| Site |
Získá informace o kontejneru, který hostuje aktuální ovládací prvek při vykreslení na návrhové ploše. (Zděděno od Control) |
| SkinID |
Získá nebo nastaví vzhled pro použití ovládacího prvku. (Zděděno od WebControl) |
| Style |
Získá kolekci textových atributů, které budou vykresleny jako atribut stylu na vnější značku webového serveru ovládacího prvku. (Zděděno od WebControl) |
| SupportsDisabledAttribute |
Získá hodnotu, která označuje, zda má ovládací prvek nastavit |
| TabIndex |
Získá nebo nastaví index tabulátoru ovládacího prvku webového serveru. (Zděděno od WebControl) |
| TagKey |
Získá značku HTML, 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 ověření se nezdaří. |
| 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 na ovládací prvek webového serveru. (Zděděno od WebControl) |
| UniqueID |
Získá jedinečný hierarchicky kvalifikovaný identifikátor serverového ovládacího prvku. (Zděděno od Control) |
| ValidateRequestMode |
Získá nebo nastaví hodnotu, která označ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í serverového ovládacího prvku napříč více požadavky na stejnou stránku. (Zděděno od Control) |
| ViewStateIgnoresCase |
Získá hodnotu, která označuje, zda StateBag objekt nerozlišuje malá a velká písmena. (Zděděno od Control) |
| ViewStateMode |
Získá nebo nastaví režim zobrazení stavu tohoto ovládacího prvku. (Zděděno od Control) |
| Visible |
Získá nebo nastaví hodnotu, která označ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 HTML a styly, které je tř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 objektu Control . (Zděděno od Control) |
| AddParsedSubObject(Object) |
Oznámí ovládacímu prvku, že byl prvek analyzován, a přidá ho Label do 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) |
Zahájí trasování vykreslování dat v době návrhu. (Zděděno od Control) |
| BuildProfileTree(String, Boolean) |
Shromáždí informace o ovládacím prvku serveru a doručí je do Trace vlastnosti, která se má zobrazit, když je pro stránku povolené trasování. (Zděděno od Control) |
| CheckControlValidationProperty(String, String) |
Ověří, jestli je zadaný ovládací prvek na stránce a obsahuje vlastnosti ověření. |
| ClearCachedClientID() |
Nastaví hodnotu v ClientID mezipaměti na |
| ClearChildControlState() |
Odstraní informace o stavu řízení pro podřízené ovládací prvky serveru. (Zděděno od Control) |
| ClearChildState() |
Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky serveru. (Zděděno od Control) |
| ClearChildViewState() |
Odstraní informace o stavu zobrazení všech podřízených ovládacích prvků 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() |
Určuje, zda je ovládací prvek určený ControlToValidate vlastností platný. |
| CopyBaseAttributes(WebControl) |
Zkopíruje vlastnosti neza zapouzdřené objektem Style ze zadaného ovládacího prvku webového serveru do ovládacího prvku webového serveru, ze kterého je volána tato metoda. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| CreateChildControls() |
Volá se rozhraním ASP.NET stránky, aby upozornily ovládací prvky serveru, které používají implementaci založenou na složení k vytvoření všech 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, který bude obsahovat podřízené ovládací prvky (literál i server) serverového ovládacího prvku. (Zděděno od Control) |
| CreateControlStyle() |
Vytvoří objekt stylu, který je interně používán třídou k implementaci všech vlastností souvisejících se stylem WebControl . Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| DataBind() |
Vytvoří vazbu zdroje dat na vyvoláný serverový ovládací prvek a všechny jeho podřízené ovládací prvky. (Zděděno od Control) |
| DataBind(Boolean) |
Vytvoří vazbu zdroje dat na vyvoláný 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() |
Sváže zdroj dat s podřízenými ovládacími prvky serverového ovládacího prvku. (Zděděno od Control) |
| DetermineRenderUplevel() |
Určuje, zda může ovládací prvek ověření provést ověření 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í vykreslovaných dat v době návrhu. (Zděděno od Control) |
| EnsureChildControls() |
Určuje, zda serverový ovládací prvek obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky. (Zděděno od Control) |
| EnsureID() |
Vytvoří identifikátor ovládacích prvků, které nemají přiřazený identifikátor. (Zděděno od Control) |
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| EvaluateIsValid() |
Při přepsání v odvozené třídě tato metoda obsahuje kód k určení, zda je hodnota v ovládacím prvku vstupu platná. |
| FindControl(String) |
Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek pomocí zadaného |
| FindControl(String, Int32) |
Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek se zadaným |
| Focus() |
Nastaví fokus vstupu 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í hashovací funkce. (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ázev trasy. (Zděděno od Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy. (Zděděno od Control) |
| GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
| GetUniqueIDRelativeTo(Control) |
Vrátí předponu 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, jestli serverový ovládací prvek obsahuje nějaké podřízené ovládací prvky. (Zděděno od Control) |
| HasEvents() |
Vrátí hodnotu označ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, jestli serverový ovládací prvek obsahuje pouze obsah literálu. (Zděděno od Control) |
| LoadControlState(Object) |
Obnoví informace o stavu řízení z předchozího požadavku stránky, 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 Objectsouboru . (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í především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Určuje, zda je událost serverového ovládacího prvku předána hierarchii ovládacích prvků serveru 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. |
| OnLoad(EventArgs) |
Load Vyvolá událost. (Zděděno od Control) |
| OnPreRender(EventArgs) |
PreRender Vyvolá událost. |
| OnUnload(EventArgs) |
Unload Vyvolá událost. |
| OpenFile(String) |
Stream Získá zvyk 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ímu 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 |
| 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 na klientovi. |
| RenderBeginTag(HtmlTextWriter) |
Vykreslí levou značku HTML ovládacího prvku určenému zapisovači. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| RenderChildren(HtmlTextWriter) |
Vypíše obsah podřízených položek serverového ovládacího prvku do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control) |
| RenderContents(HtmlTextWriter) |
Vykreslí obsah objektu Label do zadaného zapisovače. (Zděděno od Label) |
| RenderControl(HtmlTextWriter) |
Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povolené. (Zděděno od Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu. (Zděděno od Control) |
| RenderEndTag(HtmlTextWriter) |
Vykreslí koncovou značku HTML ovládacího prvku do zadaného zapisovače. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| ResolveAdapter() |
Získá řídicí adaptér zodpovědný za vykreslení zadaného ovládacího prvku. (Zděděno od Control) |
| ResolveClientUrl(String) |
Získá adresu URL, kterou lze použít v prohlížeči. (Zděděno od Control) |
| ResolveUrl(String) |
Převede adresu URL na adresu URL, která je použitelná v žádajícím klientovi. (Zděděno od Control) |
| SaveControlState() |
Uloží všechny změny stavu ovládacího prvku serveru, ke kterým došlo od okamžiku, kdy byla stránka odeslána zpět na server. (Zděděno od Control) |
| SaveViewState() |
Uloží všechny stavy, které byly změněny po vyvolání TrackViewState() metody. (Zděděno od WebControl) |
| SetDesignModeState(IDictionary) |
Nastaví data v době návrhu ovládacího prvku. (Zděděno od Control) |
| SetRenderMethodDelegate(RenderMethod) |
Přiřadí delegáta obslužné rutiny události, který vykresluje serverový ovládací prvek a jeho obsah do nadřazeného ovládacího prvku. (Zděděno od Control) |
| SetTraceData(Object, Object) |
Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí klíče dat trasování a hodnoty dat trasování. (Zděděno od Control) |
| SetTraceData(Object, Object, Object) |
Nastaví trasovací data pro trasování vykreslování dat v době návrhu pomocí trasovaného objektu, 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 sleduje změny stavu zobrazení, aby mohly být uloženy ve vlastnosti objektu ViewState . (Zděděno od WebControl) |
| Validate() |
Provede ověření přidruženého vstupního ovládacího prvku a aktualizuje IsValid vlastnost . |
Událost
| DataBinding |
Nastane, když ovládací prvek serveru vytvoří vazbu na zdroj dat. (Zděděno od Control) |
| Disposed |
Nastane při uvolnění serverového ovládacího prvku z paměti, což je poslední fáze životního cyklu řízení serveru, když je požadována stránka ASP.NET. (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 při načtení serverového ovládacího prvku 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) |
| Unload |
Vyvolá se při uvolnění serverového ovládacího prvku 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 názvů 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
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro