WebZone 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í.
Slouží jako základní třída pro všechny ovládací prvky, které fungují jako kontejnery pro ovládací prvky serveru (včetně ovládacích prvků webových částí Part , serverových ovládacích prvků a uživatelských ovládacích prvků) v aplikacích webových částí.
public ref class WebZone abstract : System::Web::UI::WebControls::CompositeControl[System.ComponentModel.Bindable(false)]
public abstract class WebZone : System.Web.UI.WebControls.CompositeControl[<System.ComponentModel.Bindable(false)>]
type WebZone = class
inherit CompositeControlPublic MustInherit Class WebZone
Inherits CompositeControl- Dědičnost
- Odvozené
- Atributy
Příklady
Následující příklad kódu ukazuje použití WebZone třídy .
První část příkladu kódu ukazuje dva vlastní ovládací prvky, které jsou odvozeny WebPart z třídy . Aby se příklad kódu spustil, musíte tento zdrojový kód zkompilovat. Můžete ho explicitně zkompilovat a vložit výsledné sestavení do složky Bin webu nebo globální mezipaměti sestavení (GPA). Případně můžete zdrojový kód umístit do složky App_Code webu, kde se bude dynamicky kompilovat za běhu. Návod, který ukazuje obě metody kompilace, najdete v tématu Návod: Vývoj a použití vlastního ovládacího prvku webového serveru.
using System;
using System.Security.Permissions;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
public class CalendarWebPart : WebPart
{
Calendar _calendar;
public CalendarWebPart()
{
this.AllowClose = false;
}
protected override void CreateChildControls()
{
Controls.Clear();
_calendar = new Calendar();
_calendar.Caption = "My Calendar";
this.Controls.Add(_calendar);
ChildControlsCreated = true;
}
}
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
public class LinksWebPart : WebPart
{
Literal _literal;
const string _literalText = @"
<table>
<tr>
<td><a href='http://msdn.microsoft.com'>MSDN</a></td>
</tr>
<tr>
<td><a href='http://msn.microsoft.com'>MSN</a></td>
</tr>
<tr>
<td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>
</tr>
</table>";
public LinksWebPart()
{
this.AllowClose = false;
}
protected override void CreateChildControls()
{
Controls.Clear();
_literal = new Literal();
_literal.Text = _literalText;
this.Controls.Add(_literal);
ChildControlsCreated = true;
}
}
}
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, _
Level := AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level := AspNetHostingPermissionLevel.Minimal)> _
Public Class CalendarWebPart
Inherits WebPart
Private _calendar As Calendar
Public Sub New()
Me.AllowClose = False
End Sub
Protected Overrides Sub CreateChildControls()
Controls.Clear()
_calendar = New Calendar()
_calendar.Caption = "My Calendar"
Me.Controls.Add(_calendar)
ChildControlsCreated = True
End Sub
End Class
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class LinksWebPart
Inherits WebPart
Private _literal As Literal
Private Const _literalText As String = _
"<table>" & _
"<tr>" & _
"<td><a href='http://msdn.microsoft.com'>MSDN</a></td>" & _
"</tr>" & _
"<tr>" & _
"<td><a href='http://msn.microsoft.com'>MSN</a></td>" & _
"</tr>" & _
"<tr>" & _
"<td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>" & _
"</tr>" & _
"</table>"
Public Sub New()
Me.AllowClose = False
End Sub
Protected Overrides Sub CreateChildControls()
Controls.Clear()
_literal = New Literal()
_literal.Text = _literalText
Me.Controls.Add(_literal)
ChildControlsCreated = True
End Sub
End Class
End Namespace
Druhá část příkladu kódu ukazuje webovou stránku, která je hostitelem ovládacích WebPart prvků. Všimněte si, že deklarativní kód obsahuje dva WebPartZone ovládací prvky, CatalogZone ovládací prvek a EditorZone ovládací prvek.
<%@ page language="C#" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuCS"
Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.CS.Controls"
Assembly="ZoneWebPartsCS"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
<asp:webpartzone
id="WebPartZone1"
runat="server"
title="Zone 1"
PartChromeType="TitleAndBorder">
<parttitlestyle font-bold="true" ForeColor="#3300cc"/>
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<ZoneTemplate>
<aspSample:CalendarWebPart
runat="server"
id="CalendarWebPart1"
Title="Calendar WebPart"
/>
</ZoneTemplate>
</asp:webpartzone>
<asp:webpartzone
id="WebPartZone2"
runat="server"
title="Zone 2"
PartChromeType="TitleAndBorder"
EmptyZoneText="Empty Zone">
<parttitlestyle font-bold="true" ForeColor="#3300cc"/>
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
</asp:webpartzone>
<asp:EditorZone ID="editzone1" Runat="server">
<ZoneTemplate>
<asp:AppearanceEditorPart
ID="appearanceeditor1"
Runat="server" />
<asp:LayoutEditorPart
ID="LayoutEditorPart1"
Runat="server" />
</ZoneTemplate>
</asp:EditorZone>
<asp:CatalogZone ID="catalogzone1" Runat="server" >
<ZoneTemplate>
<asp:DeclarativeCatalogPart
ID="declarativepart1"
Runat="server">
<WebPartsTemplate>
<aspSample:LinksWebPart
runat="server"
id="linkswebpart"
Title="Favorite Links"
/>
</WebPartsTemplate>
</asp:DeclarativeCatalogPart>
</ZoneTemplate>
</asp:CatalogZone>
<br />
</form>
</body>
</html>
<%@ page language="VB" %>
<%@ register TagPrefix="uc1"
TagName="DisplayModeMenuVB"
Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.VB.Controls"
Assembly="ZoneWebPartsVB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">
<asp:webpartmanager id="WebPartManager1" runat="server" />
<uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
<asp:webpartzone
id="WebPartZone1"
runat="server"
title="Zone 1"
PartChromeType="TitleAndBorder">
<parttitlestyle font-bold="true" ForeColor="#3300cc"/>
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<ZoneTemplate>
<aspSample:CalendarWebPart
runat="server"
id="CalendarWebPart1"
Title="Calendar WebPart"
/>
</ZoneTemplate>
</asp:webpartzone>
<asp:webpartzone
id="WebPartZone2"
runat="server"
title="Zone 2"
PartChromeType="TitleAndBorder"
EmptyZoneText="Empty Zone">
<parttitlestyle font-bold="true" ForeColor="#3300cc"/>
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
</asp:webpartzone>
<asp:EditorZone ID="editzone1" Runat="server">
<ZoneTemplate>
<asp:AppearanceEditorPart
ID="appearanceeditor1"
Runat="server" />
<asp:LayoutEditorPart
ID="LayoutEditorPart1"
Runat="server" />
</ZoneTemplate>
</asp:EditorZone>
<asp:CatalogZone ID="catalogzone1" Runat="server" >
<ZoneTemplate>
<asp:DeclarativeCatalogPart
ID="declarativepart1"
Runat="server">
<WebPartsTemplate>
<aspSample:LinksWebPart
runat="server"
id="linkswebpart"
Title="Favorite Links"
/>
</WebPartsTemplate>
</asp:DeclarativeCatalogPart>
</ZoneTemplate>
</asp:CatalogZone>
<br />
</form>
</body>
</html>
Stránku můžete načíst v prohlížeči a přepínat mezi různými režimy zobrazení stránky, abyste viděli, jak se různé zóny chovají. Další informace o režimech zobrazení a o tom, jak mezi nimi uživatelé můžou přepínat, najdete v tématu Návod: Změna režimů zobrazení na stránce webových částí.
Poznámky
Zóna webových částí je definovaná oblast, která obsahuje serverové ovládací prvky na webové stránce a poskytuje konzistentní uživatelské rozhraní, rozložení a vykreslování obsažených ovládacích prvků. Zóny se v prohlížeči vykreslují jako tabulky HTML.
Třída WebZone je základní třídou pro všechny zóny webových částí. Ovládací prvek zóny je složený ovládací prvek navržený tak, aby obsahoval jiné ovládací prvky, proto WebZone třída dědí z třídy CompositeControl . Spolu s ovládacími prvky a Part ovládacími prvky (nebo jinými uživatelskými WebPartManager nebo serverovými ovládacími prvky, které lze umístit do zón) tvoří ovládací prvky zóny odvozené ze WebZone základní třídy základní stavební bloky aplikace webových částí.
Klíčovou rolí zón webových částí je povolení úplné funkčnosti webových částí pro ovládací prvky, které obsahují. Každá stránka webových částí obsahuje alespoň jednu zónu a zóna může obsahovat nula nebo více ovládacích prvků části. Funkce webových částí vyžaduje zóny. Bez zón mohou mít dokonce i ovládací prvky, které jsou odvozeny z WebPart třídy, velmi málo funkcí webových částí. Vzhledem k návrhu sady ovládacích prvků webových částí můžete naopak umístit běžné ovládací prvky ASP.NET, serverové ovládací prvky nebo uživatelské ovládací prvky do WebPartZoneBase zóny (která je odvozena z WebZone). Díky tomu, že jsou v zóně, mohou tyto běžné serverové ovládací prvky fungovat jako WebPart ovládací prvky za běhu. Podrobnosti najdete v dokumentaci ke GenericWebPart třídě .
Poznámka
Na stránku mimo zónu je možné přidat Part ovládací prvky nebo WebPart ovládací prvky, ale v takovém případě jednoduše fungují jako běžné serverové ovládací prvky.
Existují dvě široké kategorie zón v sadě webových částí ovládacích prvků, z nichž všechny dědí ze základní WebZone třídy.
WebPartZoneBase Zóny. Ty obsahují WebPart ovládací prvky (a další ovládací prvky serveru a uživatele) a tvoří primární uživatelské rozhraní stránek webových částí, se kterými uživatelé většinu času pracují.
ToolZone Zóny. Tyto zóny poskytují speciální zobrazení stránky webových částí, která uživatelům umožňují upravovat (přizpůsobovat) obsah, rozložení, vzhled, chování a vlastnosti ovládacích prvků obsažených v WebPartZoneBase zónách na stránce webových částí. Například CatalogZoneBase zóna je ToolZone , která poskytuje zobrazení katalogu stránky, což umožňuje uživatelům přidávat a odebírat serverové ovládací prvky. Zóna EditorZoneBase je další typ ToolZone , který poskytuje zobrazení stránky pro úpravy a umožňuje uživatelům upravovat a upravovat rozložení stránky spolu s vlastnostmi, vzhledem a chováním ovládacích prvků.
Každá zóna v sadě webových částí je navržena tak, aby obsahovala odpovídající typ ovládacího prvku odvozeného z Part třídy, přičemž ovládací prvky části slouží jako hlavní obsah a primární uživatelské rozhraní zóny. Typy zón v sadě ovládacích prvků webové části spolu s odpovídajícími typy ovládacích prvků částí, které obsahují, jsou uvedeny v následující tabulce.
| Typ ovládacího prvku části | Typ zóny |
|---|---|
| WebPart (a serverové a uživatelské ovládací prvky, které jsou zabalené pomocí GenericWebPart za běhu) | WebPartZone (základní třída je WebPartZoneBase ) |
| EditorPart (několik odvozených ovládacích prvků je součástí sady ovládacích prvků webových částí a lze vyvíjet vlastní EditorPart ovládací prvky) | EditorZone (základní třída je EditorZoneBase ) |
| CatalogPart (několik odvozených ovládacích prvků je součástí sady ovládacích prvků webových částí a lze vyvíjet vlastní CatalogPart ovládací prvky) | CatalogZone (základní třída je CatalogZoneBase ) |
| WebPartConnection (ovládací prvky připojení jsou jedinečné v tom, že nejsou součástí ovládacích prvků, které dědí ze základní třídy) | ConnectionsZone (dědí přímo z ToolZone ) |
Všechny zóny v ovládacím prvku webové části mají základní společné prvky uživatelského rozhraní, které dědí ze základní WebZone třídy. Ne všechny tyto prvky jsou viditelné v každé zóně, ale každý typ zóny může mít tyto společné prvky uživatelského rozhraní související se zónou, jak je popsáno v následující tabulce.
| Oddíl zóny | Description |
|---|---|
| Hlavička | Horní část zóny. Obsahuje text záhlaví, který může obsahovat název zóny; atributy stylu (například ohraničení nebo barva pozadí), které rozlišují záhlaví; a příkazy na úrovni zóny (představované tlačítky, hypertextovými odkazy nebo obrázky), na které můžou uživatelé kliknout a provádět akce uživatelského rozhraní, které se vztahují na celou zónu, jako je například zavření zóny. Několik WebZone vlastností, například HasHeader, HeaderStylea HeaderText, se vztahuje k oblasti záhlaví zóny. Pokud jsou v zóně příkazy na úrovni zóny, VerbButtonType platí pro ně vlastnosti a VerbStyle . Všimněte si, že tyto dvě vlastnosti sloves platí pouze pro příkazy na úrovni zóny, nikoli pro příkazy v ovládacích prvcích jednotlivých částí obsažených v zóně. Hlavičky nejsou přítomny ve všech typech zón; obvykle se zobrazují v ToolZone zónách, kde je potřeba mít společnou oblast záhlaví s textem a slovesem, jako je například operace uzavření. |
| Text | Část hlavního obsahu zóny. Každá zóna, která je odvozena z WebZone , má část těla. Pro všechny typy zón v sadě webových částí obsahuje tělo zóny určený typ ovládacích prvků (nebo jiných serverových ovládacích Part prvků), které odpovídají typu zóny, jak je uvedeno v předchozí tabulce. Různé členy WebZone třídy ovlivňují obsah oddílu body, jako BackImageUrljsou vlastnosti , PartChromeStyle, PartChromeTypea PartStyle . Pokud je část textu prázdná, EmptyZoneText může se zpráva v určitých situacích zobrazit. |
| Chrome | Společné prvky uživatelského rozhraní vykreslené pro každou část ovládací prvek v zóně. To se liší od diskuze o atributech stylu, které se vztahují na samotnou zónu; chrome platí konkrétně pro ovládací prvky obsažených součástí. Chrome obsahuje příkazy, ohraničení a další atributy stylu, jako je barva pozadí nebo styl písma textu nadpisu, pro ovládací prvky části zóny. Zóna určuje podrobnosti chromu pomocí jednoho objektu chrome odpovídajícího typu ovládacích prvků části, CatalogPartChrome které CatalogPart obsahuje (například objekt pro objekt obsahující CatalogZone ovládací prvky). Tento jediný objekt chromu zpracovává detaily chromu a vykreslování pro všechny ovládací prvky součástí v zóně. To umožňuje vývojářům vytvářet zóny, ve kterých mohou určit konzistentní a společný vzhled všech ovládacích prvků součástí. Mezi vlastnosti, které se vztahují k chromu ovládacích prvků zóny, patří PartChromeStylePartChromeTypePartStyle, , a .PartTitleStyle Všimněte si, že většina vlastností souvisejících s chromem, včetně konkrétní vlastnosti odkazování na objekt chrome pro konkrétní typ zóny, není v základní WebZone třídě implementována. Místo toho je většina chromově specifických funkcí zón implementována u konkrétních typů zón podle jedinečných potřeb jejich ovládacích prvků. Projděte si témata pro jednotlivé typy zón uvedené v předchozí tabulce tohoto tématu. |
| Ovládací prvky části | Ovládací prvky, které se nacházejí v části těla zóny. Každá zóna, která dědí z WebZone třídy , obsahuje ve svém těle jednu nebo více částí ovládacích prvků odpovídajícího typu, jak je znázorněno v předchozí tabulce v tomto tématu. Tyto ovládací prvky částí tvoří hlavní uživatelské rozhraní aplikací webových částí. Většina typů zón, které jsou odvozeny zWebZone, má kolekci vlastnost, která jim umožňuje odkazovat na WebPartZoneBase všechny jejich obsažené části ovládací prvky, jako WebParts je například vlastnost třídy a EditorParts vlastnost třídyEditorZoneBase. |
| Zápatí | Dolní část zóny. Podobně jako oddíl záhlaví se nenachází ve všech typech zón, ale obvykle se vyskytuje v ToolZone zónách. Typickým obsahem oddílu zápatí jsou příkazy, jako je sloveso OK nebo použít, které se zobrazují v zápatí EditorZoneBase zón. Mezi vlastnosti, které se vztahují k oddílu zápatí, patří HasFootervlastnosti , FooterStyleVerbButtonType, a VerbStyle . |
WebZone Většina vlastností třídy je popsána v předchozí tabulce, která popisuje společné prvky uživatelského rozhraní zón. Třída WebZone má také několik metod souvisejících s její rolí vykreslování obsahu. Všechny RenderBodymetody , RenderContents, RenderFooter, a RenderHeader lze přepsat, aby poskytovaly programovou kontrolu nad vykreslováním každé konkrétní části zóny. Pokud například chcete přizpůsobit vykreslování všech oddílů zápatí zón katalogu ve vaší aplikaci, můžete dědit z CatalogZoneBase třídy , přepsat metodu RenderFooter zděděnou z WebZonea změnit vykreslování oddílu zápatí.
Poznámky pro implementátory
Zřídka je nutné dědit přímo z WebZone třídy pro vývoj vlastních zón webových částí. Sada ovládacích prvků webové části obsahuje specializované zóny uvedené výše v oddílu Poznámky a obvykle můžete odvodit jednu z nich a přidat do zóny vlastní chování. Pokud se rozhodnete dědit přímo z WebZone třídy, musíte přepsat řadu vlastností a metod (viz dokumentace pro členy WebZone třídy). Musíte také vytvořit vlastní WebPartManager ovládací prvek, volitelně vlastní WebPartDisplayMode ovládací prvek pro vytvoření jedinečného režimu zobrazení, ve kterém chcete zobrazit vaši zónu, a další přizpůsobení, aby zóna fungovala v sadě ovládacích prvků webových částí.
Vlastnosti
| AccessKey |
Získá nebo nastaví přístupový klíč, který umožňuje rychle přejít na ovládací prvek webového serveru. (Zděděno od WebControl) |
| Adapter |
Získá adaptér specifický pro prohlížeč pro ovládací prvek. (Zděděno od Control) |
| AppRelativeTemplateSourceDirectory |
Získá nebo nastaví aplikace relativní virtuální adresář nebo UserControl objektuPage, který obsahuje tento ovládací prvek. (Zděděno od Control) |
| Attributes |
Získá kolekci libovolných atributů (pouze pro vykreslování), které neodpovídají vlastnostem ovládacího prvku. (Zděděno od WebControl) |
| BackColor |
Získá nebo nastaví barvu pozadí ovládacího prvku webového serveru. (Zděděno od WebControl) |
| BackImageUrl |
Získá nebo nastaví adresu URL na obrázek pozadí pro zónu. |
| BindingContainer |
Získá ovládací prvek, který obsahuje datové vazby tohoto ovládacího prvku. (Zděděno od Control) |
| BorderColor |
Získá nebo nastaví barvu ohraničení webového ovládacího prvku. (Zděděno od WebControl) |
| BorderStyle |
Získá nebo nastaví styl ohraničení ovládacího prvku webového serveru. (Zděděno od WebControl) |
| BorderWidth |
Získá nebo nastaví šířku ohraničení ovládacího prvku webového serveru. (Zděděno od WebControl) |
| 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í 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 v objektu CompositeControl. (Zděděno od CompositeControl) |
| ControlStyle |
Získá styl ovládacího prvku webového serveru. Tuto vlastnost používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| ControlStyleCreated |
Získá hodnotu označující, zda Style objekt byl vytvořen pro ControlStyle vlastnost. Tuto vlastnost primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl) |
| CssClass |
Získá nebo nastaví css (CSS) třídy vykreslované webový server ovládací prvek v klientovi. (Zděděno od WebControl) |
| 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) |
| EmptyZoneText |
Získá nebo nastaví zprávu, která se zobrazí, když zóna neobsahuje žádné ovládací prvky. |
| EmptyZoneTextStyle |
Získá atributy stylu pro zástupný text v prázdné zóně. |
| Enabled |
Získá nebo nastaví hodnotu označující, zda je povolený ovládací prvek webového serveru. (Zděděno od WebControl) |
| EnableTheming |
Získá nebo nastaví hodnotu označující, zda motivy použít pro tento ovládací prvek. (Zděděno od WebControl) |
| 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, pro žádajícího klienta. (Zděděno od Control) |
| ErrorStyle |
Získá atributy stylu pro vykreslení chybové zprávy, která se zobrazí, pokud WebPart nelze načíst nebo vytvořit ovládací prvek. |
| 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) |
| Font |
Získá vlastnosti písma přidružené k ovládacímu prvku webového serveru. (Zděděno od WebControl) |
| FooterStyle |
Získá atributy stylu pro obsah oblasti zápatí zóny. |
| ForeColor |
Získá nebo nastaví barvu popředí (obvykle barvu textu) ovládacího prvku webového serveru. (Zděděno od WebControl) |
| HasAttributes |
Získá hodnotu označující, zda ovládací prvek má nastaveny atributy. (Zděděno od WebControl) |
| HasChildViewState |
Získá hodnotu označující, zda podřízené ovládací prvky aktuálního serveru mají uložené nastavení stavu zobrazení. (Zděděno od Control) |
| HasFooter |
Získá hodnotu označující, zda má zóna oblast zápatí. |
| HasHeader |
Získá hodnotu označující, zda má zóna oblast záhlaví. |
| HeaderStyle |
Získá atributy stylu pro obsah oblasti záhlaví zóny. |
| HeaderText |
Získá nebo nastaví text pro oblast záhlaví zóny. |
| Height |
Získá nebo nastaví výšku ovládacího prvku webového serveru. (Zděděno od WebControl) |
| 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) |
| IsEnabled |
Získá hodnotu označující, zda je ovládací prvek povolen. (Zděděno od WebControl) |
| 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 pro tento ovládací prvek povolen stav zobrazení. (Zděděno od Control) |
| LoadViewStateByID |
Získá hodnotu označující, zda se ovládací prvek účastní načítání stavu ID zobrazení místo indexu. (Zděděno od Control) |
| NamingContainer |
Získá odkaz na názvový kontejner ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro rozdíl mezi serverovými ovládacími prvky se stejnou ID hodnotou vlastnosti. (Zděděno od Control) |
| Padding |
Získá nebo nastaví atributy odsazení buňky v tabulce, která obsahuje WebPart ovládací prvky v zóně. |
| Page |
Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek. (Zděděno od Control) |
| Parent |
Získá odkaz na serverový ovládací prvek nadřazený ovládací prvek v hierarchii ovládacích prvků stránky. (Zděděno od Control) |
| PartChromePadding |
Získá nebo nastaví vzdálenost mezi obsahem WebPart ovládacího prvku a ohraničení ovládacího prvku. |
| PartChromeStyle |
Získá vlastnosti stylu, které platí pro ohraničení webových částí ovládacích prvků obsažených v zóně. |
| PartChromeType |
Získá nebo nastaví typ ohraničení, který rámuje webové části ovládací prvky obsažené v zóně. |
| PartStyle |
Získá vlastnosti stylu, které platí pro ohraničení a obsah každé webové části ovládacího prvku obsaženého v zóně. |
| PartTitleStyle |
Získá atributy stylu pro záhlaví obsahu pro každý webových částí ovládací prvek obsažený v zóně. |
| RenderClientScript |
Získá hodnotu, která označuje, zda vykreslit klientský skript na stránce webových částí. |
| RenderingCompatibility |
Získá hodnotu, která určuje ASP.NET verze, která vykreslí 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 WebControl) |
| Style |
Získá kolekci text atributů, které budou vykresleny jako atribut stylu na vnější značku webového serveru ovládacího prvku. (Zděděno od WebControl) |
| SupportsDisabledAttribute |
Získá hodnotu, která označuje, zda má ovládací prvek nastavit |
| TabIndex |
Získá nebo nastaví index tabulátoru ovládacího prvku webového serveru. (Zděděno od WebControl) |
| TagKey |
HtmlTextWriterTag Získá hodnotu, která odpovídá ovládacího prvku webového serveru. Tuto vlastnost používají primárně vývojáři ovládacích prvků. |
| TagName |
Získá název značky ovládacího prvku. Tuto vlastnost používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| 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) |
| ToolTip |
Získá nebo nastaví text zobrazený, když ukazatel myši najede na ovládací prvek webového serveru. (Zděděno od WebControl) |
| 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) |
| VerbButtonType |
Získá nebo nastaví, jaký druh tlačítka se používá k reprezentaci sloves v zóně. |
| VerbStyle |
Získá atributy stylu pro uživatelské rozhraní (UI) příkazy přidružené k ovládacím prvkům webových částí v zóně. |
| 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) |
| WebPartManager |
Získá odkaz na WebPartManager ovládací prvek přidružený WebZone k instanci ovládacího prvku na stránce webových částí. |
| Width |
Získá nebo nastaví šířku ovládacího prvku webového serveru. (Zděděno od WebControl) |
Metody
| AddAttributesToRender(HtmlTextWriter) |
Přidá atributy a styly HTML, které je potřeba vykreslit na zadaný HtmlTextWriterTag. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| 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 prvek XML nebo HTML, a přidá element do objektu ovládacího prvku ControlCollection serveru. (Zděděno od Control) |
| ApplyStyle(Style) |
Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku a přepíše všechny existující prvky stylu ovládacího prvku. Tuto metodu primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl) |
| ApplyStyleSheetSkin(Page) |
Použije vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek. (Zděděno od Control) |
| BeginRenderTracing(TextWriter, Object) |
Zahájí trasování vykreslování dat v době návrhu. (Zděděno od Control) |
| BuildProfileTree(String, Boolean) |
Shromáždí informace o ovládacím prvku serveru a doručí je do Trace vlastnosti, která se má zobrazit, když je pro stránku povolené trasování. (Zděděno od Control) |
| ClearCachedClientID() |
Nastaví hodnotu v ClientID mezipaměti na |
| ClearChildControlState() |
Odstraní informace o stavu řízení 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í všech podřízených ovládacích prvků 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) |
| CopyBaseAttributes(WebControl) |
Zkopíruje vlastnosti, které nejsou zapouzdřeny objektem Style ze zadaného ovládacího prvku webového serveru do ovládacího prvku webového serveru, ze kterého je volána tato metoda. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| CreateChildControls() |
Volá se rozhraním ASP.NET stránky, aby upozornily ovládací prvky serveru, 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 publikování zpět nebo vykreslování. (Zděděno od Control) |
| CreateControlCollection() |
Vytvoří nový ControlCollection objekt, který bude obsahovat podřízené ovládací prvky (literál i server) serverového ovládacího prvku. (Zděděno od Control) |
| CreateControlStyle() |
Vytvoří objekt stylu, který se interně používá třídy k implementaci všech vlastností souvisejících se stylem WebControl . Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| DataBind() |
Sváže zdroj dat se CompositeControl všemi jeho podřízenými ovládacími prvky. (Zděděno od CompositeControl) |
| DataBind(Boolean) |
Vytvoří vazbu zdroje dat na vyvoláný 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() |
Sváže zdroj dat s podřízenými ovládacími prvky serverového ovládacího prvku. (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í vykreslovaných dat v době návrhu. (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 ovládacích prvků, 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 kontejneru pojmenování serverový ovládací prvek pomocí zadaného |
| FindControl(String, Int32) |
Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek se zadaným |
| 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) |
| GetEffectiveChromeType(Part) |
Vrátí skutečnou nebo platnou WebPart aktuální PartChromeType hodnotu ovládacího prvku vzhledem k PartChromeType vlastnosti zóny a aktuálnímu režimu zobrazení stránky webových částí. |
| 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() |
Získá aktuální Type instanci. (Zděděno od Object) |
| GetUniqueIDRelativeTo(Control) |
Vrátí předponu vlastnosti UniqueID zadaného ovládacího prvku. (Zděděno od Control) |
| HasControls() |
Určuje, jestli 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, jestli 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) |
Načte dříve uložené informace o stavu pro zónu. |
| 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) |
| MergeStyle(Style) |
Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku, ale nepřepíše žádné existující prvky stylu ovládacího prvku. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| OnBubbleEvent(Object, EventArgs) |
Určuje, zda je událost serverového ovládacího prvku předána hierarchii ovládacích prvků 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. |
| OnLoad(EventArgs) |
Load Vyvolá událost. (Zděděno od Control) |
| OnPreRender(EventArgs) |
PreRender Vyvolá událost. |
| OnUnload(EventArgs) |
Unload Vyvolá událost. (Zděděno od Control) |
| OpenFile(String) |
Stream Získá zvyk 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) |
| RecreateChildControls() |
Znovu vytvoří podřízené ovládací prvky v ovládacím prvku odvozeného z CompositeControl. (Zděděno od CompositeControl) |
| 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 CompositeControl obsah do zadaného HtmlTextWriter objektu pro zobrazení na klientovi. (Zděděno od CompositeControl) |
| RenderBeginTag(HtmlTextWriter) |
Vykreslí levou značku HTML ovládacího prvku zóny na zadaný HtmlTextWriter objekt. |
| RenderBody(HtmlTextWriter) |
Přepíše vykreslování pro tělo ovládacího prvku zóny. |
| 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 v klientovi. (Zděděno od Control) |
| RenderContents(HtmlTextWriter) |
Vykreslí celý obsah ovládacího prvku zóny mezi počátečními a koncovými značkami určenému objektu HtmlTextWriter . |
| RenderControl(HtmlTextWriter) |
Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povolené. (Zděděno od Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu. (Zděděno od Control) |
| RenderEndTag(HtmlTextWriter) |
Vykreslí koncovou značku HTML ovládacího prvku do zadaného zapisovače. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| RenderFooter(HtmlTextWriter) |
Přepíše vykreslování pro zápatí ovládacího prvku zóny. |
| RenderHeader(HtmlTextWriter) |
Přepíše vykreslování záhlaví ovládacího prvku zóny. |
| ResolveAdapter() |
Získá řídicí adaptér 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ího prvku 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í, ke kterým došlo po odeslání stránky zpět na server. |
| 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, který vykresluje serverový ovládací prvek a jeho obsah 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í klíče dat 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() |
Sleduje změny stavu zobrazení ovládacího prvku zóny. |
Událost
| DataBinding |
Nastane, když ovládací prvek serveru vytvoří vazbu na zdroj dat. (Zděděno od Control) |
| Disposed |
Nastane 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 stránka ASP.NET. (Zděděno od Control) |
| 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 při načtení serverového ovládacího prvku 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 při uvolnění serverového ovládacího prvku z paměti. (Zděděno od Control) |
Explicitní implementace rozhraní
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. |
| GetDefaultValues(INamingContainer) |
Získá kolekci výchozích hodnot pro zadaný datový ovládací prvek. |
| GetMetaTable(INamingContainer) |
Získá metadata tabulky pro zadaný datový ovládací prvek. |
| SetMetaTable(INamingContainer, MetaTable) |
Nastaví metadata tabulky pro zadaný ovládací prvek dat. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Nastaví metadata tabulky a mapování výchozích hodnot pro zadaný ovládací prvek dat. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Nastaví metadata tabulky a mapování výchozích hodnot pro zadaný ovládací prvek dat. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Určuje, jestli jsou k dispozici metadata tabulky. |
| EnableDynamicData(INamingContainer, Type) |
Povolí chování dynamických dat pro zadaný datový ovládací prvek. |
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Povolí chování dynamických dat pro zadaný datový ovládací prvek. |
| EnableDynamicData(INamingContainer, Type, Object) |
Povolí chování dynamických dat pro zadaný datový ovládací prvek. |
Platí pro
Viz také
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro