LiteralControl Třída

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Představuje prvky HTML, text a všechny další řetězce na ASP.NET stránce, které nevyžadují zpracování na serveru.

public ref class LiteralControl : System::Web::UI::Control, System::Web::UI::ITextControl

public class LiteralControl : System.Web.UI.Control, System.Web.UI.ITextControl

type LiteralControl = class
    inherit Control
    interface ITextControl

Public Class LiteralControl
Inherits Control
Implements ITextControl

Dědičnost

Object

Control

LiteralControl

Implementuje

ITextControl

Příklady

Následující příklad kódu ukazuje, jak použít přetížený LiteralControl konstruktor při přepsání Control.CreateChildControls metody. Kód přidá dva nové LiteralControl objekty a ovládací prvek webového TextBox serveru do vlastnosti aktuálního serverového Control.Controls ovládacího prvku.

// Add two LiteralControls that render HTML H3 elements and text.
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")] 
protected override void CreateChildControls() {

    this.Controls.Add(new LiteralControl("<h3>Value: "));

    TextBox box = new TextBox();
    box.Text = "0";
    this.Controls.Add(box);

    this.Controls.Add(new LiteralControl("</h3>"));
}

' Add two LiteralControls that render HTML H3 elements and text.
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub CreateChildControls()

    Me.Controls.Add(New LiteralControl("<h3>Value: "))

    Dim Box As New TextBox
    Box.Text = "0"
    Me.Controls.Add(box)

    Me.Controls.Add(New LiteralControl("</h3>"))
End Sub

Poznámky

ASP.NET zkompiluje všechny prvky HTML a čitelný text, které nevyžadují zpracování na straně serveru, do instancí této třídy. Například element HTML, který neobsahuje pár atribut/ runat="server" hodnota ve své počáteční značce je zkompilován do objektu LiteralControl . LiteralControl objekty neudržují stav zobrazení, takže obsah objektu LiteralControl musí být při každém požadavku znovu vytvořena.

Ovládací prvky literálu se chovají jako držitelé textu, což znamená, že můžete extrahovat text z ovládacího prvku literálu a odebrat ovládací prvek literálu z kolekce nadřazeného serverového ControlCollection ovládacího prvku prostřednictvím nadřazené Controls vlastnosti. Proto při vývoji vlastního ovládacího prvku odvozeného z LiteralControl třídy, ujistěte se, že ovládací prvek provádí všechny požadované kroky předběžného zpracování sám, místo použití volání LiteralControl.Render metody k jejich provedení. Obvykle byste to udělali za účelem zlepšení doby odezvy vaší webové aplikace.

Ovládací prvky literálů můžete přidávat nebo odebírat z ovládacího prvku stránky nebo serveru programově pomocí ControlCollection.Add metody nebo ControlCollection.Remove .

Konstruktory

LiteralControl()	Inicializuje novou instanci LiteralControl třídy, která obsahuje řetězec literálu, který má být vykreslen na požadované ASP.NET stránce.
LiteralControl(String)	Inicializuje novou instanci LiteralControl třídy se zadaným textem.

Vlastnosti

Adapter	Získá adaptér specifické pro prohlížeč pro ovládací prvek. (Zděděno od Control)
AppRelativeTemplateSourceDirectory	Získá nebo nastaví aplikaci relativní virtuální adresář nebo UserControl objektuPage, který obsahuje tento ovládací prvek. (Zděděno od Control)
BindingContainer	Získá ovládací prvek, který obsahuje datové vazby tohoto ovládacího prvku. (Zděděno od Control)
ChildControlsCreated	Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky serverového ovládacího prvku. (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ý serverový ovládací prvek v hierarchii uživatelského rozhraní. (Zděděno od Control)
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)
EnableTheming	Získá nebo nastaví hodnotu označující, zda motivy použít pro tento ovládací prvek. (Zděděno od Control)
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. (Zděděno od Control)
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)
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í. (Zděděno od Control)
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)
IsTrackingViewState	Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do stavu zobrazení. (Zděděno od Control)
IsViewStateEnabled	Získá hodnotu označující, zda je stav zobrazení povolen pro tento ovládací prvek. (Zděděno od Control)
LoadViewStateByID	Získá hodnotu označující, zda se ovládací prvek účastní načítání stavu zobrazení namísto ID indexu. (Zděděno od Control)
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. (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 nadřazený ovládací prvek serveru v hierarchii ovládacích prvků stránky. (Zděděno od Control)
RenderingCompatibility	Získá hodnotu, která určuje ASP.NET verze, která vykreslovala HTML bude kompatibilní s. (Zděděno od Control)
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í kůži na ovládací prvek. (Zděděno od Control)
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í server ovládací prvek. (Zděděno od Control)
Text	Získá nebo nastaví textový obsah objektu LiteralControl .
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)
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení serverového ovládacího prvku napříč několika požadavky na stejnou stránku. (Zděděno od Control)
ViewStateIgnoresCase	Získá hodnotu, která označuje, zda StateBag objekt nerozlišuje velká a malá 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 serverový ovládací prvek je vykreslen jako uživatelské rozhraní na stránce. (Zděděno od Control)

Metody

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)	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. (Zděděno od Control)
ApplyStyleSheetSkin(Page)	Použije na ovládací prvek vlastnosti stylu definované v šabloně stylů stránky. (Zděděno od Control)
BeginRenderTracing(TextWriter, Object)	Začíná trasování vykreslovaných dat v době návrhu. (Zděděno od Control)
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í. (Zděděno od Control)
ClearCachedClientID()	Nastaví hodnotu v ClientID mezipaměti na null. (Zděděno od Control)
ClearChildControlState()	Odstraní informace o stavu ovládacího prvku 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í pro všechny podřízené ovládací prvky serveru. (Zděděno od Control)
ClearEffectiveClientIDMode()	ClientIDMode Nastaví vlastnost instance aktuálního ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control)
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í. (Zděděno od Control)
CreateControlCollection()	EmptyControlCollection Vytvoří objekt pro aktuální instanci LiteralControl třídy.
DataBind()	Vytvoří vazbu zdroje dat na vyvolaný 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 vyvolaný ovládací prvek serveru a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost. (Zděděno od Control)
DataBindChildren()	Vytvoří vazbu zdroje dat na podřízené ovládací prvky serveru. (Zděděno od Control)
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í doby návrhu vykreslovaných dat. (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 pro ovládací prvky, 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)
FindControl(String)	Vyhledá v aktuálním názvovém kontejneru serverový ovládací prvek se zadaným id parametrem. (Zděděno od Control)
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. (Zděděno od Control)
Focus()	Nastaví fokus vstupu na ovládací prvek. (Zděděno od Control)
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()	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. (Zděděno od Control)
HasControls()	Určuje, zda 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, zda 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)	Obnoví informace o stavu zobrazení z předchozího požadavku stránky, který byl uložen metodou SaveViewState() . (Zděděno od Control)
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)
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. (Zděděno od Control)
OnDataBinding(EventArgs)	DataBinding Vyvolá událost. (Zděděno od Control)
OnInit(EventArgs)	Init Vyvolá událost. (Zděděno od Control)
OnLoad(EventArgs)	Load Vyvolá událost. (Zděděno od Control)
OnPreRender(EventArgs)	PreRender Vyvolá událost. (Zděděno od Control)
OnUnload(EventArgs)	Unload Vyvolá událost. (Zděděno od Control)
OpenFile(String)	Stream Získá používá 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)
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)	Zapíše obsah objektu LiteralControl na stránku ASP.NET.
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. (Zděděno od Control)
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. (Zděděno od Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Vypíše obsah řízení serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu. (Zděděno od Control)
ResolveAdapter()	Získá adaptér ovládacího prvku 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ích prvků 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 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. (Zděděno od Control)
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 pro vykreslení serverového ovládacího prvku a jeho obsahu 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í datového klíče 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í sledování změn stavu zobrazení serverového ovládacího prvku, aby mohly být uloženy v objektu ovládacího prvku StateBag serveru. Tento objekt je přístupný prostřednictvím ViewState vlastnosti. (Zděděno od Control)

Událost

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

Explicitní implementace rozhraní

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

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.

Viz také

• Control