BaseValidator Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Az érvényesítési vezérlők absztrakt alaposztályaként szolgál.
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
- Öröklődés
- Származtatott
- Megvalósítás
Példák
Az alábbi példakód bemutatja, hogyan használhat több érvényesítési vezérlőt annak ellenőrzésére, hogy a felhasználó érvényes értéket ad-e meg egy TextBox vezérlőben.
Important
Ebben a példában egy szövegdoboz található, amely elfogadja a felhasználói bemenetet, ami potenciális biztonsági fenyegetés. Alapértelmezés szerint ASP.NET weblapok ellenőrzik, hogy a felhasználói bevitel nem tartalmaz-e szkript- vagy HTML-elemeket. További információ: Szkript kihasználása – áttekintés.
<%@ Page Language="C#" %>
<!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>
Megjegyzések
Az BaseValidator osztály biztosítja az összes érvényesítési vezérlő alapvető implementációját. Az érvényesítési vezérlők a felhasználói bemenet ellenőrzésére szolgálnak a társított beviteli vezérlőkben. Amikor a felhasználó olyan értéket ad meg, amely nem érvényes, az érvényesítési vezérlő hibaüzenetet jelenít meg. Mivel az érvényesítési vezérlő külön van a beviteli vezérlőtől, a hibaüzenetet bárhol elhelyezheti a lapon a beviteli vezérlőhöz képest. ASP.NET számos olyan érvényesítési vezérlőt biztosít, amelyek bizonyos típusú érvényesítést hajtanak végre. Az alábbi táblázat ezeket a vezérlőket ismerteti.
| Érvényesítési vezérlő | Leírás |
|---|---|
| CompareValidator | Egy értéket egy másik bemeneti vezérlőbe beírt értéken, állandó értéken vagy egy megfelelő adattípuson érvényesít a CompareValidator.Operator tulajdonság ValidationCompareOperator.DataTypeCheckbeállításával. |
| CustomValidator | Egy értéket egy felhasználó által megadott egyéni ellenőrzési rutin használatával érvényesít. |
| RangeValidator | Ellenőrzi, hogy egy érték egy értéktartományon belül van-e. |
| RegularExpressionValidator | Egy érték ellenőrzése egy reguláris kifejezéssel. |
| RequiredFieldValidator | Ellenőrzi, hogy egy érték be lett-e írva egy kötelező mezőbe. |
Az érvényesítési vezérlők mindig ellenőrzik a kiszolgálóhoz társított bemeneti vezérlőt. Az érvényesítési vezérlők teljes körű ügyféloldali implementációval is rendelkeznek, amely lehetővé teszi a parancsfájl-kompatibilis böngészők (például Microsoft Internet Explorer 4.0-s és újabb verziói) számára az ellenőrzés végrehajtását az ügyfélen. Az ügyféloldali érvényesítés javítja az érvényesítési folyamatot azáltal, hogy ellenőrzi a felhasználói bemenetet, mielőtt elküldené azt a kiszolgálónak. Ez lehetővé teszi a hibák észlelését az ügyfélen az űrlap elküldése előtt, elkerülve a kiszolgálóoldali ellenőrzéshez szükséges információk megkerülését.
A különböző feltételek érvényesítéséhez több érvényesítési vezérlő is használható egyéni beviteli vezérlővel. Egy vezérlőre például több érvényesítési vezérlőt TextBox is alkalmazhat. Egy vezérlővel RangeValidator gondoskodhat arról, hogy a vezérlőelemben TextBox megadott érték egy megadott tartományon belül legyen, és RequiredFieldValidator hogy a vezérlők biztosíthassák, hogy a felhasználó beírja az értéket.
ASP.NET számos olyan vezérlőt biztosít, amely képes a kiszolgálóra való visszatérésre. Ha az egyik vezérlő tulajdonsága CausesValidation a következőre truevan állítva, az ellenőrzés akkor történik meg, amikor a vezérlő visszahelyez a kiszolgálóra. Az alábbi vezérlők a kiszolgálóra való visszatérésre képesek:
Note
Ezen vezérlők némelyike csak akkor kerül vissza a kiszolgálóra, ha a AutoPostBack tulajdonság értéke true.
Ezek a vezérlők rendelkeznek olyan ValidationGroup tulajdonságokkal, amelyek beállításkor csak a megadott csoportban lévő érvényesítési vezérlőket ellenőrzik, amikor a vezérlő egy bejegyzést indít vissza a kiszolgálóra. Az érvényesítési vezérlők csoportosításához állítsa az ValidationGroup egyes érvényesítési vezérlők tulajdonságát ugyanarra az értékre.
Ha egy beviteli vezérlőt egy érvényesítési vezérlőhöz szeretne társítani, használja a tulajdonságot ControlToValidate . Ha meg szeretné adni az érvényesítési vezérlőben az ellenőrzés sikertelen végrehajtásakor megjelenítendő szöveget, használja a tulajdonságot Text . Egy vezérlőelem használatával ValidationSummary megjelenítheti az összes olyan vezérlő összegzését is, amely nem érvényesíthető a lapon. A vezérlőelemben ValidationSummary megjelenítendő szöveg megadásához használja a tulajdonságot ErrorMessage .
Note
Ha a ErrorMessage tulajdonság beállítása nélkül állítja be a Text tulajdonságot, a ErrorMessage tulajdonság értéke is megjelenik az érvényesítési vezérlőben.
Az érvényesítő vezérlők használatakor a feldolgozás előtt mindig ellenőrizze a kiszolgálóoldali ellenőrzés eredményeit. A visszavétel után, de az esemény metódusainak meghívása előtt az oldal meghívja az érvényesítő vezérlőket, és összesíti az eredményeket a Page.IsValid tulajdonságban. (Az érvényesítő vezérlőket explicit módon is meghívhatja a Validate metódus használatával.) A saját kódjában ellenőrizze, hogy a tulajdonság visszatér-e Page.IsValid a true bemenet feldolgozása előtt. Annak ellenére, hogy a parancsfájlokkal kompatibilis böngészők megakadályozhatják, hogy az ellenőrzés sikertelen ellenőrzése esetén utóvisszaküldés történjen az ügyfélen, az érvényesített adatok feldolgozása előtt mindig ellenőrizze Page.IsValid a kiszolgáló kódját is.
Manuálisan is elvégezheti az ellenőrzést. A lap összes érvényesítési vezérlőjének ellenőrzéséhez használja a metódust Page.Validate . Az egyes érvényesítési vezérlők a vezérlő metódusával Validate érvényesíthetők.
Note
Ha a Page.IsValid tulajdonságot metódusban Page_Load használja, először explicit módon kell meghívnia a metódust Page.Validate . Mivel az ellenőrzés az oldal eseménye Control.Load után, de az eseménykezelő vagy Click események eseménykezelője Command előtt történik, a Page.IsValid tulajdonság nem frissül a metódus meghívásáigPage.Validate. Másik lehetőségként a metódus helyett az eseménykezelőben ClickCommand helyezheti el a Page_Load kódot.
Nem minden webkiszolgáló-vezérlő támogatja az érvényesítési vezérlőket. Az érvényesítési vezérlőkkel érvényesíthető szabványos vezérlők a következők:
Note
Egy bemeneti vezérlő érvényesítéséhez az System.Web.UI.ValidationPropertyAttribute attribútumot a vezérlőre kell alkalmazni.
Note
Ha egy BaseValidator vezérlőn belülről származó UpdatePanel érvényesítő vezérlőket használ, győződjön meg arról, hogy az érvényesítő vezérlőelem és a hozzá társított vezérlő ugyanabban a panelen található. A vezérlő részleges oldalfrissítésekhez való használatáról UpdatePanel további információt aPartial-Page Rendering Overview című témakörben talál.
Ha az ellenőrzés sikertelen, a tulajdonság beállításával beállíthatja a fókuszt a társított beviteli SetFocusOnError vezérlőre true.
Egy példány kezdeti tulajdonságértékeinek BaseValidatorlistáját a BaseValidator konstruktorban találja.
Accessibility
A vezérlő akadálymentességi szabványoknak megfelelő korrektúra létrehozására való konfigurálásáról további információt a Megfelelőség Visual Studio és ASP.NET és ASP.NET Vezérlők és kisegítő lehetőségek című témakörben talál.
Megjegyzések az implementálókhoz
Ha az BaseValidator osztálytól örököl, felül kell bírálnia a következő tagot: EvaluateIsValid().
Konstruktorok
| Név | Description |
|---|---|
| BaseValidator() |
Inicializálja a BaseValidator osztály új példányát. |
Tulajdonságok
| Név | Description |
|---|---|
| AccessKey |
Lekéri vagy beállítja a hozzáférési kulcsot, amely lehetővé teszi a webkiszolgáló-vezérlő gyors navigálását. (Öröklődés forrása WebControl) |
| Adapter |
Lekéri a vezérlő böngészőspecifikus adapterét. (Öröklődés forrása Control) |
| AppRelativeTemplateSourceDirectory |
Lekéri vagy beállítja a vezérlőt tartalmazó objektum Page alkalmazás-relatív virtuális könyvtárátUserControl. (Öröklődés forrása Control) |
| AssociatedControlID |
Ez a tulajdonság nem támogatott. |
| Attributes |
Lekéri a vezérlőelem tulajdonságainak nem megfelelő tetszőleges attribútumok gyűjteményét (csak rendereléshez). (Öröklődés forrása WebControl) |
| BackColor |
Lekéri vagy beállítja a webkiszolgáló-vezérlő háttérszínét. (Öröklődés forrása WebControl) |
| BindingContainer |
Lekéri a vezérlő adatkötését tartalmazó vezérlőt. (Öröklődés forrása Control) |
| BorderColor |
Lekéri vagy beállítja a webes vezérlő szegélyszínét. (Öröklődés forrása WebControl) |
| BorderStyle |
Lekéri vagy beállítja a webkiszolgáló-vezérlő szegélystílusát. (Öröklődés forrása WebControl) |
| BorderWidth |
Lekéri vagy beállítja a webkiszolgáló-vezérlő szegélyszélességét. (Öröklődés forrása WebControl) |
| ChildControlsCreated |
Beolvas egy értéket, amely jelzi, hogy a kiszolgálóvezérlő gyermekvezérlői létrejöttek-e. (Öröklődés forrása Control) |
| ClientID |
Lekéri a ASP.NET által létrehozott HTML-korrektúra vezérlőazonosítóját. (Öröklődés forrása Control) |
| ClientIDMode |
Lekéri vagy beállítja a tulajdonság értékének létrehozásához használt algoritmust ClientID . (Öröklődés forrása Control) |
| ClientIDSeparator |
Beolvas egy karakterértéket, amely a tulajdonságban használt elválasztó karaktert ClientID jelöli. (Öröklődés forrása Control) |
| Context |
Lekéri az HttpContext aktuális webkérelem kiszolgálóvezérlőjével társított objektumot. (Öröklődés forrása Control) |
| Controls |
ControlCollection Lekéri az objektumot, amely egy adott kiszolgálóvezérlő gyermekvezérlőit jelöli a felhasználói felületi hierarchiában. (Öröklődés forrása Control) |
| ControlStyle |
Lekéri a webkiszolgáló-vezérlő stílusát. Ezt a tulajdonságot elsősorban a vezérlő fejlesztők használják. (Öröklődés forrása WebControl) |
| ControlStyleCreated |
Beolvas egy értéket, amely jelzi, hogy létre lett-e hozva egy Style objektum a ControlStyle tulajdonsághoz. Ezt a tulajdonságot elsősorban a vezérlőfejlesztők használják. (Öröklődés forrása WebControl) |
| ControlToValidate |
Lekéri vagy beállítja a bemeneti vezérlő érvényesítését. |
| CssClass |
Lekéri vagy beállítja az ügyfél webkiszolgáló-vezérlője által renderelt Kaszkádolt stíluslap (CSS) osztályt. (Öröklődés forrása WebControl) |
| DataItemContainer |
Az elnevezési tárolóra mutató hivatkozás lekérdezése, ha az elnevezési tároló implementálva van IDataItemContainer. (Öröklődés forrása Control) |
| DataKeysContainer |
Az elnevezési tárolóra mutató hivatkozás lekérdezése, ha az elnevezési tároló implementálva van IDataKeysControl. (Öröklődés forrása Control) |
| DesignMode |
Lekéri az értéket, amely jelzi, hogy egy vezérlőt használ-e a tervezőfelületen. (Öröklődés forrása Control) |
| Display |
Lekéri vagy beállítja a hibaüzenet megjelenítési viselkedését egy érvényesítési vezérlőben. |
| EnableClientScript |
Lekéri vagy beállít egy értéket, amely jelzi, hogy az ügyféloldali ellenőrzés engedélyezve van-e. |
| Enabled |
Lekéri vagy beállít egy értéket, amely jelzi, hogy az érvényesítési vezérlő engedélyezve van-e. |
| EnableTheming |
Lekéri vagy beállít egy értéket, amely jelzi, hogy a témák vonatkoznak-e erre a vezérlőre. (Öröklődés forrása WebControl) |
| EnableViewState |
Lekéri vagy beállít egy értéket, amely jelzi, hogy a kiszolgálóvezérlő megőrzi-e a nézetállapotát, és hogy a gyermekvezérlők nézetállapota megmarad-e a kérést kérő ügyfélnek. (Öröklődés forrása Control) |
| ErrorMessage |
Lekéri vagy beállítja a vezérlőben ValidationSummary megjelenő hibaüzenet szövegét, ha az ellenőrzés sikertelen. |
| Events |
Lekéri a vezérlő eseménykezelő delegáltjainak listáját. Ez a tulajdonság írásvédett. (Öröklődés forrása Control) |
| Font |
Lekéri a webkiszolgáló-vezérlőhöz társított betűtípus-tulajdonságokat. (Öröklődés forrása WebControl) |
| ForeColor |
Lekéri vagy beállítja az ellenőrzés sikertelensége esetén megjelenő üzenet színét. |
| HasAttributes |
Beolvas egy értéket, amely jelzi, hogy a vezérlő rendelkezik-e attribútumokkal. (Öröklődés forrása WebControl) |
| HasChildViewState |
Beolvas egy értéket, amely jelzi, hogy az aktuális kiszolgálóvezérlő gyermekvezérlői rendelkeznek-e mentett nézetállapot-beállításokkal. (Öröklődés forrása Control) |
| Height |
Lekéri vagy beállítja a webkiszolgáló-vezérlő magasságát. (Öröklődés forrása WebControl) |
| ID |
Lekéri vagy beállítja a kiszolgálóvezérlőhöz rendelt programozott azonosítót. (Öröklődés forrása Control) |
| IdSeparator |
Lekéri a vezérlőazonosítók elválasztásához használt karaktert. (Öröklődés forrása Control) |
| IsChildControlStateCleared |
Beolvas egy értéket, amely jelzi, hogy a vezérlőben található vezérlők rendelkeznek-e vezérlőállapotmal. (Öröklődés forrása Control) |
| IsEnabled |
Beolvas egy értéket, amely jelzi, hogy a vezérlő engedélyezve van-e. (Öröklődés forrása WebControl) |
| IsTrackingViewState |
Beolvas egy értéket, amely jelzi, hogy a kiszolgálóvezérlő menti-e a nézetállapot módosításait. (Öröklődés forrása Control) |
| IsUnobtrusive |
Olyan értéket kap, amely jelzi, hogy a vezérlő nem zavaró JavaScriptet hoz-e létre. |
| IsValid |
Lekéri vagy beállít egy értéket, amely jelzi, hogy a társított beviteli vezérlő megfelel-e az ellenőrzésnek. |
| IsViewStateEnabled |
Beolvas egy értéket, amely jelzi, hogy a nézet állapota engedélyezve van-e ehhez a vezérlőelemhez. (Öröklődés forrása Control) |
| LoadViewStateByID |
Beolvas egy értéket, amely jelzi, hogy a vezérlő részt vesz-e a nézet állapotának index helyett való ID betöltésében. (Öröklődés forrása Control) |
| NamingContainer |
Lekéri a kiszolgálóvezérlő elnevezési tárolójára mutató hivatkozást, amely egyedi névteret hoz létre az azonos ID tulajdonságértékkel rendelkező kiszolgálóvezérlők megkülönböztetéséhez. (Öröklődés forrása Control) |
| Page |
A kiszolgálóvezérlőt tartalmazó példányra Page mutató hivatkozást kap. (Öröklődés forrása Control) |
| Parent |
Hivatkozás lekéri a kiszolgálóvezérlő szülővezérlőjét a lapvezérlő hierarchiájában. (Öröklődés forrása Control) |
| PropertiesValid |
Olyan értéket kap, amely jelzi, hogy a tulajdonság által ControlToValidate megadott vezérlőelem érvényes vezérlőelem-e. |
| RenderingCompatibility |
Olyan értéket kap, amely meghatározza, hogy a HTML-renderelt ASP.NET verzió kompatibilis lesz-e. (Öröklődés forrása Control) |
| RenderUplevel |
Olyan értéket kap, amely jelzi, hogy az ügyfél böngészője támogatja-e az "uplevel" renderelést. |
| SetFocusOnError |
Lekéri vagy beállít egy értéket, amely jelzi, hogy a fókusz a tulajdonság által megadott vezérlőelemre van-e beállítva, ha az ControlToValidate ellenőrzés sikertelen. |
| Site |
Információt kap arról a tárolóról, amely az aktuális vezérlőt üzemelteti, amikor egy tervezőfelületen rendereli. (Öröklődés forrása Control) |
| SkinID |
Lekéri vagy beállítja a bőrt, hogy alkalmazza a vezérlőt. (Öröklődés forrása WebControl) |
| Style |
Beolvas egy szövegattribútum-gyűjteményt, amely stílusattribútumként jelenik meg a webkiszolgáló-vezérlő külső címkéjén. (Öröklődés forrása WebControl) |
| SupportsDisabledAttribute |
Egy olyan értéket kap, amely jelzi, hogy a vezérlőnek a renderelt HTML-elem attribútumát "letiltott" értékre kell-e állítania |
| TabIndex |
Lekéri vagy beállítja a webkiszolgáló-vezérlő tabulátorindexét. (Öröklődés forrása WebControl) |
| TagKey |
Lekéri a vezérlő megjelenítéséhez használt HTML-címkét Label . (Öröklődés forrása Label) |
| TagName |
Lekéri a vezérlőcímke nevét. Ezt a tulajdonságot elsősorban a vezérlő fejlesztők használják. (Öröklődés forrása WebControl) |
| TemplateControl |
Lekéri vagy beállítja a vezérlőt tartalmazó sablonra mutató hivatkozást. (Öröklődés forrása Control) |
| TemplateSourceDirectory |
Lekéri az aktuális kiszolgálóvezérlő virtuális Page könyvtárátUserControl. (Öröklődés forrása Control) |
| Text |
Lekéri vagy beállítja az érvényesítési vezérlőben megjelenő szöveget, ha az ellenőrzés sikertelen. |
| Text |
Lekéri vagy beállítja a Label vezérlőelem szöveges tartalmát. (Öröklődés forrása Label) |
| ToolTip |
Lekéri vagy beállítja azt a szöveget, amely akkor jelenik meg, amikor az egérmutató rámutat a webkiszolgáló vezérlőelemre. (Öröklődés forrása WebControl) |
| UniqueID |
Lekéri a kiszolgálóvezérlő egyedi, hierarchikusan minősített azonosítót. (Öröklődés forrása Control) |
| ValidateRequestMode |
Lekéri vagy beállít egy értéket, amely jelzi, hogy a vezérlő ellenőrzi-e a böngészőből érkező ügyfélbemenetet a potenciálisan veszélyes értékekért. (Öröklődés forrása Control) |
| ValidationGroup |
Lekéri vagy beállítja annak az érvényesítési csoportnak a nevét, amelyhez ez az ellenőrzési vezérlő tartozik. |
| ViewState |
Lekéri az állapotinformációk szótárát, amely lehetővé teszi egy kiszolgálóvezérlő nézetállapotának mentését és visszaállítását ugyanazon lap több kérése között. (Öröklődés forrása Control) |
| ViewStateIgnoresCase |
Olyan értéket kap, amely jelzi, hogy az StateBag objektum kis- és nagybetűket nem érzékelyítő-e. (Öröklődés forrása Control) |
| ViewStateMode |
Lekéri vagy beállítja ennek a vezérlőelemnek a nézetállapot-módját. (Öröklődés forrása Control) |
| Visible |
Lekéri vagy beállít egy értéket, amely jelzi, hogy egy kiszolgálóvezérlő felhasználói felületként jelenik-e meg a lapon. (Öröklődés forrása Control) |
| Width |
Lekéri vagy beállítja a webkiszolgáló-vezérlő szélességét. (Öröklődés forrása WebControl) |
Metódusok
| Név | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Hozzáadja a vezérlőelemhez megjelenítendő HTML-attribútumokat és stílusokat a megadott HtmlTextWriter objektumhoz. |
| AddedControl(Control, Int32) |
A rendszer meghívja, miután egy gyermekvezérlőt hozzáadtak az ControlsControl objektum gyűjteményéhez. (Öröklődés forrása Control) |
| AddParsedSubObject(Object) |
Értesíti a vezérlőt arról, hogy egy elem elemzése megtörtént, és hozzáadja az elemet a Label vezérlőhöz. (Öröklődés forrása Label) |
| ApplyStyle(Style) |
A megadott stílus nem üres elemeit átmásolja a webes vezérlőbe, felülírva a vezérlőelem meglévő stíluselemét. Ezt a módszert elsősorban a vezérlőfejlesztők használják. (Öröklődés forrása WebControl) |
| ApplyStyleSheetSkin(Page) |
Alkalmazza a lapstíluslapon definiált stílustulajdonságokat a vezérlőelemre. (Öröklődés forrása Control) |
| BeginRenderTracing(TextWriter, Object) |
Megkezdi a renderelési adatok tervezési idejének nyomon követését. (Öröklődés forrása Control) |
| BuildProfileTree(String, Boolean) |
Adatokat gyűjt a kiszolgálóvezérlőről, és elküldi azt a Trace tulajdonságnak, amely akkor jelenik meg, ha a nyomkövetés engedélyezve van az oldalon. (Öröklődés forrása Control) |
| CheckControlValidationProperty(String, String) |
Ellenőrzi, hogy a megadott vezérlő szerepel-e a lapon, és tartalmaz-e érvényesítési tulajdonságokat. |
| ClearCachedClientID() |
A gyorsítótárazott ClientID érték beállítása a következőre |
| ClearChildControlState() |
Törli a kiszolgálóvezérlő gyermekvezérlőinek vezérlőállapot-adatait. (Öröklődés forrása Control) |
| ClearChildState() |
Törli a kiszolgálóvezérlő gyermekvezérlőinek nézetállapot- és vezérlőállapot-információit. (Öröklődés forrása Control) |
| ClearChildViewState() |
Törli a kiszolgálóvezérlő gyermekvezérlőinek nézetállapot-adatait. (Öröklődés forrása Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Az aktuális vezérlőpéldány és a gyermekvezérlők tulajdonságát a következőre Inheritállítja be: . (Öröklődés forrása Control) |
| ControlPropertiesValid() |
Meghatározza, hogy a tulajdonság által ControlToValidate megadott vezérlőelem érvényes-e. |
| CopyBaseAttributes(WebControl) |
Másolja az objektum által Style nem beágyazott tulajdonságokat a megadott webkiszolgáló-vezérlőből a metódus meghívására használt webkiszolgáló-vezérlőbe. Ezt a módszert elsősorban a vezérlő fejlesztők használják. (Öröklődés forrása WebControl) |
| CreateChildControls() |
A ASP.NET lap keretrendszere meghívta, hogy értesítse a kompozícióalapú implementációt használó kiszolgálóvezérlőket az általuk tartalmazott gyermekvezérlők létrehozására a visszaküldésre vagy a renderelésre való felkészüléshez. (Öröklődés forrása Control) |
| CreateControlCollection() |
Létrehoz egy új ControlCollection objektumot a kiszolgálóvezérlő gyermekvezérlőinek (konstans és kiszolgáló) tárolásához. (Öröklődés forrása Control) |
| CreateControlStyle() |
Létrehozza azt a stílusobjektumot, amelyet az osztály belsőleg használ az WebControl összes stílushoz kapcsolódó tulajdonság implementálásához. Ezt a módszert elsősorban a vezérlő fejlesztők használják. (Öröklődés forrása WebControl) |
| DataBind() |
Az adatforrást a meghívott kiszolgálóvezérlőhöz és annak összes gyermekvezérlőihez köti. (Öröklődés forrása Control) |
| DataBind(Boolean) |
Az adatforrást a meghívott kiszolgálóvezérlőhöz és annak gyermekvezérlőihez köti, és lehetőséget ad az DataBinding esemény elindítására. (Öröklődés forrása Control) |
| DataBindChildren() |
Adatforrás kötése a kiszolgálóvezérlő gyermekvezérlőihez. (Öröklődés forrása Control) |
| DetermineRenderUplevel() |
Meghatározza, hogy az érvényesítési vezérlő képes-e ügyféloldali érvényesítésre. |
| Dispose() |
Lehetővé teszi a kiszolgálóvezérlők számára a végleges törlést, mielőtt felszabadítanák a memóriából. (Öröklődés forrása Control) |
| EndRenderTracing(TextWriter, Object) |
Befejezi a renderelési adatok tervezési idejének nyomon követését. (Öröklődés forrása Control) |
| EnsureChildControls() |
Meghatározza, hogy a kiszolgálóvezérlő tartalmaz-e gyermekvezérlőket. Ha nem, gyermekvezérlőket hoz létre. (Öröklődés forrása Control) |
| EnsureID() |
Azonosítót hoz létre azokhoz a vezérlőkhöz, amelyekhez nincs hozzárendelve azonosító. (Öröklődés forrása Control) |
| Equals(Object) |
Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object) |
| EvaluateIsValid() |
Ha egy származtatott osztályban felül van bírálva, ez a metódus tartalmazza azt a kódot, amely meghatározza, hogy a bemeneti vezérlő értéke érvényes-e. |
| FindControl(String, Int32) |
Az aktuális elnevezési tárolóban keres egy kiszolgálóvezérlőt a megadott |
| FindControl(String) |
Az aktuális elnevezési tárolóban keres egy kiszolgálóvezérlőt a megadott |
| Focus() |
Vezérlőre állítja a bemeneti fókuszt. (Öröklődés forrása Control) |
| GetControlRenderID(String) |
Lekéri a megadott vezérlő ügyfél-azonosítóját. |
| GetControlValidationValue(String) |
Lekéri a megadott beviteli vezérlőhöz társított értéket. |
| GetDesignModeState() |
Lekéri a vezérlők tervezési idejének adatait. (Öröklődés forrása Control) |
| GetHashCode() |
Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object) |
| GetRouteUrl(Object) |
Lekéri az útvonalparamétereknek megfelelő URL-címet. (Öröklődés forrása Control) |
| GetRouteUrl(RouteValueDictionary) |
Lekéri az útvonalparamétereknek megfelelő URL-címet. (Öröklődés forrása Control) |
| GetRouteUrl(String, Object) |
Lekéri az útvonalparamétereknek és az útvonalnévnek megfelelő URL-címet. (Öröklődés forrása Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Lekéri az útvonalparamétereknek és az útvonalnévnek megfelelő URL-címet. (Öröklődés forrása Control) |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| GetUniqueIDRelativeTo(Control) |
A megadott vezérlőelem tulajdonságának UniqueID előtaggal jelölt részét adja vissza. (Öröklődés forrása Control) |
| GetValidationProperty(Object) |
Meghatározza egy vezérlőelem érvényesítési tulajdonságát (ha létezik). |
| HasControls() |
Meghatározza, hogy a kiszolgálóvezérlő tartalmaz-e gyermekvezérlőket. (Öröklődés forrása Control) |
| HasEvents() |
Egy értéket ad vissza, amely jelzi, hogy az események regisztrálva vannak-e a vezérlőelemhez vagy bármely gyermekvezérlőhöz. (Öröklődés forrása Control) |
| IsLiteralContent() |
Meghatározza, hogy a kiszolgálóvezérlő csak literális tartalmat tartalmaz-e. (Öröklődés forrása Control) |
| LoadControlState(Object) |
Visszaállítja a vezérlőállapot adatait egy korábbi lapkérésből, amelyet a SaveControlState() metódus mentett. (Öröklődés forrása Control) |
| LoadViewState(Object) |
Betölti a vezérlőelemhez korábban mentett állapotot. (Öröklődés forrása Label) |
| MapPathSecure(String) |
Lekéri azt a fizikai útvonalat, amelybe egy virtuális elérési út abszolút vagy relatív értékként van leképezve. (Öröklődés forrása Control) |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| MergeStyle(Style) |
A megadott stílus nem üres elemeit átmásolja a webes vezérlőbe, de nem írja felül a vezérlőelem meglévő stíluselemét. Ezt a módszert elsősorban a vezérlő fejlesztők használják. (Öröklődés forrása WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Meghatározza, hogy a kiszolgálóvezérlő eseménye átadva van-e a lap felhasználói felület kiszolgálóvezérlő hierarchiájának. (Öröklődés forrása Control) |
| OnDataBinding(EventArgs) |
Az eseményt emeli DataBinding ki. (Öröklődés forrása Control) |
| OnInit(EventArgs) |
Az eseményt emeli Init ki. |
| OnLoad(EventArgs) |
Az eseményt emeli Load ki. (Öröklődés forrása Control) |
| OnPreRender(EventArgs) |
Az eseményt emeli PreRender ki. |
| OnUnload(EventArgs) |
Az eseményt emeli Unload ki. |
| OpenFile(String) |
Lekéri a Stream fájl olvasásához használt fájlokat. (Öröklődés forrása Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Hozzárendeli az esemény minden forrását és információját a vezérlő szülőjének. (Öröklődés forrása Control) |
| RegisterValidatorCommonScript() |
Az ügyféloldali ellenőrzéshez regisztrálja a kódot az oldalon. |
| RegisterValidatorDeclaration() |
ECMAScript-tömbdeklarációt regisztrál a tömbnév |
| RemovedControl(Control) |
A rendszer meghívja a gyermekvezérlőt az Controls objektum gyűjteményéből való Control eltávolítása után. (Öröklődés forrása Control) |
| Render(HtmlTextWriter) |
Megjeleníti a vezérlőt az ügyfélen. |
| RenderBeginTag(HtmlTextWriter) |
Megjeleníti a vezérlőelem HTML-nyitó címkéjét a megadott írónak. Ezt a módszert elsősorban a vezérlő fejlesztők használják. (Öröklődés forrása WebControl) |
| RenderChildren(HtmlTextWriter) |
Egy kiszolgálóvezérlő gyermekeinek tartalmát egy megadott HtmlTextWriter objektumba adja ki, amely megírja a megjelenítendő tartalmat az ügyfélen. (Öröklődés forrása Control) |
| RenderContents(HtmlTextWriter) |
A megadott íróba rendereli a Label tartalom tartalmát. (Öröklődés forrása Label) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
A kiszolgáló egy megadott objektum tartalmát egy megadott HtmlTextWriterControlAdapter objektummal vezérli. (Öröklődés forrása Control) |
| RenderControl(HtmlTextWriter) |
A kiszolgáló által egy megadott HtmlTextWriter objektumra vezérlő tartalmat ad ki, és ha engedélyezve van a nyomkövetés, a vezérlő nyomkövetési információit tárolja. (Öröklődés forrása Control) |
| RenderEndTag(HtmlTextWriter) |
A vezérlőelem HTML-záró címkéjét a megadott íróba jeleníti meg. Ezt a módszert elsősorban a vezérlő fejlesztők használják. (Öröklődés forrása WebControl) |
| ResolveAdapter() |
Lekéri a megadott vezérlő megjelenítéséért felelős vezérlőadaptert. (Öröklődés forrása Control) |
| ResolveClientUrl(String) |
Lekéri a böngésző által használható URL-címet. (Öröklődés forrása Control) |
| ResolveUrl(String) |
Átalakít egy URL-címet a kérelmező ügyfélen használhatóvá. (Öröklődés forrása Control) |
| SaveControlState() |
Menti azokat a kiszolgálóvezérlő-állapotváltozásokat, amelyek a lap kiszolgálóra való visszatérése óta történtek. (Öröklődés forrása Control) |
| SaveViewState() |
Menti a metódus meghívása TrackViewState() után módosított állapotokat. (Öröklődés forrása WebControl) |
| SetDesignModeState(IDictionary) |
Beállítja a vezérlőelemek tervezési idejének adatait. (Öröklődés forrása Control) |
| SetRenderMethodDelegate(RenderMethod) |
Hozzárendel egy eseménykezelő delegáltat, hogy a kiszolgálóvezérlőt és annak tartalmát a szülővezérlőbe renderelje. (Öröklődés forrása Control) |
| SetTraceData(Object, Object, Object) |
Nyomkövetési adatokat állít be a renderelési adatok tervezési idejű nyomkövetéséhez a nyomkövetési objektum, a nyomkövetési adatkulcs és a nyomkövetési adatérték használatával. (Öröklődés forrása Control) |
| SetTraceData(Object, Object) |
Nyomkövetési adatokat állít be a renderelési adatok tervezési idejű nyomon követéséhez a nyomkövetési adatkulcs és a nyomkövetési adatérték használatával. (Öröklődés forrása Control) |
| ToString() |
Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object) |
| TrackViewState() |
Ez azt eredményezi, hogy a vezérlő nyomon követi a nézetállapot változásait, hogy azok az objektum ViewState tulajdonságában tárolhatók legyenek. (Öröklődés forrása WebControl) |
| Validate() |
Elvégzi az ellenőrzést a társított bemeneti vezérlőn, és frissíti a tulajdonságot IsValid . |
esemény
| Név | Description |
|---|---|
| DataBinding |
Akkor fordul elő, ha a kiszolgálóvezérlő egy adatforráshoz kapcsolódik. (Öröklődés forrása Control) |
| Disposed |
Akkor fordul elő, ha egy kiszolgálóvezérlő felszabadul a memóriából, amely a kiszolgálóvezérlő életciklusának utolsó szakasza, amikor egy ASP.NET lapot kérnek. (Öröklődés forrása Control) |
| Init |
A kiszolgálóvezérlő inicializálásakor következik be, amely az életciklus első lépése. (Öröklődés forrása Control) |
| Load |
Akkor fordul elő, ha a kiszolgálóvezérlő be van töltve az Page objektumba. (Öröklődés forrása Control) |
| PreRender |
Az objektum betöltése után Control , de a renderelés előtt következik be. (Öröklődés forrása Control) |
| Unload |
Akkor fordul elő, ha a kiszolgálóvezérlő ki van ürítve a memóriából. (Öröklődés forrása Control) |
Explicit interfész-implementációk
Bővítő metódusok
| Név | Description |
|---|---|
| FindDataSourceControl(Control) |
A megadott vezérlőhöz tartozó adatforrást adja vissza. |
| FindFieldTemplate(Control, String) |
Visszaadja a megadott oszlop mezősablonját a megadott vezérlő elnevezési tárolójában. |
| FindMetaTable(Control) |
Az adatvezérlő metatáblás objektumát adja vissza. |