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í Part třídy některé další vlastnosti uživatelského rozhraní (UI), možnost 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::IWebPartpublic 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.IWebParttype WebPart = class
inherit Part
interface IWebPart
interface IWebActionable
interface IWebEditablePublic 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 ovládací prvek WebPart a odkazovat na něj na webové stránce.
První část příkladu obsahuje kód pro vlastní WebPart ovládací prvek s názvem TextDisplayWebPart. Tento ovládací prvek ukazuje, jak vytvořit jednoduchý vlastní WebPart ovládací prvek, který vám umožní přístup k funkcím sady ovládacích prvků webových částí. 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. 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 na sestavení odkazujete direktivou Register na webové stránce. 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 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 WebPart vlastností lze vlastní ovládací prvek přiřadit deklarativně.
<%@ 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é serverové ovládací prvky. Stávající ASP.NET ovládací prvky, vlastní serverové ovládací prvky a uživatelské ovládací prvky mohou mít úplnou funkčnost webových částí deklarováním (nebo jejich programovým přidáním do) WebPartZone ovládacího prvku zóny. Výsledkem je, že se za běhu zabalí s GenericWebPart objekty a budou považovány za skutečné WebPart ovládací prvky. Podrobnosti najdete v dokumentaci ke GenericWebPart třídě . Pro rychlost vývoje a maximální opakované použití kódu může být dobrou volbou použití existujících serverových ovládacích prvků. 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 WebPart třídy .
Abstraktní WebPart třída dědí ze základního Part ovládacího prvku a poskytuje základní prvky pro všechny WebPart ovládací prvky. Třída obsahuje společnou sadu vlastností, které ovlivňují vzhled uživatelského rozhraní. Vlastnosti AllowClose, AllowConnect, , AllowHideAllowEdit, AllowMinimizea AllowZoneChange určují, zda má uživatel webové aplikace povoleno pracovat s ovládacím prvku části způsobem, který je určen daným názvem vlastnosti. Vlastnosti CatalogIconImageUrl, ChromeState, , DescriptionChromeType, HeightHelpUrl, Hidden, Title, TitleIconImageUrlTitleUrl, a Width určují velikost, viditelnost, vzhled a podpůrný obsah ovládacího prvku (například název a popis).WebPart
Vztah WebPart ovládacího prvku k jeho kontextu v rámci sady webových částí je určen vlastnostmi, jako WebPartManagerje , který obsahuje odkaz na přidružený WebPartManager objekt ovládacího prvku, a Zone, který odkazuje na WebZone objekt obsahující ovládací prvek. Na každé stránce může existovat pouze jeden WebPartManager ovládací prvek a každá instance WebPart ovládacího prvku se může nacházet vždy jen uvnitř jednoho WebZone ovládacího prvku.
Poznámka
Ovládací WebPart prvek může být umístěn 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é vlastnosti ovládacích WebPart prvků. 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 na stránku přidán ovládací prvek. Vlastnost, která se používá společně s funkcí, jako je správa rolí, AuthorizationFilter poskytuje užitečný mechanismus pro vytváření zobrazení na základě definovaných rolí uživatelů. Vlastnost ExportMode označuje, jestli se během exportu exportují všechna dostupná data vlastností ovládacího prvku, nebo jenom data, která nejsou citlivá. To umožňuje vývojářům rozlišovat mezi daty, která jsou citlivá, a daty, která nejsou, z bezpečnostních důvodů. Vlastnost WebBrowsableObject vrací odkaz na instanci WebPart ovládacího prvku, aby EditorPart jej ovládací prvek 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, jestli je ovládací prvek zavřený (a tím přidaný k objektu PageCatalogPart ), nebo jestli je otevřený a dostupný na stránce. Vlastnost IsShared označuje, zda je ovládací prvek sdílený (oproti ovládacímu prvku specifickému pro uživatele), což znamená, že je viditelný pro všechny uživatele webové stránky. Vlastnost IsStandalone označuje, jestli je ovládací prvek aktuálně obsažen v WebPartZoneBasezóně odvozené od (například WebPartZone). Hodnota označuje false , že ovládací prvek je uvnitř zóny, a proto má plnou funkčnost webových částí. Vlastnost IsStatic označuje, jestli je ovládací prvek statický nebo dynamický. Statický ovládací prvek je deklarován ve značkách 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 OnConnectModeChanged metody a OnEditModeChanged mohou být přepsány 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 přidávat WebPartVerbVerbs objekty. Příkazy se vykreslují v nabídce sloves, která se zobrazí v záhlaví WebPart ovládacího prvku. WebPartVerb Objekty poskytují jednoduché prvky uživatelského rozhraní pro běžné akce uživatele, jako je skrytí nebo minimalizace ovládacího prvku nebo zobrazení nápovědy.
Metoda CreateEditorParts vytvoří kolekci všech vlastních EditorPart ovládacích prvků, které jsou přidruženy k ovládacímu prvku WebPart . Vývojáři mohou tuto metodu přepsat tak, že vytvoří vlastní ovládací prvky určené speciálně k úpravám jejich WebPart ovládacích prvků. Metoda je volána, když uživatel klikne na příkaz upravit u WebPart ovládacího prvku.
Konstruktory
| WebPart() |
Inicializuje třídu pro použití zděděnou instancí třídy. Tento konstruktor může být volána pouze zděděnou třídou. |
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) |
| AllowClose |
Získá nebo nastaví hodnotu určující, zda koncový uživatel může zavřít ovládací prvek WebPart na webové stránce. |
| AllowConnect |
Získá nebo nastaví hodnotu, která označuje, zda WebPart ovládací prvek umožňuje jiným ovládacím prvkům vytvářet připojení s ním. |
| AllowEdit |
Získá nebo nastaví hodnotu označující, zda koncový uživatel může upravit WebPart ovládací prvek prostřednictvím uživatelského rozhraní (UI) poskytované jedním nebo více EditorPart ovládacími prvky. |
| AllowHide |
Získá nebo nastaví hodnotu označující, zda je koncovým uživatelům povoleno skrýt ovládací prvek WebPart . |
| AllowMinimize |
Získá nebo nastaví hodnotu označující, zda koncoví uživatelé mohou minimalizovat ovládací prvek WebPart . |
| AllowZoneChange |
Získá nebo nastaví hodnotu označující, zda uživatel může přesunout ovládací prvek WebPart mezi WebPartZoneBase zónami. |
| 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) |
| AuthorizationFilter |
Získá nebo nastaví libovolný řetězec k určení, zda je ovládací prvek WebPart oprávněn přidat 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 panel. (Zděděno od Panel) |
| 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) |
| CatalogIconImageUrl |
Získá nebo nastaví adresu URL na obrázek, který představuje webové části ovládací prvek 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 součásti v minimalizovaném nebo normálním stavu. |
| ChromeType |
Získá nebo nastaví typ ohraničení, který rámuje webové části ovládací prvek. |
| 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) |
| 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 ovládací prvek 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í 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) |
| DefaultButton |
Získá nebo nastaví identifikátor výchozího tlačítka, který je obsažen 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 součásti dělá, pro použití v popisech a katalogech ovládacích prvků součástí. |
| DesignMode |
Získá hodnotu označující, zda je ovládací prvek použit na návrhové ploše. (Zděděno od Control) |
| Direction |
Získá nebo nastaví vodorovný směr toku obsahu v rámci ovládacího prvku. |
| DisplayTitle |
Získá řetězec, který obsahuje celý text nadpisu skutečně zobrazený v záhlaví instance ovládacího prvku WebPart . |
| 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) |
| 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) |
| 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 ovládacímu prvku webového serveru. (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í popis pro skupinu ovládacích prvků obsažených v ovládacím prvku panel. (Zděděno od Panel) |
| 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) |
| HasSharedData |
Získá hodnotu, která označuje, zda WebPart ovládací prvek má nějaké sdílené personalizace data přidružena k němu. |
| HasUserData |
Získá hodnotu, která označuje, zda WebPart ovládací prvek má jakékoli uživatele personalizace data přidružena k němu. |
| Height |
Získá nebo nastaví výšku zóny. |
| HelpMode |
Získá nebo nastaví typ uživatelského rozhraní (UI) slouží k zobrazení obsahu nápovědy pro ovládací prvek WebPart . |
| HelpUrl |
Získá nebo nastaví adresu URL souboru nápovědy pro ovládací prvek WebPart . |
| Hidden |
Získá nebo nastaví hodnotu označující, zda WebPart je zobrazen ovládací prvek na webové stránce. |
| HorizontalAlign |
Získá nebo nastaví vodorovné zarovnání obsahu v rámci panelu. (Zděděno od Panel) |
| 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) |
| ImportErrorMessage |
Získá nebo nastaví chybovou zprávu, která se použije, pokud dojde k chybám při importu WebPart ovládacího prvku. |
| 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) |
| IsClosed |
Získá hodnotu, která označuje, zda je ovládací prvek WebPart nyní 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á označ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 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) |
| 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) |
| RenderingCompatibility |
Získá hodnotu, která určuje ASP.NET verze, která vykreslí HTML bude kompatibilní s. (Zděděno od Control) |
| ScrollBars |
Získá nebo nastaví viditelnost a umístění posuvníků v ovládacím prvku Panel . (Zděděno od Panel) |
| 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) |
| Subtitle |
Získá řetězec, který je zřetězen s Title hodnotou vlastnosti k vytvoření úplného názvu WebPart ovládacího prvku. |
| 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í především 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í 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) |
| Title |
Získá nebo nastaví název ovládacího prvku součásti. |
| TitleIconImageUrl |
Získá nebo nastaví adresu URL na obrázek, který slouží k reprezentaci webové části ovládací prvek v záhlaví ovládacího prvku. |
| TitleUrl |
Získá nebo nastaví adresu URL pro doplňující informace o ovládacím WebPart prvku. |
| 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) |
| Verbs |
Získá kolekci vlastních sloves přidružených k ovládacímu prvku WebPart . |
| 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) |
| WebBrowsableObject |
Získá odkaz na WebPart ovládací prvek, aby bylo možné jej upravit vlastní EditorPart ovládací prvky. |
| WebPartManager |
Získá odkaz na WebPartManager ovládací prvek přidružený WebPart k instanci ovládacího prvku. |
| Width |
Získá nebo nastaví šířku ovládacího prvku webového serveru. |
| Wrap |
Získá nebo nastaví hodnotu označující, zda se obsah zalomí v panelu. (Zděděno od Panel) |
| Zone |
Získá zónu WebPartZoneBase , která aktuálně obsahuje ovládací prvek WebPart . |
| ZoneIndex |
Získá pozici indexu WebPart ovládacího prvku v rámci jeho zóny. |
Metody
| 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í 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á ovládací prvek k implementaci všech vlastností souvisejících se stylem Panel . (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, když je v režimu úprav. |
| DataBind() |
Vytvoří vazbu zdroje dat na vyvoláný serverový ovládací prvek a všechny jeho podřízené ovládací prvky. (Zděděno od Part) |
| 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) |
| 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) |
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 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) |
| 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í, když WebPart ovládací prvek začíná nebo končí proces 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ým třídám poskytovat vlastní zpracování, když WebPart je ovládací prvek trvale odebrán ze stránky webových částí. |
| OnEditModeChanged(EventArgs) |
Umožňuje odvozeným třídám poskytovat vlastní zpracování, když WebPart ovládací prvek vstupuje 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á 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) |
| 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 do zadaného zapisovače HTML. (Zděděno od WebControl) |
| RenderBeginTag(HtmlTextWriter) |
Vykreslí levou 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 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í obsah ovládacího prvku určenému zapisovači. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl) |
| 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 Panel HTML ovládacího prvku do zadaného zapisovače. (Zděděno od Panel) |
| 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 stavy, které byly změněny po TrackViewState() vyvolání metody. (Zděděno od WebControl) |
| SetDesignModeState(IDictionary) |
Nastaví data v době návrhu ovládacího prvku. (Zděděno od Control) |
| SetPersonalizationDirty() |
Nastaví příznak označující, že se pro instanci aktuálního WebPart ovládacího prvku změnila data přizpůsobení. |
| SetPersonalizationDirty(Control) |
Nastaví příznak označující, že se změnila data přizpůsobení zadaného serverového ovládacího prvku, který se nachází v WebPartZoneBase zóně. |
| 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() |
Způsobí, že ovládací prvek sleduje změny stavu zobrazení, aby mohly být uloženy ve vlastnosti objektu ViewState . |
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í
| 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 najdete v tématu ControlBuilder. (Zděděno od Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Popis tohoto člena najdete v tématu GetDesignModeState(). (Zděděno od Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Popis tohoto člena najdete v tématu SetDesignModeState(IDictionary). (Zděděno od Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Popis tohoto člena najdete v tématu SetOwnerControl(Control). (Zděděno od Control) |
| IControlDesignerAccessor.UserData |
Popis tohoto člena najdete v tématu UserData. (Zděděno od Control) |
| IDataBindingsAccessor.DataBindings |
Popis tohoto člena najdete v tématu DataBindings. (Zděděno od Control) |
| IDataBindingsAccessor.HasDataBindings |
Popis tohoto člena najdete v tématu HasDataBindings. (Zděděno od Control) |
| IExpressionsAccessor.Expressions |
Popis tohoto člena najdete v tématu Expressions. (Zděděno od Control) |
| IExpressionsAccessor.HasExpressions |
Popis tohoto člena najdete v tématu HasExpressions. (Zděděno od Control) |
| IParserAccessor.AddParsedSubObject(Object) |
Popis tohoto člena najdete v tématu AddParsedSubObject(Object). (Zděděno od Control) |
Metody rozšíření
| FindDataSourceControl(Control) |
Vrátí zdroj dat přidružený k ovládacímu prvku dat pro zadaný ovládací prvek. |
| FindFieldTemplate(Control, String) |
Vrátí šablonu pole pro zadaný sloupec v kontejneru názvů zadaného ovládacího prvku. |
| FindMetaTable(Control) |
Vrátí objekt metatable pro ovládací prvek obsahující data. |
| 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