Control Třída

Reference

Definice

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

Sestavení:: System.Web.dll

Důležité

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

Definuje vlastnosti, metody a události, které jsou sdíleny všemi ovládacími prvky serveru ASP.NET.

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

Dědičnost: Object
Control

Odvozené: System.Web.DynamicData.DynamicControl

System.Web.DynamicData.DynamicDataManager

System.Web.DynamicData.DynamicEntity

System.Web.DynamicData.DynamicFilter

System.Web.DynamicData.EntityTemplate

Více…

Atributy: BindableAttribute ThemeableAttribute

Implementuje: IComponent IDisposable IDataBindingsAccessor IParserAccessor IControlBuilderAccessor IControlDesignerAccessor IExpressionsAccessor IUrlResolutionService

Příklady

Následující příklad ukazuje vlastní serverový ovládací prvek, který je odvozen z Control třídy . Třída InnerContent přepíše metodu Control.Render , zkontroluje, zda má třída na stránce nějaké podřízené ovládací prvky a určuje, zda první podřízený ovládací prvek ovládacího prvku je literálový. Pokud jsou splněny obě tyto podmínky, přepsaná metoda zapíše řetězec <HTML H2>Vaše zpráva:, obsah ovládacího prvku literálu a pravou <značku /H2> na stránku webové formuláře.

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ů.

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

Poznámky

Toto je primární třída, ze které vycházíte při vývoji vlastních ASP.NET serverových ovládacích prvků. Control nemá žádné funkce specifické pro uživatelské rozhraní. Pokud vytváříte ovládací prvek, který nemá uživatelské rozhraní, nebo kombinujete jiné ovládací prvky, které vykreslují vlastní uživatelské rozhraní, odvozené z Control. Pokud vytváříte ovládací prvek, který má uživatelské rozhraní, odvozujte z WebControl nebo jakýkoli ovládací prvek v System.Web.UI.WebControls oboru názvů, který poskytuje vhodný výchozí bod pro vlastní ovládací prvek.

Třída Control je základní třídou pro všechny ASP.NET serverové ovládací prvky, včetně vlastních ovládacích prvků, uživatelských ovládacích prvků a stránek. ASP.NET stránky jsou instance Page třídy, která dědí z Control třídy a zpracovávají požadavky na soubory, které mají příponu .aspx.

Třída Control může být přímo nebo nepřímo použita jako součást uživatelského rozhraní pro webovou aplikaci a jako taková by měla být prověřena, aby se zajistilo, že jsou dodrženy osvědčené postupy pro psaní zabezpečeného kódu a zabezpečení aplikací.

Obecné informace o těchto tématech najdete v tématech Přehled hrozeb zabezpečení webových aplikací, Osvědčené postupy pro zásady zabezpečení a Klíčové koncepty zabezpečení. Podrobnější informace najdete v tématech Zabezpečení standardních ovládacích prvků, Postupy: Zobrazení bezpečných chybových zpráv, Postupy: Ochrana před zneužitím skriptů ve webové aplikaci použitím kódování HTML u řetězců a Úvod do ověřovacích ovládacích prvků.

Konstruktory

Control()

Inicializuje novou instanci Control třídy .

Vlastnosti

Adapter	Získá adaptér specifické pro prohlížeč pro ovládací prvek.
AppRelativeTemplateSourceDirectory	Získá nebo nastaví aplikaci relativní virtuální adresář nebo UserControl objektuPage, který obsahuje tento ovládací prvek.
BindingContainer	Získá ovládací prvek, který obsahuje datové vazby tohoto ovládacího prvku.
ChildControlsCreated	Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky serverového ovládacího prvku.
ClientID	Získá ID ovládacího prvku pro kód HTML, který je generován ASP.NET.
ClientIDMode	Získá nebo nastaví algoritmus, který se používá k vygenerování hodnoty ClientID vlastnosti.
ClientIDSeparator	Získá hodnotu znaku představující znak oddělovače použitý ve ClientID vlastnosti .
Context	HttpContext Získá objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek.
Controls	ControlCollection Získá objekt, který představuje podřízené ovládací prvky pro zadaný serverový ovládací prvek v hierarchii uživatelského rozhraní.
DataItemContainer	Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataItemContainer.
DataKeysContainer	Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataKeysControl.
DesignMode	Získá hodnotu označující, zda je ovládací prvek použit na návrhové ploše.
EnableTheming	Získá nebo nastaví hodnotu označující, zda motivy použít pro tento ovládací prvek.
EnableViewState	Získá nebo nastaví hodnotu označ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.
Events	Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen ke čtení.
HasChildViewState	Získá hodnotu označující, zda podřízené ovládací prvky aktuálního serveru mají nějaké uložené nastavení stavu zobrazení.
ID	Získá nebo nastaví programový identifikátor přiřazený k ovládacímu prvku serveru.
IdSeparator	Získá znak použitý k oddělení identifikátorů ovládacích prvků.
IsChildControlStateCleared	Získá hodnotu označující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav řízení.
IsTrackingViewState	Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do stavu zobrazení.
IsViewStateEnabled	Získá hodnotu označující, zda je stav zobrazení povolen pro tento ovládací prvek.
LoadViewStateByID	Získá hodnotu označující, zda se ovládací prvek účastní načítání stavu zobrazení namísto ID indexu.
NamingContainer	Získá odkaz na názvový kontejner serverového ovládacího prvku, který vytvoří jedinečný obor názvů pro odlizení mezi ovládacími prvky serveru se stejnou ID hodnotou vlastnosti.
Page	Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek.
Parent	Získá odkaz na nadřazený ovládací prvek serveru v hierarchii ovládacích prvků stránky.
RenderingCompatibility	Získá hodnotu, která určuje ASP.NET verze, která vykreslovala HTML bude kompatibilní s.
Site	Získá informace o kontejneru, který je hostitelem aktuálního ovládacího prvku při vykreslení na návrhové ploše.
SkinID	Získá nebo nastaví vzhled pro použití ovládacího prvku.
TemplateControl	Získá nebo nastaví odkaz na šablonu, která obsahuje tento ovládací prvek.
TemplateSourceDirectory	Získá virtuální adresář Page nebo UserControl , který obsahuje aktuální serverový ovládací prvek.
UniqueID	Získá jedinečný hierarchicky kvalifikovaný identifikátor serverového ovládacího prvku.
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.
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.
ViewStateIgnoresCase	Získá hodnotu, která označuje, zda StateBag objekt nerozlišuje malá a velká písmena.
ViewStateMode	Získá nebo nastaví režim zobrazení stavu tohoto ovládacího prvku.
Visible	Získá nebo nastaví hodnotu, která označuje, zda je serverový ovládací prvek vykreslen jako uživatelské rozhraní na stránce.

Metody

AddedControl(Control, Int32)	Volá se po přidání podřízeného ovládacího prvku do Controls kolekce objektu Control .
AddParsedSubObject(Object)	Upozorní ovládací prvek serveru, že byl analyzován element XML nebo HTML, a přidá element do objektu serverového ControlCollection ovládacího prvku.
ApplyStyleSheetSkin(Page)	Použije na ovládací prvek vlastnosti stylu definované v šabloně stylů stránky.
BeginRenderTracing(TextWriter, Object)	Začíná trasování vykreslovaných dat v době návrhu.
BuildProfileTree(String, Boolean)	Shromáždí informace o serverovém ovládacím prvku a předá je vlastnosti Trace , která se má zobrazit, když je pro stránku povoleno trasování.
ClearCachedClientID()	Nastaví hodnotu v ClientID mezipaměti na `null`.
ClearChildControlState()	Odstraní informace o stavu ovládacího prvku pro podřízené ovládací prvky serveru.
ClearChildState()	Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky serveru.
ClearChildViewState()	Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky serveru.
ClearEffectiveClientIDMode()	ClientIDMode Nastaví vlastnost instance aktuálního ovládacího prvku a všech podřízených ovládacích prvků na Inherit.
CreateChildControls()	Volána rozhraním ASP.NET stránky k upozornění serverových ovládacích prvků, 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 zaúčtování zpět nebo vykreslení.
CreateControlCollection()	Vytvoří nový ControlCollection objekt, který bude obsahovat podřízené ovládací prvky (literál i server) serverového ovládacího prvku.
DataBind()	Vytvoří vazbu zdroje dat na vyvolaný serverový ovládací prvek a všechny jeho podřízené ovládací prvky.
DataBind(Boolean)	Vytvoří vazbu zdroje dat na vyvolaný ovládací prvek serveru a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost.
DataBindChildren()	Vytvoří vazbu zdroje dat na podřízené ovládací prvky serveru.
Dispose()	Umožňuje ovládacímu prvku serveru provést konečné vyčištění před uvolněním z paměti.
EndRenderTracing(TextWriter, Object)	Ukončí trasování doby návrhu vykreslovaných dat.
EnsureChildControls()	Určuje, zda serverový ovládací prvek obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky.
EnsureID()	Vytvoří identifikátor pro ovládací prvky, které nemají přiřazený identifikátor.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
FindControl(String)	Vyhledá v aktuálním názvovém kontejneru serverový ovládací prvek se zadaným `id` parametrem.
FindControl(String, Int32)	Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek se zadaným `id` a celočíselným číslem zadaným v parametru `pathOffset` , což pomáhá při hledání. Tuto verzi metody byste neměli FindControl přepsat.
Focus()	Nastaví fokus vstupu na ovládací prvek.
GetDesignModeState()	Získá data v době návrhu pro ovládací prvek.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetRouteUrl(Object)	Získá adresu URL, která odpovídá sadě parametrů trasy.
GetRouteUrl(RouteValueDictionary)	Získá adresu URL, která odpovídá sadě parametrů trasy.
GetRouteUrl(String, Object)	Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy.
GetRouteUrl(String, RouteValueDictionary)	Získá adresu URL, která odpovídá sadě parametrů trasy a název trasy.
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
GetUniqueIDRelativeTo(Control)	Vrátí část UniqueID vlastnosti zadaného ovládacího prvku s předponou.
HasControls()	Určuje, zda serverový ovládací prvek obsahuje nějaké podřízené ovládací prvky.
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.
IsLiteralContent()	Určuje, zda serverový ovládací prvek obsahuje pouze obsah literálu.
LoadControlState(Object)	Obnoví informace o stavu řízení z předchozího požadavku stránky, který byl uložen metodou SaveControlState() .
LoadViewState(Object)	Obnoví informace o stavu zobrazení z předchozího požadavku stránky, který byl uložen metodou SaveViewState() .
MapPathSecure(String)	Načte fyzickou cestu, na kterou se mapuje virtuální cesta, absolutní nebo relativní.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnBubbleEvent(Object, EventArgs)	Určuje, zda je událost serverového ovládacího prvku předána hierarchii serveru uživatelského rozhraní stránky.
OnDataBinding(EventArgs)	DataBinding Vyvolá událost.
OnInit(EventArgs)	Init Vyvolá událost.
OnLoad(EventArgs)	Load Vyvolá událost.
OnPreRender(EventArgs)	PreRender Vyvolá událost.
OnUnload(EventArgs)	Unload Vyvolá událost.
OpenFile(String)	Stream Získá používá ke čtení souboru.
RaiseBubbleEvent(Object, EventArgs)	Přiřadí všechny zdroje události a její informace nadřazené ovládacímu prvku.
RemovedControl(Control)	Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control .
Render(HtmlTextWriter)	Odesílá obsah řízení serveru do zadaného HtmlTextWriter objektu, který zapisuje obsah, který se má vykreslit na klientovi.
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 na klientovi.
RenderControl(HtmlTextWriter)	Vypíše obsah ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povoleno.
RenderControl(HtmlTextWriter, ControlAdapter)	Vypíše obsah řízení serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu.
ResolveAdapter()	Získá adaptér ovládacího prvku zodpovědný za vykreslení zadaného ovládacího prvku.
ResolveClientUrl(String)	Získá adresu URL, kterou lze použít v prohlížeči.
ResolveUrl(String)	Převede adresu URL na adresu URL, která je použitelná v žádajícím klientovi.
SaveControlState()	Uloží všechny změny stavu ovládacích prvků serveru, ke kterým došlo od okamžiku, kdy byla stránka odeslána zpět na server.
SaveViewState()	Uloží všechny změny stavu zobrazení ovládacích prvků serveru, ke kterým došlo od okamžiku, kdy byla stránka odeslána zpět na server.
SetDesignModeState(IDictionary)	Nastaví data v době návrhu ovládacího prvku.
SetRenderMethodDelegate(RenderMethod)	Přiřadí delegáta obslužné rutiny události pro vykreslení serverového ovládacího prvku a jeho obsahu do nadřazeného ovládacího prvku.
SetTraceData(Object, Object)	Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí datového klíče trasování a hodnoty dat trasování.
SetTraceData(Object, Object, Object)	Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí trasovaného objektu, datového klíče trasování a hodnoty dat trasování.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TrackViewState()	Způsobí sledování změn stavu zobrazení v ovládacím prvku serveru, aby mohly být uloženy v objektu ovládacího prvku StateBag serveru. Tento objekt je přístupný prostřednictvím ViewState vlastnosti .

Událost

DataBinding	Vyvolá se při vytvoření vazby serverového ovládacího prvku na zdroj dat.
Disposed	Vyvolá se 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 ASP.NET stránka.
Init	Vyvolá se při inicializaci serverového ovládacího prvku, což je první krok v jeho životním cyklu.
Load	Vyvolá se při načtení serverového ovládacího prvku do objektu Page .
PreRender	Vyvolá se po načtení objektu Control , ale před vykreslením.
Unload	Vyvolá se při uvolnění serverového ovládacího prvku z paměti.

Explicitní implementace rozhraní

IControlBuilderAccessor.ControlBuilder	Popis tohoto člena najdete v tématu ControlBuilder.
IControlDesignerAccessor.GetDesignModeState()	Popis tohoto člena najdete v tématu GetDesignModeState().
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Popis tohoto člena najdete v tématu SetDesignModeState(IDictionary).
IControlDesignerAccessor.SetOwnerControl(Control)	Popis tohoto člena najdete v tématu SetOwnerControl(Control).
IControlDesignerAccessor.UserData	Popis tohoto člena najdete v tématu UserData.
IDataBindingsAccessor.DataBindings	Popis tohoto člena najdete v tématu DataBindings.
IDataBindingsAccessor.HasDataBindings	Popis tohoto člena najdete v tématu HasDataBindings.
IExpressionsAccessor.Expressions	Popis tohoto člena najdete v tématu Expressions.
IExpressionsAccessor.HasExpressions	Popis tohoto člena najdete v tématu HasExpressions.
IParserAccessor.AddParsedSubObject(Object)	Popis tohoto člena najdete v tématu AddParsedSubObject(Object).

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

Sdílet prostřednictvím