MasterPage Třída
Definice
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í.
Funguje jako šablona a slučování kontejneru pro stránky, které se skládají pouze z ovládacích prvků a příslušných podřízených Content ovládacích prvků.
public ref class MasterPage : System::Web::UI::UserControl
public class MasterPage : System.Web.UI.UserControl
type MasterPage = class
inherit UserControl
Public Class MasterPage
Inherits UserControl
- Dědičnost
Příklady
Tato část obsahuje čtyři příklady kódu:
První příklad kódu ukazuje, jak vytvořit stránku předlohy deklarativním způsobem.
Druhý příklad kódu představuje stránku obsahu přidruženou ke stránce předlohy, která byla vytvořena v prvním příkladu kódu.
Třetí příklad kódu ukazuje, jak přidat vlastnost na stránku předlohy.
Čtvrtý příklad kódu ukazuje, jak použít stránku obsahu pro přístup k veřejné vlastnosti na stránce předlohy.
Následující příklad ukazuje, jak vytvořit stránku předlohy deklarativní a přidat do ní nějaký obsah pomocí stránky obsahu. První webová stránka je stránka předlohy s názvem MasterPageSample_1.master.
<%@ Master Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html >
<head runat="server">
<title>MasterPage Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:contentplaceholder id="ContentPlaceHolder1" runat="server" />
</div>
</form>
</body>
</html>
<%@ Master Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html >
<head runat="server">
<title>MasterPage Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:contentplaceholder id="ContentPlaceHolder1" runat="server" />
</div>
</form>
</body>
</html>
Následující příklad představuje stránku obsahu, která je přidružena MasterPageSample_1.master.
Content Obsahuje ovládací prvek a identifikuje ContentPlaceHolder ovládací prvek, ke kterému je obsah přidružen pomocí ContentPlaceHolderID vlastnosti.
<%@ Page Language="C#" MasterPageFile="~/MasterPageSample_1cs.master" Title="Content Page"%>
<asp:content
runat="server"
contentplaceholderid="ContentPlaceHolder1" >Hello, Master Pages!</asp:content>
<%@ Page Language="VB" MasterPageFile="~/MasterPageSample_1vb.master" Title="Content Page"%>
<asp:content
runat="server"
contentplaceholderid="ContentPlaceHolder1" >Hello, Master Pages!</asp:content>
Následující příklad ukazuje, jak přidat vlastnost na stránku předlohy. Atribut ClassName se používá k pojmenování stránky předlohy.
<%@ Master Language="C#" ClassName="MasterExample" %>
<script runat="server">
public string SiteName
{
get { return "My Site Name"; }
}
</script>
<html >
<head runat="server">
<title>MasterPage Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:contentplaceholder id="ContentPlaceHolder1" runat="server">
</asp:contentplaceholder>
</div>
</form>
</body>
</html>
<%@ Master Language="VB" ClassName="MasterExample" %>
<script runat="server">
Public ReadOnly Property SiteName() As String
Get
Return "My Site Name"
End Get
End Property
</script>
<html >
<head runat="server">
<title>MasterPage Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:contentplaceholder id="ContentPlaceHolder1" runat="server">
</asp:contentplaceholder>
</div>
</form>
</body>
</html>
Následující příklad ukazuje, jak použít stránku obsahu pro přístup k veřejné vlastnosti SiteName na stránce předlohy v předchozím příkladu kódu.
<%@ Page Language="C#" MasterPageFile="~/MasterPage.master" Title="MasterPage Example" %>
<script runat="server">
protected void Page_Load(object sender, EventArgs e)
{
MasterExample m = (MasterExample)Page.Master;
mylabel.Text = m.SiteName;
}
</script>
<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">
Hello, Master Pages!
<asp:Label runat="server" Text="Label" ID="mylabel"></asp:Label>
</asp:Content>
<%@ Page Language="VB" MasterPageFile="~/MasterPage.master" Title="MasterPage Example" %>
<script runat="server">
Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
Dim m As MasterExample = CType(Page.Master, MasterPage)
mylabel.Text = m.SiteName
End Sub
</script>
<asp:Content ID="Content1" ContentPlaceHolderID="ContentPlaceHolder1" runat="Server">
Hello, Master Pages!
<asp:Label runat="server" Text="Label" ID="mylabel"></asp:Label>
</asp:Content>
Poznámky
Stránka předlohy funguje jako kontejner šablony a slučuje stránku pro stránky obsahu ve webové aplikaci ASP.NET. Stránky předlohy poskytují pohodlný způsob sdílení struktury a obsahu napříč sadou stránek obsahu. Zástupné symboly obsahu slouží k definování oddílů stránky předlohy, které se mají nahradit obsahem ze stránek obsahu.
Pokud používáte stránku předlohy a související stránky obsahu, přidáte požadované značky dokumentů XHTML (například html, heada body) jenom na stránku předlohy a už nebudete vytvářet ostatní .aspx soubory (ASP.NET stránky) jako samostatné webové stránky. Stránky obsahu definují obsah, který se má vložit do zástupných symbolů na stránce předlohy.
Při vytvoření požadavku HTTP pro stránku za běhu se stránka předlohy a stránky obsahu zkombinují do jedné třídy se stejným názvem jako stránky obsahu. Výsledná kompilovaná sloučená třída je odvozena od Page třídy.
Stránka předlohy může obsahovat přímé ovládací prvky značek a serverů a také ovládací prvky kontejneru. Všechny prvky umístěné na stránce předlohy mimo ContentPlaceHolder ovládací prvek se vykreslují na všech stránkách, které jsou výsledkem sloučení stránky předlohy a stránek obsahu.
Každá stránka obsahu, která souvisí se stránkou předlohy, musí odkazovat na stránku předlohy v MasterPageFile atributu jeho direktivy @ Page . Stránky obsahu mohou obsahovat pouze direktivu @ Page a jeden nebo více Content ovládacích prvků. Veškerý text stránky, revize a ovládací prvky serveru musí být umístěny v Content ovládacích prvcích. Určujete ContentPlaceHolder ovládací prvek stránky předlohy, ke které Content je ovládací prvek přidružený nastavením ContentPlaceHolderID vlastnosti Content ovládacího prvku.
V době běhu se dynamický obsah z každého Content ovládacího prvku na požadované stránce sloučí se stránkou předlohy v přesném umístění souvisejícího ContentPlaceHolder ovládacího prvku. Všechny ostatní značky a ovládací prvky na stránce předlohy nejsou ovlivněné. Obslužné rutiny událostí lze definovat v hlavní třídě i na stránce obsahu. Další informace naleznete v tématu Události v ASP.NET stránky předlohy a obsahu.
Třída MasterPage je přidružena k souborům, které mají příponu .master. Tyto soubory se kompilují za běhu jako MasterPage objekty a ukládají se do mezipaměti v paměti serveru.
Stránka předlohy je zpřístupněna stránce obsahu prostřednictvím Master vlastnosti základní Page třídy. Vlastnost Master vrátí instanci stránky předlohy, ale je zadána jako základní MasterPage třída. Pro přístup k ovládacím prvkům, vlastnostem a funkcím stránky předlohy Master lze vlastnost přetypovat na MasterPage objekt. Název třídy stránky předlohy je definován pomocí ClassName atributu direktivy @ Master .
Poznámka:
Soubory s příponami .master nejsou obsluhovány v prohlížeči.
Direktivy platné na stránce předlohy jsou stejné jako direktivy, které jsou k dispozici u objektu UserControl . Můžou obsahovat následující atributy:
AutoEventWireupClassNameCodeFileCompilerModeCompilerOptionsDebugDescriptionEnableThemingEnableViewStateExplicitInheritsLanguageLinePragmasMasterPageFileSrcStrictWarningLevel
Direktivy stránky předlohy nepřepíší direktivy na jednotlivých stránkách obsahu.
Stránky předlohy se nejčastěji vytvářejí deklarativním způsobem. Pokud chcete vytvořit stránku předlohy prostřednictvím kódu programu, odvozujte ji přímo z MasterPage třídy. Kromě rozšíření MasterPage třídy musíte vytvořit soubor .master, který vizuálně zobrazí uživatelské rozhraní (UI), které je přidruženo ke třídám, které jste vyvolali ve zdrojovém souboru.
Poznámka:
Při vytváření stránky předlohy vytvořením vlastní třídy musíte nejprve zahrnout všechny obory názvů, které jsou požadovány pro třídy používané stránkou.
Další informace o stránkách předlohy najdete v tématu ASP.NET stránky předlohy.
Konstruktory
| Name | Description |
|---|---|
| MasterPage() |
Vytvoří novou instanci MasterPage třídy. |
Vlastnosti
| Name | Description |
|---|---|
| Adapter |
Získá adaptér specifický pro prohlížeč pro ovládací prvek. (Zděděno od Control) |
| Application |
Application Získá objekt pro aktuální webový požadavek. (Zděděno od UserControl) |
| AppRelativeTemplateSourceDirectory |
Získá nebo nastaví relativní virtuální adresář Page aplikace nebo UserControl objektu, který obsahuje tento ovládací prvek. (Zděděno od Control) |
| AppRelativeVirtualPath |
Získá nebo nastaví relativní cestu k virtuálnímu adresáři aplikace k souboru, ze kterého je ovládací prvek analyzován a kompilován. (Zděděno od TemplateControl) |
| Attributes |
Získá kolekci všech dvojic názvu a hodnoty atributu deklarovaných ve značce uživatelského ovládacího prvku v souboru .aspx. (Zděděno od UserControl) |
| AutoHandlers |
Zastaralé.
Vlastnost AutoHandlers je v ASP.NET NET 2.0 zastaralá. Používá se vygenerovanými třídami a není určená pro použití v kódu. (Zděděno od TemplateControl) |
| BindingContainer |
Získá ovládací prvek, který obsahuje datovou vazbu tohoto ovládacího prvku. (Zděděno od Control) |
| Cache |
Cache Získá objekt, který je přidružen k aplikaci, která obsahuje uživatelský ovládací prvek. (Zděděno od UserControl) |
| CachePolicy |
Získá odkaz na kolekci parametrů ukládání do mezipaměti pro tento uživatelský ovládací prvek. (Zděděno od UserControl) |
| ChildControlsCreated |
Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky ovládacího prvku serveru. (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í oddělovač znak použitý ve ClientID vlastnosti. (Zděděno od Control) |
| ContentPlaceHolders |
Získá seznam ovládacích ContentPlaceHolder prvků, které stránka předlohy používá k definování různých oblastí obsahu. |
| ContentTemplates |
Získá seznam ovládacích prvků obsahu přidružených k stránce předlohy. |
| 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ý server ovládací prvek v hierarchii uživatelského rozhraní. (Zděděno od Control) |
| DataItemContainer |
Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataItemContainer. (Zděděno od Control) |
| DataKeysContainer |
Získá odkaz na kontejner pojmenování, pokud pojmenování kontejner implementuje IDataKeysControl. (Zděděno od Control) |
| DesignMode |
Získá hodnotu určující, zda se ovládací prvek používá na návrhové ploše. (Zděděno od Control) |
| EnableTheming |
Získá nebo nastaví logickou hodnotu označující, zda motivy platí pro ovládací prvek odvozený z TemplateControl třídy. (Zděděno od TemplateControl) |
| 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. (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 určující, zda aktuální serverový ovládací prvky podřízené ovládací prvky mají jakékoli uložené nastavení stavu zobrazení. (Zděděno od Control) |
| ID |
Získá nebo nastaví programový identifikátor přiřazený 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 určující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav ovládacího prvku. (Zděděno od Control) |
| IsPostBack |
Získá hodnotu určující, zda se uživatelský ovládací prvek načítá v reakci na postback klienta, nebo pokud se načítá a přistupuje poprvé. (Zděděno od UserControl) |
| IsTrackingViewState |
Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do jeho stavu zobrazení. (Zděděno od Control) |
| IsViewStateEnabled |
Získá hodnotu označující, zda je pro tento ovládací prvek povolen stav zobrazení. (Zděděno od Control) |
| LoadViewStateByID |
Získá hodnotu určující, zda se ovládací prvek účastní načítání jeho stavu zobrazení namísto ID indexu. (Zděděno od Control) |
| Master |
Získá nadřazenou stránku předlohy aktuální předlohy ve scénářích vnořených stránek předlohy. |
| MasterPageFile |
Získá nebo nastaví název stránky předlohy, která obsahuje aktuální obsah. |
| 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. (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 ovládacího prvku serveru v hierarchii ovládacích prvků stránky. (Zděděno od Control) |
| RenderingCompatibility |
Získá hodnotu, která určuje ASP.NET verzi, která vykreslený KÓD HTML bude kompatibilní s. (Zděděno od Control) |
| Request |
HttpRequest Získá objekt pro aktuální webový požadavek. (Zděděno od UserControl) |
| Response |
HttpResponse Získá objekt pro aktuální webový požadavek. (Zděděno od UserControl) |
| Server |
HttpServerUtility Získá objekt pro aktuální webový požadavek. (Zděděno od UserControl) |
| Session |
HttpSessionState Získá objekt pro aktuální webový požadavek. (Zděděno od UserControl) |
| Site |
Získá informace o kontejneru, který je hostitelem aktuálního ovládacího prvku při vykreslení na návrhové ploše. (Zděděno od Control) |
| SkinID |
Získá nebo nastaví kůži, která se použije na ovládací prvek. (Zděděno od Control) |
| SupportAutoEvents |
Získá hodnotu určující, zda TemplateControl ovládací prvek podporuje automatické události. (Zděděno od TemplateControl) |
| 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 řízení. (Zděděno od Control) |
| Trace |
TraceContext Získá objekt pro aktuální webový požadavek. (Zděděno od UserControl) |
| UniqueID |
Získá jedinečný hierarchicky kvalifikovaný identifikátor pro ovládací prvek serveru. (Zděděno od Control) |
| 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. (Zděděno od Control) |
| 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. (Zděděno od Control) |
| ViewStateIgnoresCase |
Získá hodnotu, která určuje, zda StateBag objekt nerozlišuje malá a velká písmena. (Zděděno od Control) |
| ViewStateMode |
Získá nebo nastaví režim zobrazení-stav tohoto ovládacího prvku. (Zděděno od Control) |
| Visible |
Získá nebo nastaví hodnotu, která určuje, zda je serverový ovládací prvek vykreslen jako uživatelské rozhraní na stránce. (Zděděno od Control) |
Metody
| Name | Description |
|---|---|
| AddContentTemplate(String, ITemplate) |
Content Přidá ovládací prvek do slovníkuContentTemplates. |
| 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í serverový ovládací prvek, že byl analyzován element XML nebo HTML a přidá prvek do objektu ControlCollection ovládacího prvku serveru. (Zděděno od Control) |
| ApplyStyleSheetSkin(Page) |
Použije vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek. (Zděděno od Control) |
| BeginRenderTracing(TextWriter, Object) |
Začíná trasování doby návrhu vykreslovacích dat. (Zděděno od Control) |
| 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. (Zděděno od Control) |
| ClearCachedClientID() |
Nastaví hodnotu uloženou ClientID v mezipaměti na |
| ClearChildControlState() |
Odstraní informace o stavu řízení pro podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClearChildState() |
Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClearChildViewState() |
Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky ovládacího prvku serveru. (Zděděno od Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Nastaví vlastnost aktuální instance ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control) |
| Construct() |
Provádí logiku návrhu v čase. (Zděděno od TemplateControl) |
| 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í. (Zděděno od Control) |
| CreateControlCollection() |
Vytvoří nový ControlCollection objekt pro uložení podřízených ovládacích prvků (literálu i serveru) ovládacího prvku serveru. (Zděděno od Control) |
| CreateResourceBasedLiteralControl(Int32, Int32, Boolean) |
Přistupuje k řetězcům literálů uloženým v prostředku. Metoda CreateResourceBasedLiteralControl(Int32, Int32, Boolean) není určená k použití z vašeho kódu. (Zděděno od TemplateControl) |
| DataBind() |
Vytvoří vazbu zdroje dat na vyvolaný ovládací prvek serveru a všechny jeho podřízené ovládací prvky. (Zděděno od Control) |
| 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. (Zděděno od Control) |
| DataBindChildren() |
Vytvoří vazbu zdroje dat k podřízeným ovládacím prvkům ovládacího prvku serveru. (Zděděno od Control) |
| DesignerInitialize() |
Provede všechny kroky inicializace uživatelského ovládacího prvku, které vyžadují návrháři RAD. (Zděděno od UserControl) |
| 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í vykreslování dat v době návrhu. (Zděděno od Control) |
| EnsureChildControls() |
Určuje, zda ovládací prvek serveru 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čuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| Eval(String, String) |
Vyhodnotí výraz vazby dat pomocí zadaného řetězce formátu k zobrazení výsledku. (Zděděno od TemplateControl) |
| Eval(String) |
Vyhodnotí výraz vazby dat. (Zděděno od TemplateControl) |
| FindControl(String, Int32) |
Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným |
| FindControl(String) |
Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným |
| Focus() |
Nastaví vstupní fokus na ovládací prvek. (Zděděno od Control) |
| FrameworkInitialize() |
Inicializuje ovládací prvek odvozený z TemplateControl třídy. (Zděděno od TemplateControl) |
| GetDesignModeState() |
Získá data v době návrhu pro ovládací prvek. (Zděděno od Control) |
| GetGlobalResourceObject(String, String, Type, String) |
Získá objekt prostředku na úrovni aplikace na základě zadaných ClassKey a ResourceKey vlastností, typ objektu a název vlastnosti prostředku. (Zděděno od TemplateControl) |
| GetGlobalResourceObject(String, String) |
Získá objekt prostředku na úrovni aplikace na základě zadaných ClassKey a ResourceKey vlastností. (Zděděno od TemplateControl) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetLocalResourceObject(String, Type, String) |
Získá objekt prostředku na úrovni stránky na základě zadané ResourceKey vlastnosti, typu objektu a názvu vlastnosti. (Zděděno od TemplateControl) |
| GetLocalResourceObject(String) |
Získá objekt prostředku na úrovni stránky na základě zadané ResourceKey vlastnosti. (Zděděno od TemplateControl) |
| 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ázvu trasy. (Zděděno od Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Získá adresu URL, která odpovídá sadě parametrů trasy a názvu trasy. (Zděděno od Control) |
| 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. (Zděděno od Control) |
| HasControls() |
Určuje, zda serverový ovládací prvek obsahuje jakékoli podřízené ovládací prvky. (Zděděno od Control) |
| 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. (Zděděno od Control) |
| InitializeAsUserControl(Page) |
Inicializuje UserControl objekt, který byl vytvořen deklarativní. Vzhledem k tomu, že mezi stránkami a uživatelskými ovládacími prvky existují určité rozdíly, tato metoda zajistí, že je uživatelský ovládací prvek inicializován správně. (Zděděno od UserControl) |
| InstantiateInContentPlaceHolder(Control, ITemplate) |
Poskytuje metodu pro nastavení aktuálního ovládacího prvku šablony na stránku, která vlastní stránku předlohy. |
| IsLiteralContent() |
Určuje, zda ovládací prvek serveru obsahuje pouze literálový obsah. (Zděděno od Control) |
| LoadControl(String) |
Načte Control objekt ze souboru na základě zadané virtuální cesty. (Zděděno od TemplateControl) |
| LoadControl(Type, Object[]) |
Načte Control objekt na základě zadaného typu a parametrů konstruktoru. (Zděděno od TemplateControl) |
| LoadControlState(Object) |
Obnoví informace o stavu řízení z předchozího požadavku na stránku, který byla uložena metodou SaveControlState() . (Zděděno od Control) |
| LoadTemplate(String) |
Získá instanci rozhraní z externího ITemplate souboru. (Zděděno od TemplateControl) |
| LoadViewState(Object) |
Obnoví informace o stavu zobrazení z předchozího požadavku na řízení uživatele, který byl uložen metodou SaveViewState() . (Zděděno od UserControl) |
| MapPath(String) |
Přiřadí cestu k virtuálnímu souboru( absolutní nebo relativní) fyzické cestě k souboru. (Zděděno od UserControl) |
| 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 Object. (Zděděno od Object) |
| OnAbortTransaction(EventArgs) |
AbortTransaction Vyvolá událost. (Zděděno od TemplateControl) |
| 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. (Zděděno od Control) |
| OnCommitTransaction(EventArgs) |
CommitTransaction Vyvolá událost. (Zděděno od TemplateControl) |
| OnDataBinding(EventArgs) |
DataBinding Vyvolá událost. (Zděděno od Control) |
| OnError(EventArgs) |
Error Vyvolá událost. (Zděděno od TemplateControl) |
| OnInit(EventArgs) |
Init Vyvolá událost. (Zděděno od UserControl) |
| 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žité ke čtení souboru. (Zděděno od Control) |
| ParseControl(String, Boolean) |
Analyzuje vstupní řetězec do objektu Control na webové stránce ASP.NET nebo uživatelském ovládacím prvku. (Zděděno od TemplateControl) |
| ParseControl(String) |
Parsuje vstupní řetězec do objektu Control na stránce webových formulářů nebo uživatelském ovládacím prvku. (Zděděno od TemplateControl) |
| RaiseBubbleEvent(Object, EventArgs) |
Přiřadí všechny zdroje události a její informace nadřazené ovládacího prvku. (Zděděno od Control) |
| ReadStringResource() |
Přečte řetězcový prostředek. Metoda ReadStringResource() není určená k použití z vašeho kódu. (Zděděno od TemplateControl) |
| 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) |
Odešle obsah ovládacího prvku serveru do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control) |
| 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. (Zděděno od Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Výstupy obsahu ovládacího prvku serveru do poskytnutého HtmlTextWriter objektu pomocí poskytnutého ControlAdapter objektu. (Zděděno od Control) |
| 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í. (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 může prohlížeč používat. (Zděděno od Control) |
| ResolveUrl(String) |
Převede adresu URL na adresu URL, která je použitelná u žádajícího klienta. (Zděděno od Control) |
| 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. (Zděděno od Control) |
| SaveViewState() |
Uloží všechny změny stavu zobrazení uživatelského ovládacího prvku, ke kterým došlo od posledního zpětného odeslání stránky. (Zděděno od UserControl) |
| SetDesignModeState(IDictionary) |
Nastaví data návrhu pro ovládací prvek. (Zděděno od Control) |
| 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. (Zděděno od Control) |
| SetStringResourcePointer(Object, Int32) |
Nastaví ukazatel na prostředek řetězce. Metoda SetStringResourcePointer(Object, Int32) je používána generovanými třídami a není určena k použití z vašeho kódu. (Zděděno od TemplateControl) |
| 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í. (Zděděno od Control) |
| 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í. (Zděděno od Control) |
| TestDeviceFilter(String) |
Vrátí logickou hodnotu označující, jestli se filtr zařízení vztahuje na požadavek HTTP. (Zděděno od TemplateControl) |
| 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. (Zděděno od Control) |
| TryUpdateModel<TModel>(TModel, IValueProvider) |
Pokusí se aktualizovat instanci modelu pomocí hodnot zprostředkovatele hodnot. (Zděděno od UserControl) |
| TryUpdateModel<TModel>(TModel) |
Pokusí se aktualizovat instanci modelu pomocí hodnot z ovládacího prvku vázaného na data. (Zděděno od UserControl) |
| UpdateModel<TModel>(TModel, IValueProvider) |
Aktualizuje zadanou instanci modelu pomocí hodnot zprostředkovatele hodnot uživatelského ovládacího prvku. (Zděděno od UserControl) |
| UpdateModel<TModel>(TModel) |
Aktualizuje instanci modelu pomocí hodnot z ovládacího prvku vázaného na data. (Zděděno od UserControl) |
| WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) |
Zapíše řetězec prostředku do HtmlTextWriter ovládacího prvku. Metoda WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) je používána generovanými třídami a není určena k použití z vašeho kódu. (Zděděno od TemplateControl) |
| XPath(String, IXmlNamespaceResolver) |
Vyhodnotí výraz datové vazby XPath pomocí zadaného mapování předpony a oboru názvů pro překlad oboru názvů. (Zděděno od TemplateControl) |
| XPath(String, String, IXmlNamespaceResolver) |
Vyhodnotí výraz datové vazby XPath pomocí zadaného mapování předpony a oboru názvů pro rozlišení oboru názvů a zadaný formátovací řetězec k zobrazení výsledku. (Zděděno od TemplateControl) |
| XPath(String, String) |
Vyhodnotí výraz datové vazby XPath pomocí zadaného formátového řetězce k zobrazení výsledku. (Zděděno od TemplateControl) |
| XPath(String) |
Vyhodnotí výraz datové vazby XPath. (Zděděno od TemplateControl) |
| XPathSelect(String, IXmlNamespaceResolver) |
Vyhodnotí výraz datové vazby XPath pomocí zadaného mapování předpony a oboru názvů pro překlad oboru názvů a vrátí kolekci uzlů, která implementuje IEnumerable rozhraní. (Zděděno od TemplateControl) |
| XPathSelect(String) |
Vyhodnotí výraz datové vazby XPath a vrátí kolekci uzlů, která implementuje IEnumerable rozhraní. (Zděděno od TemplateControl) |
Událost
| Name | Description |
|---|---|
| AbortTransaction |
Nastane, když uživatel ukončí transakci. (Zděděno od TemplateControl) |
| CommitTransaction |
Nastane po dokončení transakce. (Zděděno od TemplateControl) |
| DataBinding |
Nastane, když ovládací prvek serveru vytvoří vazbu ke zdroji dat. (Zděděno od Control) |
| 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. (Zděděno od Control) |
| Error |
Nastane, když je vyvolán neošetřená výjimka. (Zděděno od TemplateControl) |
| Init |
Nastane při inicializaci ovládacího prvku serveru, což je první krok v jeho životním cyklu. (Zděděno od Control) |
| Load |
Nastane, když je serverový ovládací prvek načten do objektu Page . (Zděděno od Control) |
| PreRender |
Nastane po načtení objektu Control , ale před vykreslením. (Zděděno od Control) |
| Unload |
Nastane, když je serverový ovládací prvek uvolněn z paměti. (Zděděno od Control) |
Explicitní implementace rozhraní
| Name | Description |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Vrátí hodnotu zadaného atributu uživatelského ovládacího prvku. (Zděděno od UserControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Nastaví hodnotu zadaného atributu uživatelského ovládacího prvku. (Zděděno od UserControl) |
| IControlBuilderAccessor.ControlBuilder |
Popis tohoto člena naleznete v tématu ControlBuilder. (Zděděno od Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Popis tohoto člena naleznete v tématu GetDesignModeState(). (Zděděno od Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Popis tohoto člena naleznete v tématu SetDesignModeState(IDictionary). (Zděděno od Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Popis tohoto člena naleznete v tématu SetOwnerControl(Control). (Zděděno od Control) |
| IControlDesignerAccessor.UserData |
Popis tohoto člena naleznete v tématu UserData. (Zděděno od Control) |
| IDataBindingsAccessor.DataBindings |
Popis tohoto člena naleznete v tématu DataBindings. (Zděděno od Control) |
| IDataBindingsAccessor.HasDataBindings |
Popis tohoto člena naleznete v tématu HasDataBindings. (Zděděno od Control) |
| IExpressionsAccessor.Expressions |
Popis tohoto člena naleznete v tématu Expressions. (Zděděno od Control) |
| IExpressionsAccessor.HasExpressions |
Popis tohoto člena naleznete v tématu HasExpressions. (Zděděno od Control) |
| IFilterResolutionService.CompareFilters(String, String) |
Vrátí hodnotu, která určuje, jestli vztah nadřazenosti nebo podřízenosti existuje mezi dvěma zadanými filtry zařízení. (Zděděno od TemplateControl) |
| IFilterResolutionService.EvaluateFilter(String) |
Vrátí hodnotu, která určuje, zda je zadaný filtr typem aktuálního objektu filtru. (Zděděno od TemplateControl) |
| IParserAccessor.AddParsedSubObject(Object) |
Popis tohoto člena naleznete v tématu AddParsedSubObject(Object). (Zděděno od Control) |
| IUserControlDesignerAccessor.InnerText |
Získá nebo nastaví text, který se zobrazí mezi levou a pravou značkou uživatelského ovládacího prvku. (Zděděno od UserControl) |
| IUserControlDesignerAccessor.TagName |
Získá nebo nastaví úplný název značky uživatelského ovládacího prvku. (Zděděno od UserControl) |
Metody rozšíření
| Name | Description |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Povolí chování dynamických dat pro zadaný ovládací prvek dat. |
| EnableDynamicData(INamingContainer, Type, Object) |
Povolí chování dynamických dat pro zadaný ovládací prvek dat. |
| EnableDynamicData(INamingContainer, Type) |
Povolí chování dynamických dat pro zadaný ovládací prvek dat. |
| 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. |
| GetDefaultValues(INamingContainer) |
Získá kolekci výchozích hodnot pro zadaný ovládací prvek dat. |
| GetMetaTable(INamingContainer) |
Získá metadata tabulky pro zadaný ovládací prvek dat. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Nastaví metadata tabulky a výchozí mapování hodnot pro zadaný ovládací prvek dat. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Nastaví metadata tabulky a výchozí mapování hodnot pro zadaný ovládací prvek dat. |
| SetMetaTable(INamingContainer, MetaTable) |
Nastaví metadata tabulky pro zadaný ovládací prvek dat. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Určuje, zda jsou k dispozici metadata tabulky. |