Part 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 ovládací prvky všech webových částí, které vykreslují modulární uživatelské rozhraní na Web Forms stránce.
public ref class Part abstract : System::Web::UI::WebControls::Panel, System::Web::UI::INamingContainer, System::Web::UI::WebControls::ICompositeControlDesignerAccessorpublic abstract class Part : System.Web.UI.WebControls.Panel, System.Web.UI.INamingContainer, System.Web.UI.WebControls.ICompositeControlDesignerAccessortype Part = class
inherit Panel
interface INamingContainer
interface ICompositeControlDesignerAccessorPublic MustInherit Class Part
Inherits Panel
Implements ICompositeControlDesignerAccessor, INamingContainer- Dědičnost
- Odvozené
- Implementuje
Příklady
Následující příklady kódu demonstrují deklarativní použití několika vlastností Part třídy pomocí dvou instancí vlastního WebPart ovládacího prvku odkazovaného na webové stránce ASP.NET. Aby se příklad kódu spustil, musíte tento zdrojový kód zkompilovat. Můžete ho explicitně zkompilovat a umístit výsledné sestavení do složky Bin 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. 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.
První část příkladu obsahuje kód pro vlastní ovládací prvek s názvem TextDisplayWebPart. Vzhledem k tomu, že ovládací prvek je odvozen z WebPart, dědí také společné vlastnosti, které Part poskytuje třída, a ilustruje použití těchto vlastností v tomto příkladu kódu.
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;
const string _subTitle = "Contoso, Ltd";
public TextDisplayWebPart()
{
this.AllowClose = false;
}
[
Personalizable(PersonalizationScope.User, true),
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))
{
this.ContentText = Page.Server.HtmlEncode(input.Text) + @"<br />";
// Clear the input textbox.
input.Text = String.Empty;
DisplayContent.Text = this.ContentText;
}
}
}
}
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
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
Me.ContentText = Page.Server.HtmlEncode(input.Text) + "<br />"
' Clear the input textbox.
input.Text = String.Empty
DisplayContent.Text = Me.ContentText
End If
End Sub
End Class
End Namespace
Druhá část příkladu ukazuje, jak odkazovat na ovládací prvky vlastní části na webové stránce ASP.NET. Všimněte si, že různé Part vlastnosti jsou přiřazeny deklarativně k vlastním instancím ovládacího prvku. Porovnejte deklarativní kód, který odkazuje na dvě instance na stránce, a pak stránku načtěte v prohlížeči. Všimněte si, jak různé vlastnosti ovlivňují vzhled ovládacích prvků. Například po načtení stránky v prohlížeči se druhá instance TextDisplayWebPart ovládacího prvku zobrazí jako minimalizovaná, protože jeho ChromeState hodnota vlastnosti je nastavená na Minimized.
<%@ 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"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart"
Description="A text content WebPart control."
ChromeType="TitleAndBorder"
width="350px" />
</zonetemplate>
</asp:webpartzone>
<asp:webpartzone
id="WebPartZone2"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart2"
title = "Text Content WebPart 2"
Description="A text content WebPart control."
ChromeType="TitleOnly"
ChromeState="Minimized"
width="350px" />
</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"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart"
title = "Text Content WebPart"
Description="A text content WebPart control."
ChromeType="TitleAndBorder"
width="350px" />
</zonetemplate>
</asp:webpartzone>
<asp:webpartzone
id="WebPartZone2"
runat="server"
backcolor="#99cccc">
<parttitlestyle font-bold="true" forecolor="#ffffff" />
<partstyle
borderwidth="1px"
borderstyle="Solid"
bordercolor="#81AAF2" />
<zonetemplate>
<aspSample:TextDisplayWebPart
runat="server"
id="textwebpart2"
title = "Text Content WebPart 2"
Description="A text content WebPart control."
ChromeType="TitleOnly"
ChromeState="Minimized"
width="350px" />
</zonetemplate>
</asp:webpartzone>
</form>
</body>
</html>
Poznámky
Třída Part definuje vlastnosti, které jsou společné pro všechny ovládací prvky součástí, a umožňuje jim modulární a konzistentní vzhled na webové stránce. Mezi tyto společné vlastnosti patří název, popis a charakteristiky chromu nebo rámečku, které obklopují ovládací prvek součásti.
Vlastnost Title určuje název ovládacího prvku dílu. Vlastnost Description se používá ke shrnutí účelu ovládacího prvku části a zobrazuje se jako popis v záhlaví ovládacího prvku. Vlastnost ChromeType určuje, jaký druh ohraničení se zobrazí kolem ovládacího prvku části, zatímco ChromeState vlastnost určuje, jestli je ovládací prvek součásti vykreslen normálně nebo minimalizovaný. Ohraničení ovládacího prvku části je ovlivněno vlastnostmi zóny, která jej obsahuje; PartChromeType Vlastnost například ovlivňuje rámce všech ovládacích prvků součástí obsažených v zóně.
Jedním z typů ovládacího prvku části je WebPart ovládací prvek, který vykresluje obsah uvnitř odpovídající zóny. Dalším typem EditorPart je ovládací prvek, který poskytuje ovládací prvky uživatelského rozhraní používané k úpravě (přizpůsobení) jednotlivých WebPart ovládacích prvků. Třetím typem ovládacího prvku části je CatalogPart ovládací prvek, který poskytuje seznam ovládacích WebPart prvků, které mohou uživatelé přidat nebo odebrat z webové stránky.
Ovládací prvky části jsou obsaženy v zónách, z nichž všechny jsou odvozeny z abstraktní WebZone třídy. Zóna je zodpovědná za uspořádání ovládacích prvků, které obsahuje. Každá zóna také vykresluje prvky uživatelského rozhraní pro sebe, včetně záhlaví, zápatí, záhlaví a prvků uživatelského rozhraní kolem každého ovládacího prvku obsažené části, například ohraničení.
Poznámka
Zatímco ovládací prvky části se obvykle nacházejí v zónách, je možné umístit ovládací prvek části mimo zónu, pokud je ovládací prvek deklarativně odkazován ve značkách webové stránky. Pokud je ovládací prvek části deklarován mimo zónu na webové stránce, tento ovládací prvek stále funguje, ale ztratí většinu funkcí webových částí. Například ovládací prvek nelze upravit a nelze jej přetáhnout do zóny za běhu. Je také užitečné si uvědomit, že žádný ovládací prvek není možné přetáhnout ze zóny a přetáhnout na stránku mimo zónu za běhu.
Některé příklady typů základních částí a jejich odpovídajících typů zón jsou uvedeny v následující tabulce.
| Typ ovládacího prvku části | Typ zóny |
|---|---|
| WebPart | WebPartZone |
| EditorPart | EditorZone |
| CatalogPart | CatalogZone |
Různé druhy ovládacích prvků části, které jsou odvozeny z Part třídy, zpracovávají zděděné vlastnosti orientované na uživatelské rozhraní odlišně. WebPart Ovládací prvky přepíší několik zděděných vlastností uživatelského rozhraní a označí je atributem Personalizable (podrobnosti najdete v PersonalizableAttribute dokumentaci ke třídě), který umožňuje uložení hodnot těchto vlastností pro budoucí relace prohlížeče, což je funkce označovaná jako přizpůsobení. Pokud například programově povolíte uživateli aktualizovat hodnotu WebPart vlastnosti ovládacího prvku Title za běhu, bude tato hodnota přizpůsobena (za předpokladu, že je povoleno přizpůsobení, což je výchozí nastavení). Několik vlastností uživatelského rozhraní, které WebPart ovládací prvky dědí z Part třídy a z WebControl třídy , se zpracovávají stejným způsobem.
Naproti tomu ovládací prvky jiných částí, například EditorPart a CatalogPart, neumožňují přizpůsobení zděděných vlastností uživatelského rozhraní. Z tohoto důvodu se hodnoty vlastností přiřazené programem neukládají pro budoucí relace prohlížeče. Pokud například programově povolíte uživateli aktualizovat PropertyGridEditorPart vlastnost ovládacího prvku Title za běhu, aktualizovaná hodnota se po zavření ovládacího prvku nebo ukončení relace prohlížeče ztratí.
Snadný způsob, jak uložit hodnoty těchto zděděných vlastností uživatelského rozhraní pro EditorPart ovládací prvky a CatalogPart pro budoucí relace prohlížeče, je deklarovat hodnoty vlastností ve formátu trvalosti stránky. Jedná se však o statický přístup, který uživatelům stále neumožňuje přizpůsobit hodnoty vlastností. Jako alternativu, pokud chcete povolit programové aktualizace zděděných vlastností uživatelského rozhraní, aby je uživatelé mohli přizpůsobit za běhu, můžete k uložení hodnot vlastností použít privátní statické proměnné. Pokaždé, když je vytvořena nová instance EditorPart ovládacího prvku nebo CatalogPart (například v metodě, která zpracovává událost ovládacího prvku Init ), můžete znovu přiřadit hodnotu statické proměnné odpovídající vlastnosti. Takový přístup dává uživatelům možnost přizpůsobit uživatelské rozhraní pro úpravy a uživatelské rozhraní katalogu aplikace webových částí.
Poznámky pro implementátory
Za normálních okolností byste neměli dědit přímo z Part třídy, abyste mohli vyvíjet vlastní ovládací prvky webových částí. Chcete-li poskytnout úplné funkce webových částí, vyžaduje sada ovládacích částí třídy odvozené z Part třídy, a to WebPart, EditorParta CatalogPart, takže byste měli odvozovat z nich pro vývoj vlastních ovládacích prvků. Je však stále důležité porozumět chování základní Part třídy, protože poskytuje společnou sadu vlastností používaných všemi ostatními třídami součá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í aplikaci 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 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) |
| ChildControlsCreated |
Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky serverového ovládacího prvku. (Zděděno od Control) |
| 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) |
| 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í. |
| 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í směr zobrazení ovládacích prvků, které obsahují text v ovládacím prvku Panel . (Zděděno od Panel) |
| 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 označující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, do žádajícího klienta. (Zděděno od Control) |
| Events |
Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen ke čtení. (Zděděno od Control) |
| 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í nějaké uložené nastavení stavu zobrazení. (Zděděno od Control) |
| Height |
Získá nebo nastaví výšku ovládacího prvku webového serveru. (Zděděno od WebControl) |
| 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) |
| 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 stav zobrazení povolen pro tento ovládací prvek. (Zděděno od Control) |
| LoadViewStateByID |
Získá hodnotu označující, zda se ovládací prvek účastní načítání stavu zobrazení namísto ID indexu. (Zděděno od Control) |
| NamingContainer |
Získá odkaz na názvový kontejner serverového ovládacího prvku, který vytvoří jedinečný obor názvů pro odlizení mezi ovládacími prvky serveru se stejnou ID hodnotou vlastnosti. (Zděděno od Control) |
| Page |
Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek. (Zděděno od Control) |
| Parent |
Získá odkaz na nadřazený ovládací prvek serveru v hierarchii ovládacích prvků stránky. (Zděděno od Control) |
| RenderingCompatibility |
Získá hodnotu, která určuje ASP.NET verze, která vykreslovala HTML bude kompatibilní s. (Zděděno od Control) |
| 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) |
| 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. |
| 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) |
| 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) |
| Width |
Získá nebo nastaví šířku ovládacího prvku webového serveru. (Zděděno od WebControl) |
| Wrap |
Získá nebo nastaví hodnotu označující, zda se obsah zalomí v panelu. (Zděděno od Panel) |
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 element XML nebo HTML, a přidá element do objektu serverového ControlCollection ovládacího prvku. (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 na ovládací prvek vlastnosti stylu definované v šabloně stylů stránky. (Zděděno od Control) |
| BeginRenderTracing(TextWriter, Object) |
Začíná trasování vykreslovaných dat v době návrhu. (Zděděno od Control) |
| BuildProfileTree(String, Boolean) |
Shromáždí informace o serverovém ovládacím prvku a předá je vlastnosti Trace , která se má zobrazit, když je pro stránku povoleno trasování. (Zděděno od Control) |
| ClearCachedClientID() |
Nastaví hodnotu v ClientID mezipaměti na |
| ClearChildControlState() |
Odstraní informace o stavu ovládacího prvku pro podřízené ovládací prvky serveru. (Zděděno od Control) |
| ClearChildState() |
Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky serveru. (Zděděno od Control) |
| ClearChildViewState() |
Odstraní informace o stavu zobrazení pro všechny podřízené ovládací prvky serveru. (Zděděno od Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Nastaví vlastnost instance aktuálního ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control) |
| 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ána rozhraním ASP.NET stránky k upozornění serverových ovládacích prvků, které používají implementaci založenou na složení k vytvoření všech podřízených ovládacích prvků, které obsahují při přípravě na zaúčtování zpět nebo vykreslení. (Zděděno od Control) |
| CreateControlCollection() |
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) |
| DataBind() |
Vytvoří vazbu zdroje dat na vyvoláný serverový ovládací prvek a všechny jeho podřízené ovládací prvky. |
| DataBind(Boolean) |
Vytvoří vazbu zdroje dat na vyvolaný ovládací prvek serveru a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost. (Zděděno od Control) |
| DataBindChildren() |
Vytvoří vazbu zdroje dat na podřízené ovládací prvky serveru. (Zděděno od Control) |
| Dispose() |
Umožňuje ovládacímu prvku serveru provést konečné vyčištění před uvolněním z paměti. (Zděděno od Control) |
| EndRenderTracing(TextWriter, Object) |
Ukončí trasování doby návrhu vykreslovaných dat. (Zděděno od Control) |
| EnsureChildControls() |
Určuje, zda serverový ovládací prvek obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky. (Zděděno od Control) |
| EnsureID() |
Vytvoří identifikátor pro ovládací prvky, které nemají přiřazený identifikátor. (Zděděno od Control) |
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| FindControl(String) |
Vyhledá v aktuálním názvovém kontejneru serverový ovládací prvek se zadaným |
| 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() |
Type Získá z aktuální instance. (Zděděno od Object) |
| GetUniqueIDRelativeTo(Control) |
Vrátí část UniqueID vlastnosti zadaného ovládacího prvku s předponou. (Zděděno od Control) |
| HasControls() |
Určuje, zda serverový ovládací prvek obsahuje nějaké podřízené ovládací prvky. (Zděděno od Control) |
| HasEvents() |
Vrátí hodnotu označující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky. (Zděděno od Control) |
| IsLiteralContent() |
Určuje, zda serverový ovládací prvek obsahuje pouze obsah literálu. (Zděděno od Control) |
| LoadControlState(Object) |
Obnoví informace o stavu řízení z předchozího požadavku stránky, který byl uložen metodou SaveControlState() . (Zděděno od Control) |
| LoadViewState(Object) |
Obnoví informace o stavu zobrazení z předchozího požadavku, 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 serveru uživatelského rozhraní stránky. (Zděděno od Control) |
| OnDataBinding(EventArgs) |
DataBinding Vyvolá událost. (Zděděno od Control) |
| OnInit(EventArgs) |
Init Vyvolá událost. (Zděděno od Control) |
| OnLoad(EventArgs) |
Load Vyvolá událost. (Zděděno od Control) |
| OnPreRender(EventArgs) |
PreRender Vyvolá událost. (Zděděno od Control) |
| OnUnload(EventArgs) |
Unload Vyvolá událost. (Zděděno od Control) |
| OpenFile(String) |
Stream Získá používá ke čtení souboru. (Zděděno od Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Přiřadí všechny zdroje události a její informace nadřazené ovládacímu prvku. (Zděděno od Control) |
| RemovedControl(Control) |
Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control . (Zděděno od Control) |
| Render(HtmlTextWriter) |
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 na 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ího prvku serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povoleno. (Zděděno od Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Vypíše obsah řízení serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu. (Zděděno od Control) |
| 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á adaptér ovládacího prvku zodpovědný za vykreslení zadaného ovládacího prvku. (Zděděno od Control) |
| ResolveClientUrl(String) |
Získá adresu URL, kterou lze použít v prohlížeči. (Zděděno od Control) |
| ResolveUrl(String) |
Převede adresu URL na adresu URL, která je použitelná v žádajícím klientovi. (Zděděno od Control) |
| SaveControlState() |
Uloží všechny změny stavu ovládacích prvků serveru, ke kterým došlo od okamžiku, kdy byla stránka odeslána zpět na server. (Zděděno od Control) |
| SaveViewState() |
Uloží všechny 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) |
| SetRenderMethodDelegate(RenderMethod) |
Přiřadí delegáta obslužné rutiny události pro vykreslení serverového ovládacího prvku a jeho obsahu do nadřazeného ovládacího prvku. (Zděděno od Control) |
| SetTraceData(Object, Object) |
Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí 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 . (Zděděno od WebControl) |
Událost
| DataBinding |
Vyvolá se při vytvoření vazby serverového ovládacího prvku na zdroj dat. (Zděděno od Control) |
| Disposed |
Vyvolá se při uvolnění serverového ovládacího prvku z paměti, což je poslední fáze životního cyklu řízení serveru, když je požadována ASP.NET stránka. (Zděděno od Control) |
| Init |
Vyvolá se při inicializaci serverového ovládacího prvku, což je první krok v jeho životním cyklu. (Zděděno od Control) |
| Load |
Vyvolá se při načtení serverového ovládacího prvku do objektu Page . (Zděděno od Control) |
| PreRender |
Vyvolá se po načtení objektu Control , ale před vykreslením. (Zděděno od Control) |
| Unload |
Nastane při uvolnění serverového ovládacího prvku z paměti. (Zděděno od Control) |
Explicitní implementace rozhraní
| 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. |
| 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ý ovládací prvek dat. |
| GetMetaTable(INamingContainer) |
Získá metadata tabulky pro zadaný ovládací prvek dat. |
| SetMetaTable(INamingContainer, MetaTable) |
Nastaví metadata tabulky pro zadaný ovládací prvek dat. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Nastaví mapování metadat tabulky a výchozí hodnoty pro zadaný ovládací prvek dat. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Nastaví mapování metadat tabulky a výchozí hodnoty pro zadaný ovládací prvek dat. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Určuje, zda 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