WebPart 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 vlastní ovládací prvky webových částí ASP.NET, přidání do základních Part vlastností třídy některé další vlastnosti uživatelského rozhraní, schopnost vytvářet připojení a chování přizpůsobení.
public ref class WebPart abstract : System::Web::UI::WebControls::WebParts::Part, System::Web::UI::WebControls::WebParts::IWebActionable, System::Web::UI::WebControls::WebParts::IWebEditable, System::Web::UI::WebControls::WebParts::IWebPart
public abstract class WebPart : System.Web.UI.WebControls.WebParts.Part, System.Web.UI.WebControls.WebParts.IWebActionable, System.Web.UI.WebControls.WebParts.IWebEditable, System.Web.UI.WebControls.WebParts.IWebPart
type WebPart = class
inherit Part
interface IWebPart
interface IWebActionable
interface IWebEditable
Public MustInherit Class WebPart
Inherits Part
Implements IWebActionable, IWebEditable, IWebPart
- Dědičnost
- Odvozené
- Implementuje
Příklady
Následující příklad kódu ukazuje, jak vytvořit WebPart ovládací prvek a odkazovat na něj na webové stránce.
První část příkladu obsahuje kód vlastního ovládacího prvku WebPart s názvem TextDisplayWebPart. Tento ovládací prvek ukazuje, jak vytvořit jednoduchý vlastní WebPart ovládací prvek, který poskytuje přístup k funkcím sady ovládacích částí webových částí. Pro spuštění příkladu kódu je nutné zkompilovat tento zdrojový kód. Můžete jej explicitně zkompilovat a výsledné sestavení umístit do složky Bin vašeho webu nebo globální mezipaměti sestavení. Případně můžete zdrojový kód umístit do složky App_Code webu, kde se bude dynamicky kompilovat za běhu. Tento příklad kódu předpokládá, že zkompilujete zdrojový kód do sestavení, umístíte ho do podsložky Bin webové aplikace a odkazujete na sestavení se direktivou Register na webové stránce. Návod, který ukazuje obě metody kompilace, naleznete v části 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 TextDisplayWebPart : WebPart
{
private String _contentText = null;
TextBox input;
Label DisplayContent;
public TextDisplayWebPart()
{
this.AllowClose = false;
}
[Personalizable(), WebBrowsable]
public String ContentText
{
get { return _contentText; }
set { _contentText = value; }
}
protected override void CreateChildControls()
{
Controls.Clear();
DisplayContent = new Label();
DisplayContent.BackColor =
System.Drawing.Color.LightBlue;
DisplayContent.Text = this.ContentText;
this.Controls.Add(DisplayContent);
input = new TextBox();
this.Controls.Add(input);
Button update = new Button();
update.Text = "Set Label Content";
update.Click += new EventHandler(this.submit_Click);
this.Controls.Add(update);
ChildControlsCreated = true;
}
private void submit_Click(object sender, EventArgs e)
{
// Update the label string.
if (!string.IsNullOrEmpty(input.Text))
{
_contentText = input.Text + @"<br />";
input.Text = String.Empty;
DisplayContent.Text = this.ContentText;
}
}
}
}
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 TextDisplayWebPart
Inherits WebPart
Private _contentText As String = Nothing
Private input As TextBox
Private DisplayContent As Label
Public Sub New()
Me.AllowClose = False
End Sub
<Personalizable(), WebBrowsable()> _
Public Property ContentText() As String
Get
Return _contentText
End Get
Set
_contentText = value
End Set
End Property
Protected Overrides Sub CreateChildControls()
Controls.Clear()
DisplayContent = New Label()
DisplayContent.Text = Me.ContentText
DisplayContent.BackColor = _
System.Drawing.Color.LightBlue
Me.Controls.Add(DisplayContent)
input = New TextBox()
Me.Controls.Add(input)
Dim update As New Button()
update.Text = "Set Label Content"
AddHandler update.Click, AddressOf Me.submit_Click
Me.Controls.Add(update)
ChildControlsCreated = True
End Sub
Private Sub submit_Click(ByVal sender As Object, _
ByVal e As EventArgs)
' Update the label string.
If input.Text <> String.Empty Then
_contentText = input.Text & "<br />"
input.Text = String.Empty
DisplayContent.Text = Me.ContentText
End If
End Sub
End Class
End Namespace
Druhá část příkladu ukazuje, jak odkazovat na TextDisplayWebPart ovládací prvek na webové stránce ASP.NET. Všimněte si, že mnoho různých vlastností WebPart lze deklarativnímu přiřazení vlastního ovládacího prvku.
<%@ page language="C#" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.CS.Controls"
Assembly="TextDisplayWebPartCS"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<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" />
<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:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart" />
</zonetemplate>
</asp:webpartzone>
</form>
</body>
</html>
<%@ page language="VB" %>
<%@ register tagprefix="aspSample"
Namespace="Samples.AspNet.VB.Controls"
Assembly="TextDisplayWebPartVB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<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" />
<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:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart" />
</zonetemplate>
</asp:webpartzone>
</form>
</body>
</html>
Poznámky
Při vytváření ovládacích prvků s funkcemi webových částí máte dvě základní možnosti. Můžete vytvořit vlastní ovládací prvky, které jsou odvozeny z WebPart třídy, nebo můžete vytvořit nebo použít jiné ovládací prvky serveru. Existující ovládací prvky ASP.NET, vlastní serverové ovládací prvky a uživatelské ovládací prvky mohou být všechny plně vybaveny webovými částmi tím, že je deklarují v rámci ovládacího prvku WebPartZone zóny (nebo je do nich přidáte programově) s výsledkem, že se zabalí s GenericWebPart objekty za běhu a budou považovány za pravdivé ovládací prvky WebPart. Podrobnosti najdete v dokumentaci pro GenericWebPart třídu. Pro rychlost vývoje a maximální opakované použití kódu může být dobrou volbou použití existujících ovládacích prvků serveru. Pro maximální programovou kontrolu nad chováním a funkcemi webových částí ovládacích prvků je často nejlepší volbou vytvoření vlastního ovládacího prvku, který dědí z třídy WebPart.
Abstraktní WebPart třída dědí ze základního Part ovládacího prvku a poskytuje základní prvky pro všechny ovládací prvky WebPart. Třída obsahuje společnou sadu vlastností, které ovlivňují vzhled uživatelského rozhraní. Vlastnosti AllowClose, AllowConnect, AllowEdit, AllowHide, AllowMinimizea AllowZoneChange určují, zda má uživatel webové aplikace povoleno pracovat s ovládacím prvku části způsobem uvedeným v názvu dané vlastnosti. Vlastnosti CatalogIconImageUrl, ChromeState, ChromeType, Description, Height, HelpUrl, Hidden, Title, TitleIconImageUrl, TitleUrla Width určují velikost, viditelnost, vzhled a podpůrný obsah (například název a popis) pro ovládací prvek WebPart.
Vztah ovládacího prvku WebPart k jeho kontextu v rámci sady ovládacích částí webových částí je určen vlastnostmi, jako je WebPartManager, který obsahuje odkaz na přidružený WebPartManager ovládacího prvku a Zone, který odkazuje na WebZone, který obsahuje ovládací prvek. Na stránce může existovat jenom jeden ovládací prvek WebPartManager a každá instance ovládacího prvku WebPart se může najednou nacházet pouze v jednom WebZone.
Note
Ovládací prvek WebPart lze umístit mimo zónu na webové stránce, ale v tomto případě funguje jako normální serverový ovládací prvek a ztratí téměř všechny funkce webových částí.
Několik dalších důležitých vlastností ovlivňuje jedinečné funkce ovládacích prvků WebPart. Vlastnost AuthorizationFilter umožňuje vývojářům nastavit libovolný řetězec, který lze použít jako filtr za běhu k určení, zda je ovládací prvek přidán na stránku. Společně s funkcí, jako je správa rolí, poskytuje vlastnost AuthorizationFilter užitečný mechanismus pro vytváření zobrazení na základě definovaných uživatelských rolí. Vlastnost ExportMode označuje, zda se během exportu exportují všechna dostupná data vlastností ovládacího prvku, nebo pouze necitlivá data. Vývojáři tak můžou rozlišovat mezi citlivými daty a daty, která nejsou určená pro účely zabezpečení. Vlastnost WebBrowsableObject vrátí odkaz na instanci ovládacího prvku WebPart, aby ho ovládací prvek EditorPart mohl upravovat, když je stránka v režimu úprav. Nakonec existuje několik vlastností, které označují stav ovládacího prvku vzhledem ke zbytku stránky. Vlastnost IsClosed označuje, zda je ovládací prvek zavřený (a tedy přidán do objektu PageCatalogPart), nebo je-li otevřen a k dispozici na stránce. Vlastnost IsShared označuje, zda je ovládací prvek sdílený ovládací prvek (versus ovládací prvek specifický pro uživatele), což znamená, že je viditelný pro všechny uživatele webové stránky. Vlastnost IsStandalone označuje, zda je ovládací prvek aktuálně obsažen v WebPartZoneBase-odvozené zóně (například WebPartZone). Hodnota false označuje, že ovládací prvek je uvnitř zóny a má tak úplné funkce webových částí. Vlastnost IsStatic označuje, zda je ovládací prvek statický nebo dynamický. Statický ovládací prvek je deklarován v kódu webové stránky, zatímco dynamický ovládací prvek je přidán programově.
Třída WebPart také poskytuje několik metod, které určují, co se stane v různých bodech životního cyklu ovládacího prvku. Například metody OnConnectModeChanged a OnEditModeChanged lze přepsat v odvozené třídě, aby poskytovaly programovou kontrolu nad vykreslováním obsahu ovládacího prvku během události, která odpovídá názvu každé metody.
Třídy odvozené z WebPart mohou do kolekce WebPartVerb přidat Verbs objekty. Příkazy se vykreslují v nabídce sloves, která se zobrazí v záhlaví ovládacího prvku WebPart. WebPartVerb objekty poskytují jednoduché prvky uživatelského rozhraní pro běžné uživatelské akce, jako je skrytí nebo minimalizace ovládacího prvku nebo zobrazení nápovědy.
Metoda CreateEditorParts vytvoří kolekci všech vlastních ovládacích prvků EditorPart přidružených k ovládacímu prvku WebPart. Vývojáři mohou tuto metodu přepsat tak, aby vytvořily vlastní ovládací prvky navržené speciálně pro úpravu WebPart ovládacího prvku. Metoda se volá, když uživatel klikne na příkaz upravit v ovládacím prvku WebPart.
Konstruktory
| Name | Description |
|---|---|
| WebPart() |
Inicializuje třídu pro použití zděděnou instancí třídy. Tento konstruktor lze volat pouze zděděnou třídou. |
Vlastnosti
| Name | Description |
|---|---|
| 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) |
| AllowClose |
Získá nebo nastaví hodnotu určující, zda koncový uživatel může zavřít WebPart ovládací prvek na webové stránce. |
| AllowConnect |
Získá nebo nastaví hodnotu, která určuje, zda WebPart ovládací prvek umožňuje jiným ovládacím prvkům vytvořit spojení s ním. |
| AllowEdit |
Získá nebo nastaví hodnotu označující, zda koncový uživatel může změnit WebPart ovládací prvek prostřednictvím uživatelského rozhraní (UI), který poskytuje jeden nebo více EditorPart ovládacích prvků. |
| AllowHide |
Získá nebo nastaví hodnotu určující, zda koncoví uživatelé mohou skrýt WebPart ovládací prvek. |
| AllowMinimize |
Získá nebo nastaví hodnotu označující, zda koncoví uživatelé mohou minimalizovat WebPart ovládací prvek. |
| AllowZoneChange |
Získá nebo nastaví hodnotu určující, zda uživatel může přesunout WebPart ovládací prvek mezi WebPartZoneBase zónami. |
| 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) |
| Attributes |
Získá kolekci libovolných atributů (pouze pro vykreslování), které neodpovídají vlastnostem ovládacího prvku. (Zděděno od WebControl) |
| AuthorizationFilter |
Získá nebo nastaví libovolný řetězec k určení, zda WebPart je ovládací prvek autorizovaný k přidání na stránku. |
| 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 obrázku pozadí pro ovládací prvek panelu. (Zděděno od Panel) |
| BindingContainer |
Získá ovládací prvek, který obsahuje datovou vazbu 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) |
| CatalogIconImageUrl |
Získá nebo nastaví adresu URL na obrázek, který představuje ovládací prvek webové části v katalogu ovládacích prvků. |
| 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) |
| ChromeState |
Získá nebo nastaví, zda je ovládací prvek části v minimalizovaném nebo normálním stavu. |
| ChromeType |
Získá nebo nastaví typ ohraničení, které rámuje ovládací prvek webové části. |
| 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) |
| ConnectErrorMessage |
Získá chybovou zprávu, která se zobrazí uživatelům, pokud dojde k chybám během procesu připojení. |
| 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ý obsahuje podřízené ovládací prvky pro zadaný server řízení v hierarchii uživatelského rozhraní. (Zděděno od Part) |
| ControlStyle |
Získá styl ovládacího prvku webového serveru. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebControl) |
| ControlStyleCreated |
Získá hodnotu urč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í cascading style sheet (CSS) třídy vykreslované ovládacím prvkem webového serveru v klientovi. (Zděděno od WebControl) |
| 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) |
| DefaultButton |
Získá nebo nastaví identifikátor pro výchozí tlačítko, které je obsaženo v ovládacím Panel prvku. (Zděděno od Panel) |
| Description |
Získá nebo nastaví stručnou frázi, která shrnuje, co ovládací prvek části dělá, pro použití v popisech a katalogech ovládacích prvků částí. |
| DesignMode |
Získá hodnotu určující, zda se ovládací prvek používá na návrhové ploše. (Zděděno od Control) |
| Direction |
Získá nebo nastaví vodorovný směr, který obsah proudí v rámci ovládacího prvku. |
| DisplayTitle |
Získá řetězec, který obsahuje celý název text skutečně zobrazen v záhlaví WebPart instance ovládacího prvku. |
| Enabled |
Získá nebo nastaví hodnotu určující, zda je ovládací prvek webového serveru povolen. (Zděděno od WebControl) |
| EnableTheming |
Získá nebo nastaví hodnotu označující, zda motivy platí 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, 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 pouze pro čtení. (Zděděno od Control) |
| ExportMode |
Získá nebo nastaví, zda lze exportovat všechny, některé nebo žádné vlastnosti WebPart ovládacího prvku. |
| Font |
Získá vlastnosti písma přidružené k webovému serveru ovládacího prvku. (Zděděno od WebControl) |
| ForeColor |
Získá nebo nastaví barvu popředí (obvykle barvu textu) ovládacího prvku webového serveru. (Zděděno od WebControl) |
| GroupingText |
Získá nebo nastaví titulek pro skupinu ovládacích prvků, které jsou obsaženy v ovládacím prvku panelu. (Zděděno od Panel) |
| HasAttributes |
Získá hodnotu určující, zda ovládací prvek má nastaveny atributy. (Zděděno od WebControl) |
| 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) |
| HasSharedData |
Získá hodnotu, která označuje, zda WebPart má ovládací prvek nějaké sdílené osobní údaje přidružené k němu. |
| HasUserData |
Získá hodnotu, která určuje, zda WebPart ovládací prvek má přidružená nějaká data přizpůsobení uživatele. |
| Height |
Získá nebo nastaví výšku zóny. |
| HelpMode |
Získá nebo nastaví typ uživatelského rozhraní (UI) použitý k zobrazení obsahu nápovědy pro WebPart ovládací prvek. |
| HelpUrl |
Získá nebo nastaví adresu URL na soubor nápovědy pro WebPart ovládací prvek. |
| Hidden |
Získá nebo nastaví hodnotu určující, zda WebPart je ovládací prvek zobrazen na webové stránce. |
| HorizontalAlign |
Získá nebo nastaví vodorovné zarovnání obsahu v panelu. (Zděděno od Panel) |
| 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) |
| ImportErrorMessage |
Získá nebo nastaví chybovou zprávu, která se používá, pokud dojde k chybám při importu WebPart ovládacího prvku. |
| 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) |
| IsClosed |
Získá hodnotu, která určuje, zda WebPart je ovládací prvek aktuálně uzavřen na stránce webových částí. |
| IsEnabled |
Získá hodnotu označující, zda je ovládací prvek povolen. (Zděděno od WebControl) |
| IsShared |
Získá hodnotu, která určuje, zda WebPart je ovládací prvek sdílený, což znamená, že je viditelné pro všechny uživatele stránky webových částí. |
| IsStandalone |
Získá hodnotu, která označuje, zda WebPart je ovládací prvek samostatný, což znamená, že není obsažen v WebPartZoneBase zóně. |
| IsStatic |
Získá hodnotu, která označuje, zda WebPart je ovládací prvek statický ovládací prvek, což znamená, že ovládací prvek je deklarován v kódu stránky webových částí a není přidán na stránku programově. |
| 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) |
| 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) |
| ScrollBars |
Získá nebo nastaví viditelnost a pozici posuvníků v ovládacím Panel prvku. (Zděděno od Panel) |
| 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 WebControl) |
| Style |
Získá kolekci text atributy, které budou vykresleny jako atribut stylu na vnější značce webového serveru ovládacího prvku. (Zděděno od WebControl) |
| Subtitle |
Získá řetězec, který je zřetězen s Title hodnotou vlastnosti vytvořit úplný název WebPart ovládacího prvku. |
| SupportsDisabledAttribute |
Získá hodnotu, která určuje, zda ovládací prvek má nastavit |
| TabIndex |
Získá nebo nastaví index karty ovládacího prvku webového serveru. (Zděděno od WebControl) |
| TagKey |
Získá hodnotu, která odpovídá tomuto ovládacímu HtmlTextWriterTag prvku webového serveru. Tuto vlastnost používají primárně vývojáři ovládacích prvků. (Zděděno od WebControl) |
| TagName |
Získá název značky ovládacího prvku. Tuto vlastnost používají primárně 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 řízení. (Zděděno od Control) |
| Title |
Získá nebo nastaví název ovládacího prvku části. |
| TitleIconImageUrl |
Získá nebo nastaví adresu URL na obrázek použitý k reprezentaci ovládacího prvku webové části v záhlaví ovládacího prvku. |
| TitleUrl |
Získá nebo nastaví adresu URL na doplňující informace o ovládacím WebPart prvku. |
| ToolTip |
Získá nebo nastaví text zobrazený, když ukazatel myši najede myší na ovládací prvek webového serveru. (Zděděno od WebControl) |
| 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) |
| Verbs |
Získá kolekci vlastních sloves přidružených k ovládacímu WebPart prvku. |
| 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) |
| WebBrowsableObject |
Získá odkaz na WebPart ovládací prvek, který umožňuje jeho úpravu vlastními EditorPart ovládacími prvky. |
| WebPartManager |
Získá odkaz na WebPartManager ovládací prvek přidružený k WebPart instanci ovládacího prvku. |
| Width |
Získá nebo nastaví šířku ovládacího prvku webového serveru. |
| Wrap |
Získá nebo nastaví hodnotu určující, zda se obsah zalamuje v panelu. (Zděděno od Panel) |
| Zone |
Získá zónu WebPartZoneBase , která aktuálně obsahuje WebPart ovládací prvek. |
| ZoneIndex |
Získá pozici indexu WebPart ovládacího prvku v rámci jeho zóny. |
Metody
| Name | Description |
|---|---|
| AddAttributesToRender(HtmlTextWriter) |
Přidá informace o obrázku pozadí, zarovnání, obtékání a směru do seznamu atributů, které se mají vykreslit. (Zděděno od Panel) |
| 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) |
| 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) |
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) |
| 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 tato metoda volána. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl) |
| 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) |
| CreateControlStyle() |
Vytvoří objekt stylu, který se interně používá ovládacím Panel prvku k implementaci všech vlastností souvisejících se stylem. (Zděděno od Panel) |
| CreateEditorParts() |
Vrátí kolekci vlastních EditorPart ovládacích prvků, které lze použít k úpravě WebPart ovládacího prvku v režimu úprav. |
| DataBind() |
Vytvoří vazbu zdroje dat na vyvolaný ovládací prvek serveru a všechny jeho podřízené ovládací prvky. (Zděděno od Part) |
| 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) |
| 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) |
| 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) |
| GetDesignModeState() |
Získá data v době návrhu pro ovládací prvek. (Zděděno od Control) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (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á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) |
| IsLiteralContent() |
Určuje, zda ovládací prvek serveru obsahuje pouze literálový obsah. (Zděděno od Control) |
| 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) |
| LoadViewState(Object) |
Obnoví informace o stavu zobrazení z předchozího požadavku, který byl uložen s metodou SaveViewState() . (Zděděno od WebControl) |
| 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) |
| 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í primárně vývojáři řízení. (Zděděno od WebControl) |
| 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) |
| OnClosing(EventArgs) |
Umožňuje odvozené třídy poskytovat vlastní zpracování při WebPart zavření ovládacího prvku na stránce webových částí. |
| OnConnectModeChanged(EventArgs) |
Umožňuje odvozené třídy poskytovat vlastní zpracování při WebPart zahájení nebo ukončení procesu připojení k jiným ovládacím prvkům. |
| OnDataBinding(EventArgs) |
DataBinding Vyvolá událost. (Zděděno od Control) |
| OnDeleting(EventArgs) |
Umožňuje odvozené třídy poskytovat vlastní zpracování při WebPart trvalém odebrání ovládacího prvku ze stránky webových částí. |
| OnEditModeChanged(EventArgs) |
Umožňuje odvozené třídy poskytovat vlastní zpracování, když WebPart ovládací prvek zadává nebo opouští režim úprav. |
| 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žité 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ího 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) |
Vykreslí ovládací prvek na zadaný zapisovač HTML. (Zděděno od WebControl) |
| RenderBeginTag(HtmlTextWriter) |
Vykreslí počáteční značku Panel HTML ovládacího prvku určenému zapisovači. (Zděděno od Panel) |
| 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) |
| RenderContents(HtmlTextWriter) |
Vykreslí obsah ovládacího prvku určenému zapisovači. Tuto metodu používají primárně vývojáři řízení. (Zděděno od WebControl) |
| 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) |
| RenderEndTag(HtmlTextWriter) |
Vykreslí zavírací značku Panel HTML ovládacího prvku do zadaného zapisovače. (Zděděno od Panel) |
| 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ží jakýkoli stav, který byl změněn po TrackViewState() vyvolání metody. (Zděděno od WebControl) |
| SetDesignModeState(IDictionary) |
Nastaví data návrhu pro ovládací prvek. (Zděděno od Control) |
| SetPersonalizationDirty() |
Nastaví příznak označující, že se data přizpůsobení pro aktuální WebPart instanci ovládacího prvku změnila. |
| SetPersonalizationDirty(Control) |
Nastaví příznak označující, že se data přizpůsobení změnila pro zadaný ovládací prvek serveru, který se nachází v WebPartZoneBase zóně. |
| 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) |
| 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) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| TrackViewState() |
Způsobí, že ovládací prvek bude sledovat změny stavu zobrazení, aby je bylo možné uložit do vlastnosti objektu ViewState . |
Událost
| Name | Description |
|---|---|
| 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) |
| 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) |
Získá atribut webového ovládacího prvku se zadaným názvem. (Zděděno od WebControl) |
| IAttributeAccessor.SetAttribute(String, String) |
Nastaví atribut webového ovládacího prvku na zadaný název a hodnotu. (Zděděno od WebControl) |
| ICompositeControlDesignerAccessor.RecreateChildControls() |
Umožňuje vývojáři návrháře pro ovládací prvek složené části znovu vytvořit podřízené ovládací prvky ovládacího prvku na návrhové ploše. (Zděděno od Part) |
| 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) |
| IParserAccessor.AddParsedSubObject(Object) |
Popis tohoto člena naleznete v tématu AddParsedSubObject(Object). (Zděděno od Control) |
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. |