Control Třída

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 sdílené 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. InnerContent Třída přepíše metoduControl.Render, zkontroluje, zda třída má 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ý ovládací prvek. Pokud jsou splněny obě tyto podmínky, přepsaná metoda zapíše řetězec <HTML H2>Vaše zpráva:, obsah literálového ovládacího prvku a pravou <značku /H2> na stránku Webových formulářů.

Important

Tento příklad obsahuje textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že vstup uživatele neobsahuje skripty ani elementy HTML. Další informace naleznete v tématu 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, kterou odvozujete při vývoji vlastních ovládacích prvků serveru ASP.NET. Control nemá žádné funkce specifické pro uživatelské rozhraní. Pokud vytváříte ovládací prvek, který nemá uživatelské rozhraní, nebo kombinuje jiné ovládací prvky, které vykreslují vlastní uživatelské rozhraní, odvozené od Control. Pokud vytváříte ovládací prvek, který má uživatelské rozhraní, odvozujte z WebControl oboru názvů nebo jakýkoli ovládací prvek System.Web.UI.WebControls , který poskytuje vhodný výchozí bod pro vlastní ovládací prvek.

Třída Control je základní třídou pro všechny ovládací prvky serveru ASP.NET, včetně vlastních ovládacích prvků, uživatelských ovládacích prvků a stránek. ASP.NET stránky jsou instance třídy Page, která dědí z třídy Control 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í webové aplikace, a proto je třeba pečlivě prověřovat, aby se zajistilo, že budou 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ématu Přehled hrozeb zabezpečení webových aplikací, osvědčených postupů zásad zabezpečení a klíčových konceptů zabezpečení. Konkrétnější informace naleznete v tématu 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

Name	Description
Control()	Inicializuje novou instanci Control třídy.

Vlastnosti

Name	Description
Adapter	Získá adaptér specifický pro prohlížeč pro ovládací prvek.
AppRelativeTemplateSourceDirectory	Získá nebo nastaví relativní virtuální adresář Page aplikace nebo UserControl objektu, který obsahuje tento ovládací prvek.
BindingContainer	Získá ovládací prvek, který obsahuje datovou vazbu tohoto ovládacího prvku.
ChildControlsCreated	Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky ovládacího prvku serveru.
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í oddělovač znak 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ý server ovládací prvek v hierarchii uživatelského rozhraní.
DataItemContainer	Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataItemContainer.
DataKeysContainer	Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataKeysControl.
DesignMode	Získá hodnotu určující, zda se ovládací prvek používá na návrhové ploše.
EnableTheming	Získá nebo nastaví hodnotu označující, zda motivy platí pro tento ovládací prvek.
EnableViewState	Získá nebo nastaví hodnotu určující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, do žádajícího klienta.
Events	Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je pouze pro čtení.
HasChildViewState	Získá hodnotu určující, zda aktuální serverový ovládací prvky podřízené ovládací prvky mají jakékoli uložené nastavení stavu zobrazení.
ID	Získá nebo nastaví programový identifikátor přiřazený ovládacímu prvku serveru.
IdSeparator	Získá znak použitý k oddělení identifikátorů ovládacích prvků.
IsChildControlStateCleared	Získá hodnotu určující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav ovládacího prvku.
IsTrackingViewState	Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do jeho stavu zobrazení.
IsViewStateEnabled	Získá hodnotu označující, zda je pro tento ovládací prvek povolen stav zobrazení.
LoadViewStateByID	Získá hodnotu určující, zda se ovládací prvek účastní načítání jeho stavu zobrazení namísto ID indexu.
NamingContainer	Získá odkaz na kontejner pojmenování ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro odlišné mezi serverovými ovládacími prvky 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 ovládacího prvku serveru v hierarchii ovládacích prvků stránky.
RenderingCompatibility	Získá hodnotu, která určuje ASP.NET verzi, která vykreslený KÓD 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í kůži, která se použije na ovládací prvek.
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í server řízení.
UniqueID	Získá jedinečný hierarchicky kvalifikovaný identifikátor pro ovládací prvek serveru.
ValidateRequestMode	Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek kontroluje vstup klienta z prohlížeče pro potenciálně nebezpečné hodnoty.
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení ovládacího prvku serveru napříč několika požadavky na stejnou stránku.
ViewStateIgnoresCase	Získá hodnotu, která určuje, zda StateBag objekt nerozlišuje malá a velká písmena.
ViewStateMode	Získá nebo nastaví režim zobrazení-stav tohoto ovládacího prvku.
Visible	Získá nebo nastaví hodnotu, která určuje, zda je serverový ovládací prvek vykreslen jako uživatelské rozhraní na stránce.

Metody

Name	Description
AddedControl(Control, Int32)	Volá se po přidání podřízeného ovládacího prvku do Controls kolekce objektu Control .
AddParsedSubObject(Object)	Upozorní serverový ovládací prvek, že byl analyzován element XML nebo HTML a přidá prvek do objektu ControlCollection ovládacího prvku serveru.
ApplyStyleSheetSkin(Page)	Použije vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek.
BeginRenderTracing(TextWriter, Object)	Začíná trasování doby návrhu vykreslovacích dat.
BuildProfileTree(String, Boolean)	Shromažďuje informace o ovládacím prvku serveru a doručuje ho Trace vlastnosti, která se má zobrazit při povolení trasování stránky.
ClearCachedClientID()	Nastaví hodnotu uloženou ClientID v mezipaměti na `null`hodnotu .
ClearChildControlState()	Odstraní informace o stavu řízení pro podřízené ovládací prvky ovládacího prvku serveru.
ClearChildState()	Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky ovládacího prvku serveru.
ClearChildViewState()	Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky ovládacího prvku serveru.
ClearEffectiveClientIDMode()	ClientIDMode Nastaví vlastnost aktuální instance ovládacího prvku a všech podřízených ovládacích prvků na Inherit.
CreateChildControls()	Volal ASP.NET stránkovací rámec, který informuje serverové ovládací prvky, které používají implementaci založenou na složení k vytvoření podřízených ovládacích prvků, které obsahují při přípravě na publikování zpět nebo vykreslování.
CreateControlCollection()	Vytvoří nový ControlCollection objekt pro uložení podřízených ovládacích prvků (literálu i serveru) ovládacího prvku serveru.
DataBind()	Vytvoří vazbu zdroje dat na vyvolaný ovládací prvek serveru a všechny jeho podřízené ovládací prvky.
DataBind(Boolean)	Vytvoří vazbu zdroje dat na vyvolaný serverový ovládací prvek a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost.
DataBindChildren()	Vytvoří vazbu zdroje dat k podřízeným ovládacím prvkům ovládacího prvku 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í vykreslování dat v době návrhu.
EnsureChildControls()	Určuje, zda ovládací prvek serveru 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čuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
FindControl(String, Int32)	Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným `id` a celé číslo zadané v parametru `pathOffset` , který pomáhá při hledání. Tuto verzi FindControl metody byste neměli přepsat.
FindControl(String)	Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným `id` parametrem.
Focus()	Nastaví vstupní fokus na ovládací prvek.
GetDesignModeState()	Získá data v době návrhu pro ovládací prvek.
GetHashCode()	Slouží jako výchozí funkce hash. (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ázvu trasy.
GetRouteUrl(String, RouteValueDictionary)	Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
GetUniqueIDRelativeTo(Control)	Vrátí předponu části UniqueID vlastnosti zadaného ovládacího prvku.
HasControls()	Určuje, zda serverový ovládací prvek obsahuje jakékoli podřízené ovládací prvky.
HasEvents()	Vrátí hodnotu určující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky.
IsLiteralContent()	Určuje, zda ovládací prvek serveru obsahuje pouze literálový obsah.
LoadControlState(Object)	Obnoví informace o stavu řízení z předchozího požadavku na stránku, který byla uložena metodou SaveControlState() .
LoadViewState(Object)	Obnoví informace o stavu zobrazení z předchozí žádosti o stránku, která byla uložena 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 Object. (Zděděno od Object)
OnBubbleEvent(Object, EventArgs)	Určuje, zda je událost pro ovládací prvek serveru předána hierarchii ovládacích prvků uživatelského rozhraní stránky.
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žité ke čtení souboru.
RaiseBubbleEvent(Object, EventArgs)	Přiřadí všechny zdroje události a její informace nadřazené ovládacího prvku.
RemovedControl(Control)	Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control .
Render(HtmlTextWriter)	Odešle obsah ovládacího prvku serveru do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi.
RenderChildren(HtmlTextWriter)	Vypíše obsah podřízených položek ovládacího prvku serveru do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi.
RenderControl(HtmlTextWriter, ControlAdapter)	Výstupy obsahu ovládacího prvku serveru do poskytnutého HtmlTextWriter objektu pomocí poskytnutého ControlAdapter objektu.
RenderControl(HtmlTextWriter)	Výstupy obsahu ovládacího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je povoleno trasování.
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 může prohlížeč používat.
ResolveUrl(String)	Převede adresu URL na adresu URL, která je použitelná u žádajícího klienta.
SaveControlState()	Uloží všechny změny stavu řízení serveru, ke kterým došlo od doby, kdy byla stránka odeslána zpět na server.
SaveViewState()	Uloží všechny změny stavu zobrazení serveru, ke kterým došlo od doby, kdy byla stránka odeslána zpět na server.
SetDesignModeState(IDictionary)	Nastaví data návrhu pro ovládací prvek.
SetRenderMethodDelegate(RenderMethod)	Přiřadí delegáta obslužné rutiny události k vykreslení ovládacího prvku serveru a jeho obsahu do nadřazeného ovládacího prvku.
SetTraceData(Object, Object, Object)	Nastaví trasovací data pro trasování doby návrhu vykreslovacích dat pomocí trasovaného objektu, klíče dat trasování a hodnoty dat trasování.
SetTraceData(Object, Object)	Nastaví data trasování pro trasování vykreslování dat v době návrhu pomocí klíče dat trasování a hodnoty dat trasování.
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 je bylo možné uložit do objektu StateBag ovládacího prvku serveru. Tento objekt je přístupný prostřednictvím ViewState vlastnosti.

Událost

Name	Description
DataBinding	Nastane, když ovládací prvek serveru vytvoří vazbu ke zdroji dat.
Disposed	Nastane, když je serverový ovládací prvek uvolněn z paměti, což je poslední fáze životního cyklu řízení serveru při vyžádání ASP.NET stránky.
Init	Nastane při inicializaci ovládacího prvku serveru, což je první krok v jeho životním cyklu.
Load	Nastane, když je serverový ovládací prvek načten do objektu Page .
PreRender	Nastane po načtení objektu Control , ale před vykreslením.
Unload	Nastane, když je serverový ovládací prvek uvolněn z paměti.

Explicitní implementace rozhraní

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

Metody rozšíření

Name	Description
FindDataSourceControl(Control)	Vrátí zdroj dat přidružený k ovládacímu prvku dat pro zadaný ovládací prvek.
FindFieldTemplate(Control, String)	Vrátí šablonu pole pro zadaný sloupec v kontejneru pojmenování zadaného ovládacího prvku.
FindMetaTable(Control)	Vrátí objekt metatable pro ovládací prvek obsahující data.

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?