Control Osztály

Definíció

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

Szerelvény:: System.Web.dll

Fontos

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

Meghatározza az összes ASP.NET kiszolgálóvezérlő által megosztott tulajdonságokat, metódusokat és eseményeket.

public ref class Control : IDisposable, System::ComponentModel::IComponent, System::Web::UI::IDataBindingsAccessor, System::Web::UI::IParserAccessor

public ref class Control : IDisposable, System::ComponentModel::IComponent, System::Web::UI::IControlBuilderAccessor, System::Web::UI::IControlDesignerAccessor, System::Web::UI::IDataBindingsAccessor, System::Web::UI::IExpressionsAccessor, System::Web::UI::IParserAccessor, System::Web::UI::IUrlResolutionService

public class Control : IDisposable, System.ComponentModel.IComponent, System.Web.UI.IDataBindingsAccessor, System.Web.UI.IParserAccessor

[System.ComponentModel.Bindable(true)]
[System.Web.UI.Themeable(false)]
public class Control : IDisposable, System.ComponentModel.IComponent, System.Web.UI.IControlBuilderAccessor, System.Web.UI.IControlDesignerAccessor, System.Web.UI.IDataBindingsAccessor, System.Web.UI.IExpressionsAccessor, System.Web.UI.IParserAccessor, System.Web.UI.IUrlResolutionService

type Control = class
    interface IComponent
    interface IDisposable
    interface IParserAccessor
    interface IDataBindingsAccessor

[<System.ComponentModel.Bindable(true)>]
[<System.Web.UI.Themeable(false)>]
type Control = class
    interface IComponent
    interface IDisposable
    interface IParserAccessor
    interface IUrlResolutionService
    interface IDataBindingsAccessor
    interface IControlBuilderAccessor
    interface IControlDesignerAccessor
    interface IExpressionsAccessor

Public Class Control
Implements IComponent, IDataBindingsAccessor, IDisposable, IParserAccessor

Public Class Control
Implements IComponent, IControlBuilderAccessor, IControlDesignerAccessor, IDataBindingsAccessor, IDisposable, IExpressionsAccessor, IParserAccessor, IUrlResolutionService

Öröklődés: Object
Control

Származtatott: System.Web.DynamicData.DynamicControl

System.Web.DynamicData.DynamicDataManager

System.Web.DynamicData.DynamicEntity

System.Web.DynamicData.DynamicFilter

System.Web.DynamicData.EntityTemplate

Tovább…

Attribútumok: BindableAttribute ThemeableAttribute

Megvalósítás: IComponent IDisposable IDataBindingsAccessor IParserAccessor IControlBuilderAccessor IControlDesignerAccessor IExpressionsAccessor IUrlResolutionService

Példák

Az alábbi példa egy egyéni kiszolgálóvezérlőt mutat be, amely az Control osztályból származik. Az InnerContent osztály felülbírálja a Control.Render metódust, ellenőrzi, hogy az osztály rendelkezik-e gyermekvezérlőkkel az oldalon, és meghatározza, hogy a vezérlő első gyermeke egy literál vezérlőelem-e. Ha mindkét feltétel teljesül, a felülírt metódus a H2<Your Message:, a literál vezérlőelem tartalmát és egy záró >/H2< címkét ír >a Webes űrlapok lapra.

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.

using System;
using System.Web;
using System.Web.UI;

namespace SimpleControlSamples {

    public class InnerContent : Control {
    [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="Execution")]
       protected override void Render(HtmlTextWriter output) {

           if ( (HasControls()) && (Controls[0] is LiteralControl) ) {
               output.Write("<H2>Your message : ");
               Controls[0].RenderControl(output);
               output.Write("</H2>");
           }
       }
    }
}

Option Explicit
Option Strict

Imports System.Web
Imports System.Web.UI

Namespace SimpleControlSamples
    Public Class InnerContent
        Inherits Control
        <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="Execution")> _
        Protected Overrides Sub Render(output As HtmlTextWriter)
            
            If HasControls() And TypeOf Controls(0) Is LiteralControl Then
                output.Write("<H2>Your message : ")
                Controls(0).RenderControl(output)
                output.Write("</H2>")
            End If
        End Sub
    End Class
End Namespace 'SimpleControlSamples

Megjegyzések

Ez az az elsődleges osztály, amely az egyéni ASP.NET kiszolgálóvezérlők fejlesztésekor származik. Control felhasználói felülettel (UI) nem rendelkezik. Ha olyan vezérlőt hoz létre, amely nem rendelkezik felhasználói felülettel, vagy olyan vezérlőket egyesít, amelyek saját felhasználói felületet jelenítenek meg, a következőből Controlszármazik: . Ha olyan vezérlőt hoz létre, amely rendelkezik felhasználói felülettel, a névtérből WebControl származó System.Web.UI.WebControls vagy bármely olyan vezérlőt hoz létre, amely megfelelő kiindulópontot biztosít az egyéni vezérlőhöz.

A Control osztály az összes ASP.NET kiszolgálóvezérlő alaposztálya, beleértve az egyéni vezérlőket, a felhasználói vezérlőket és a lapokat. ASP.NET lapok a Page osztály példányai, amelyek a Control osztálytól öröklődnek, és amelyek a .aspx kiterjesztésű fájlokra vonatkozó kérelmeket kezelik.

Az Control osztály közvetlenül vagy közvetve használható a webalkalmazás felhasználói felületének részeként, és ezért ellenőrizni kell, hogy a biztonságos kód írásához és az alkalmazások biztonságossá tételéhez ajánlott eljárások teljesülnek-e.

Ezekről a témakörökről általános információkért tekintse meg a webalkalmazások biztonsági fenyegetéseinek áttekintését, a biztonsági szabályzat ajánlott eljárásait és a legfontosabb biztonsági fogalmakat. További információ: Standard vezérlők biztonságossá tétele, Útmutató: Biztonságos hibaüzenetek megjelenítése, Hogyan: Védelem a szkriptek kihasználása ellen webalkalmazásokban HTML-kódolás alkalmazásával sztringekre, valamint bevezetés az érvényesítési vezérlőkbe.

Konstruktorok

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

Tulajdonságok

Name	Description
Adapter	Lekéri a vezérlő böngészőspecifikus adapterét.
AppRelativeTemplateSourceDirectory	Lekéri vagy beállítja a vezérlőt tartalmazó objektum Page alkalmazás-relatív virtuális könyvtárátUserControl.
BindingContainer	Lekéri a vezérlő adatkötését tartalmazó vezérlőt.
ChildControlsCreated	Beolvas egy értéket, amely jelzi, hogy a kiszolgálóvezérlő gyermekvezérlői létrejöttek-e.
ClientID	Lekéri a ASP.NET által létrehozott HTML-korrektúra vezérlőazonosítóját.
ClientIDMode	Lekéri vagy beállítja a tulajdonság értékének létrehozásához használt algoritmust ClientID .
ClientIDSeparator	Beolvas egy karakterértéket, amely a tulajdonságban használt elválasztó karaktert ClientID jelöli.
Context	Lekéri az HttpContext aktuális webkérelem kiszolgálóvezérlőjével társított objektumot.
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.
DataItemContainer	Az elnevezési tárolóra mutató hivatkozás lekérdezése, ha az elnevezési tároló implementálva van IDataItemContainer.
DataKeysContainer	Az elnevezési tárolóra mutató hivatkozás lekérdezése, ha az elnevezési tároló implementálva van IDataKeysControl.
DesignMode	Lekéri az értéket, amely jelzi, hogy egy vezérlőt használ-e a tervezőfelületen.
EnableTheming	Lekéri vagy beállít egy értéket, amely jelzi, hogy a témák vonatkoznak-e erre a vezérlőre.
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.
Events	Lekéri a vezérlő eseménykezelő delegáltjainak listáját. Ez a tulajdonság írásvédett.
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.
ID	Lekéri vagy beállítja a kiszolgálóvezérlőhöz rendelt programozott azonosítót.
IdSeparator	Lekéri a vezérlőazonosítók elválasztásához használt karaktert.
IsChildControlStateCleared	Beolvas egy értéket, amely jelzi, hogy a vezérlőben található vezérlők rendelkeznek-e vezérlőállapotmal.
IsTrackingViewState	Beolvas egy értéket, amely jelzi, hogy a kiszolgálóvezérlő menti-e a nézetállapot módosításait.
IsViewStateEnabled	Beolvas egy értéket, amely jelzi, hogy a nézet állapota engedélyezve van-e ehhez a vezérlőelemhez.
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.
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.
Page	A kiszolgálóvezérlőt tartalmazó példányra Page mutató hivatkozást kap.
Parent	Hivatkozás lekéri a kiszolgálóvezérlő szülővezérlőjét a lapvezérlő hierarchiájában.
RenderingCompatibility	Olyan értéket kap, amely meghatározza, hogy a HTML-renderelt ASP.NET verzió kompatibilis lesz-e.
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.
SkinID	Lekéri vagy beállítja a bőrt, hogy alkalmazza a vezérlőt.
TemplateControl	Lekéri vagy beállítja a vezérlőt tartalmazó sablonra mutató hivatkozást.
TemplateSourceDirectory	Lekéri az aktuális kiszolgálóvezérlő virtuális Page könyvtárátUserControl.
UniqueID	Lekéri a kiszolgálóvezérlő egyedi, hierarchikusan minősített azonosítót.
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.
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.
ViewStateIgnoresCase	Olyan értéket kap, amely jelzi, hogy az StateBag objektum kis- és nagybetűket nem érzékelyítő-e.
ViewStateMode	Lekéri vagy beállítja ennek a vezérlőelemnek a nézetállapot-módját.
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.

Metódusok

Name	Description
AddedControl(Control, Int32)	A rendszer meghívja, miután egy gyermekvezérlőt hozzáadtak az Controls Control objektum gyűjteményéhez.
AddParsedSubObject(Object)	Értesíti a kiszolgálóvezérlőt, hogy egy ELEM (XML vagy HTML) elemzése megtörtént, és hozzáadja az elemet a kiszolgálóvezérlő objektumához ControlCollection .
ApplyStyleSheetSkin(Page)	Alkalmazza a lapstíluslapon definiált stílustulajdonságokat a vezérlőelemre.
BeginRenderTracing(TextWriter, Object)	Megkezdi a renderelési adatok tervezési idejének nyomon követését.
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.
ClearCachedClientID()	A gyorsítótárazott ClientID érték beállítása a következőre `null`: .
ClearChildControlState()	Törli a kiszolgálóvezérlő gyermekvezérlőinek vezérlőállapot-adatait.
ClearChildState()	Törli a kiszolgálóvezérlő gyermekvezérlőinek nézetállapot- és vezérlőállapot-információit.
ClearChildViewState()	Törli a kiszolgálóvezérlő gyermekvezérlőinek nézetállapot-adatait.
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: .
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.
CreateControlCollection()	Létrehoz egy új ControlCollection objektumot a kiszolgálóvezérlő gyermekvezérlőinek (konstans és kiszolgáló) tárolásához.
DataBind()	Az adatforrást a meghívott kiszolgálóvezérlőhöz és annak összes gyermekvezérlőihez köti.
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.
DataBindChildren()	Adatforrás kötése a kiszolgálóvezérlő gyermekvezérlőihez.
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.
EndRenderTracing(TextWriter, Object)	Befejezi a renderelési adatok tervezési idejének nyomon követését.
EnsureChildControls()	Meghatározza, hogy a kiszolgálóvezérlő tartalmaz-e gyermekvezérlőket. Ha nem, gyermekvezérlőket hoz létre.
EnsureID()	Azonosítót hoz létre azokhoz a vezérlőkhöz, amelyekhez nincs hozzárendelve azonosító.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
FindControl(String, Int32)	Az aktuális elnevezési tárolóban keres egy kiszolgálóvezérlőt a megadott `id` és a paraméterben `pathOffset` megadott egész számmal, amely segíti a keresést. Nem bírálhatja felül a FindControl metódus ezen verzióját.
FindControl(String)	Az aktuális elnevezési tárolóban keres egy kiszolgálóvezérlőt a megadott `id` paraméterrel.
Focus()	Vezérlőre állítja a bemeneti fókuszt.
GetDesignModeState()	Lekéri a vezérlők tervezési idejének adatait.
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.
GetRouteUrl(RouteValueDictionary)	Lekéri az útvonalparamétereknek megfelelő URL-címet.
GetRouteUrl(String, Object)	Lekéri az útvonalparamétereknek és az útvonalnévnek megfelelő URL-címet.
GetRouteUrl(String, RouteValueDictionary)	Lekéri az útvonalparamétereknek és az útvonalnévnek megfelelő URL-címet.
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.
HasControls()	Meghatározza, hogy a kiszolgálóvezérlő tartalmaz-e gyermekvezérlőket.
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.
IsLiteralContent()	Meghatározza, hogy a kiszolgálóvezérlő csak literális tartalmat tartalmaz-e.
LoadControlState(Object)	Visszaállítja a vezérlőállapot adatait egy korábbi lapkérésből, amelyet a SaveControlState() metódus mentett.
LoadViewState(Object)	Visszaállítja a nézetállapot adatait egy korábbi oldalkérésből, amelyet a SaveViewState() metódus mentett.
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.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
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.
OnDataBinding(EventArgs)	Az eseményt emeli DataBinding ki.
OnInit(EventArgs)	Az eseményt emeli Init ki.
OnLoad(EventArgs)	Az eseményt emeli Load ki.
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.
RaiseBubbleEvent(Object, EventArgs)	Hozzárendeli az esemény minden forrását és információját a vezérlő szülőjének.
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.
Render(HtmlTextWriter)	Kiszolgálóvezérlési tartalmat küld egy megadott HtmlTextWriter objektumnak, amely megírja a megjelenítendő tartalmat az ügyfélen.
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.
RenderControl(HtmlTextWriter, ControlAdapter)	A kiszolgáló egy megadott objektum tartalmát egy megadott HtmlTextWriter ControlAdapter objektummal vezérli.
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.
ResolveAdapter()	Lekéri a megadott vezérlő megjelenítéséért felelős vezérlőadaptert.
ResolveClientUrl(String)	Lekéri a böngésző által használható URL-címet.
ResolveUrl(String)	Átalakít egy URL-címet a kérelmező ügyfélen használhatóvá.
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.
SaveViewState()	Menti azokat a kiszolgálóvezérlő nézetállapot-módosításokat, amelyek a lap kiszolgálóra való visszatérése óta történtek.
SetDesignModeState(IDictionary)	Beállítja a vezérlőelemek tervezési idejének adatait.
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.
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.
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.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)
TrackViewState()	A kiszolgálóvezérlő nézetállapot-változásainak nyomon követését okozza, hogy azok a kiszolgálóvezérlő StateBag objektumában tárolhatók legyenek. Ez az objektum a ViewState tulajdonságon keresztül érhető el.

esemény

Name	Description
DataBinding	Akkor fordul elő, ha a kiszolgálóvezérlő egy adatforráshoz kapcsolódik.
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.
Init	A kiszolgálóvezérlő inicializálásakor következik be, amely az életciklus első lépése.
Load	Akkor fordul elő, ha a kiszolgálóvezérlő be van töltve az Page objektumba.
PreRender	Az objektum betöltése után Control , de a renderelés előtt következik be.
Unload	Akkor fordul elő, ha a kiszolgálóvezérlő ki van ürítve a memóriából.

Explicit interfész-implementációk

Name	Description
IControlBuilderAccessor.ControlBuilder	Ennek a tagnak a leírását lásd ControlBuilder: .
IControlDesignerAccessor.GetDesignModeState()	Ennek a tagnak a leírását lásd GetDesignModeState(): .
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Ennek a tagnak a leírását lásd SetDesignModeState(IDictionary): .
IControlDesignerAccessor.SetOwnerControl(Control)	Ennek a tagnak a leírását lásd SetOwnerControl(Control): .
IControlDesignerAccessor.UserData	Ennek a tagnak a leírását lásd UserData: .
IDataBindingsAccessor.DataBindings	Ennek a tagnak a leírását lásd DataBindings: .
IDataBindingsAccessor.HasDataBindings	Ennek a tagnak a leírását lásd HasDataBindings: .
IExpressionsAccessor.Expressions	Ennek a tagnak a leírását lásd Expressions: .
IExpressionsAccessor.HasExpressions	Ennek a tagnak a leírását lásd HasExpressions: .
IParserAccessor.AddParsedSubObject(Object)	Ennek a tagnak a leírását lásd AddParsedSubObject(Object): .

Bővítő metódusok

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

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?