Sdílet prostřednictvím


WebZone Třída

Definice

Slouží jako základní třída pro všechny ovládací prvky, které fungují jako kontejnery pro ovládací prvky serveru (včetně ovládacích prvků webových částí Part , ovládacích prvků serveru a uživatelských ovládacích prvků) v aplikacích webových částí.

public ref class WebZone abstract : System::Web::UI::WebControls::CompositeControl
[System.ComponentModel.Bindable(false)]
public abstract class WebZone : System.Web.UI.WebControls.CompositeControl
[<System.ComponentModel.Bindable(false)>]
type WebZone = class
    inherit CompositeControl
Public MustInherit Class WebZone
Inherits CompositeControl
Dědičnost
Odvozené
Atributy

Příklady

Následující příklad kódu ukazuje použití WebZone třídy.

První část příkladu kódu ukazuje dva vlastní ovládací prvky, které jsou odvozeny z WebPart třídy. 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. 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 CalendarWebPart : WebPart
  {
    Calendar _calendar;

    public CalendarWebPart()
    {
      this.AllowClose = false;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      _calendar = new Calendar();
      _calendar.Caption = "My Calendar";
      this.Controls.Add(_calendar);
      ChildControlsCreated = true;
    }
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class LinksWebPart : WebPart
  {
    Literal _literal;
    const string _literalText = @"
      <table>
      <tr>
        <td><a href='http://msdn.microsoft.com'>MSDN</a></td>
      </tr>
      <tr>
        <td><a href='http://msn.microsoft.com'>MSN</a></td>
      </tr>
      <tr>
        <td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>
      </tr>
      </table>";

    public LinksWebPart()
    {
      this.AllowClose = false;
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();

      _literal = new Literal();
      _literal.Text = _literalText;
      this.Controls.Add(_literal);

      ChildControlsCreated = true;
    }
  }
}
Imports System.Security.Permissions 
Imports System.Web
Imports System.Web.UI.WebControls 
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

<AspNetHostingPermission(SecurityAction.Demand, _ 
  Level := AspNetHostingPermissionLevel.Minimal)> _ 
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
  Level := AspNetHostingPermissionLevel.Minimal)> _ 
Public Class CalendarWebPart
  Inherits WebPart
  Private _calendar As Calendar

  Public Sub New()
    Me.AllowClose = False

  End Sub

  Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      _calendar = New Calendar()
      _calendar.Caption = "My Calendar"
      Me.Controls.Add(_calendar)
      ChildControlsCreated = True
  
  End Sub 
  
End Class 

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class LinksWebPart
    Inherits WebPart
    Private _literal As Literal
    Private Const _literalText As String = _
      "<table>" & _
      "<tr>" & _
      "<td><a href='http://msdn.microsoft.com'>MSDN</a></td>" & _
      "</tr>" & _
      "<tr>" & _
      "<td><a href='http://msn.microsoft.com'>MSN</a></td>" & _
      "</tr>" & _
      "<tr>" & _
      "<td><a href='http://www.msnbc.msn.com'>MSNBC</a></td>" & _
      "</tr>" & _
      "</table>"

    Public Sub New()
      Me.AllowClose = False

    End Sub


    Protected Overrides Sub CreateChildControls()
      Controls.Clear()

      _literal = New Literal()
      _literal.Text = _literalText
      Me.Controls.Add(_literal)

      ChildControlsCreated = True

    End Sub
  End Class

End Namespace

Druhá část příkladu kódu ukazuje webovou stránku, která je hostitelem ovládacích WebPart prvků. Všimněte si, že deklarativní kód obsahuje dva WebPartZone ovládací prvky, CatalogZone ovládací prvek a EditorZone ovládací prvek.

<%@ page language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="ZoneWebPartsCS"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <ZoneTemplate>
          <aspSample:CalendarWebPart 
            runat="server"   
            id="CalendarWebPart1" 
            Title="Calendar WebPart"
            />         
        </ZoneTemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      title="Zone 2"
      PartChromeType="TitleAndBorder"
      EmptyZoneText="Empty Zone">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
    </asp:webpartzone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server" >
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:LinksWebPart 
            runat="server"   
            id="linkswebpart" 
            Title="Favorite Links"
            />  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
  </form>
</body>
</html>
<%@ page language="VB" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="ZoneWebPartsVB"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
    <asp:webpartmanager id="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <ZoneTemplate>
          <aspSample:CalendarWebPart 
            runat="server"   
            id="CalendarWebPart1" 
            Title="Calendar WebPart"
            />         
        </ZoneTemplate>
    </asp:webpartzone>
    <asp:webpartzone
      id="WebPartZone2"
      runat="server"
      title="Zone 2"
      PartChromeType="TitleAndBorder"
      EmptyZoneText="Empty Zone">
        <parttitlestyle font-bold="true" ForeColor="#3300cc"/>
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
    </asp:webpartzone>
    <asp:EditorZone ID="editzone1" Runat="server">
      <ZoneTemplate>
        <asp:AppearanceEditorPart 
          ID="appearanceeditor1" 
          Runat="server" />
        <asp:LayoutEditorPart 
          ID="LayoutEditorPart1" 
          Runat="server" />
      </ZoneTemplate>
    </asp:EditorZone>
    <asp:CatalogZone ID="catalogzone1" Runat="server" >
      <ZoneTemplate>
        <asp:DeclarativeCatalogPart 
          ID="declarativepart1" 
          Runat="server">
          <WebPartsTemplate>
          <aspSample:LinksWebPart 
            runat="server"   
            id="linkswebpart" 
            Title="Favorite Links"
            />  
          </WebPartsTemplate>
        </asp:DeclarativeCatalogPart>
      </ZoneTemplate>
    </asp:CatalogZone>
    <br />
  </form>
</body>
</html>

Stránku můžete načíst v prohlížeči a přepínat mezi různými režimy zobrazení stránky, abyste viděli, jak se různé zóny chovají. Další informace o režimech zobrazení a umožnění uživatelům přepínat mezi nimi naleznete v tématu Návod: Změna režimů zobrazení na stránce webových částí.

Poznámky

Zóna webových částí je definovaná oblast, která obsahuje serverové ovládací prvky na webové stránce a poskytuje konzistentní uživatelské rozhraní, rozložení a vykreslování obsažených ovládacích prvků. Zóny se v prohlížeči vykreslují jako tabulky HTML.

Třída WebZone je základní třídou pro všechny zóny webových částí. Ovládací prvek zóny je složený ovládací prvek navržený tak, aby obsahoval jiné ovládací prvky, a proto WebZone třída dědí z CompositeControl třídy. Spolu s ovládacími WebPartManager prvky a Part ovládacími prvky (nebo jinými ovládacími prvky uživatele nebo serveru, které lze umístit do zón), ovládací prvky zóny odvozené ze WebZone základní třídy tvoří základní stavební bloky aplikace webových částí.

Důležitou rolí zón webových částí je povolit úplné funkce webových částí pro ovládací prvky, které obsahují. Každá stránka webových částí obsahuje alespoň jednu zónu a zóna může obsahovat ovládací prvky s nulovou nebo více částmi. Zóny jsou vyžadovány pro funkce webových částí. Bez zón mohou mít dokonce i ovládací prvky odvozené z WebPart třídy velmi málo funkcí webových částí. Naopak z důvodu návrhu sady ovládacích částí webových částí můžete umístit běžné ovládací prvky ASP.NET, serverové ovládací prvky nebo uživatelské ovládací prvky do WebPartZoneBase zóny (které jsou odvozeny ) WebZonea vzhledem k tomu, že jsou v zóně, tyto běžné ovládací prvky serveru umožňují fungovat jako ovládací prvky za WebPart běhu. Podrobnosti najdete v dokumentaci pro GenericWebPart třídu.

Poznámka:

Na stránku mimo zónu je možné přidat Part ovládací prvky, WebPart ale v takovém případě jednoduše fungují jako běžné ovládací prvky serveru.

V sadě ovládacích částí webových částí existují dvě široké kategorie zón, z nichž všechny dědí ze základní WebZone třídy.

  • WebPartZoneBase Zóny. WebPart Obsahují ovládací prvky (a další server a uživatele) a tvoří primární uživatelské rozhraní stránek webových částí, se kterými uživatelé většinu času pracují.

  • ToolZone Zóny. Tyto zóny poskytují speciální zobrazení stránky webových částí, která uživatelům umožňují upravovat (přizpůsobit) obsah, rozložení, vzhled, chování a vlastnosti ovládacích prvků obsažených v WebPartZoneBase zónách na stránce webových částí. Zóna je ToolZone například CatalogZoneBase zobrazení katalogu stránky, která umožňuje uživatelům přidávat a odebírat ovládací prvky serveru. Zóna EditorZoneBase je dalším typem ToolZone , který poskytuje zobrazení pro úpravy stránky, což uživatelům umožňuje upravovat a upravovat rozložení stránky spolu s vlastnostmi, vzhledem a chováním ovládacích prvků.

Každá zóna v sadě ovládacích částí webových částí je navržena tak, aby obsahovala odpovídající typ ovládacího prvku odvozeného z Part třídy, přičemž ovládací prvky části slouží jako hlavní obsah a primární uživatelské rozhraní zóny. Typy zón v sadě ovládacích částí webových částí spolu s odpovídajícími typy ovládacích prvků, které obsahují, jsou uvedeny v následující tabulce.

Typ ovládacího prvku dílu Typ zóny
WebPart (a serverové a uživatelské ovládací prvky, které jsou zabaleny GenericWebPart za běhu) WebPartZone (základní třída je WebPartZoneBase )
EditorPart (k dispozici je několik odvozených ovládacích prvků se sadou ovládacích částí a lze vyvíjet vlastní EditorPart ovládací prvky). EditorZone (základní třída je EditorZoneBase )
CatalogPart (k dispozici je několik odvozených ovládacích prvků se sadou ovládacích částí a lze vyvíjet vlastní CatalogPart ovládací prvky). CatalogZone (základní třída je CatalogZoneBase )
WebPartConnection (ovládací prvky připojení jsou jedinečné v tom, že nejsou součástí ovládacích prvků, které dědí ze základní třídy) ConnectionsZone (dědí přímo z ToolZone )

Všechny zóny v ovládacím prvku webové části mají základní společné prvky uživatelského rozhraní, které dědí ze základní WebZone třídy. Ne všechny tyto prvky jsou viditelné v každé zóně, ale každý typ zóny může mít tyto společné prvky uživatelského rozhraní související se zónou, jak je popsáno v následující tabulce.

Oddíl zóny Description
Záhlaví Horní část zóny. Obsahuje text záhlaví, který může obsahovat název zóny; atributy stylu (například ohraničení nebo barva pozadí), které rozlišují záhlaví; a příkazy na úrovni zóny (reprezentované tlačítky, hypertextovými odkazy nebo obrázky), na které můžou uživatelé kliknout, a provádět akce uživatelského rozhraní, které platí pro celou zónu, například uzavření zóny. Několik WebZone vlastností, například HasHeader, HeaderStylea HeaderText, se vztahují k oblasti záhlaví zóny. Pokud jsou v zóně příkazy na úrovni zóny, platí pro VerbButtonType ně vlastnosti a VerbStyle vlastnosti. Všimněte si, že tyto dvě vlastnosti sloves se vztahují pouze na příkazy na úrovni zóny, ne na příkazy v jednotlivých částech ovládacích prvků obsažených v zóně. Hlavičky nejsou přítomny v každém typu zóny; obvykle se zobrazují v ToolZone zónách, kde je potřeba mít společnou oblast záhlaví s textem a slovesem, jako je například podrobné sloveso.
Tělo Část hlavního obsahu zóny. Každá zóna, ze které pochází WebZone , má část těla. Pro všechny typy zón v sadě ovládacích částí webových částí obsahuje tělo zóny určený typ ovládacích prvků (nebo jiných serverových Part ovládacích prvků), které odpovídají typu zóny, jak je uvedeno v předchozí tabulce. Různé členy WebZone třídy ovlivňují obsah oddílu těla, například BackImageUrl, PartChromeStyle, PartChromeTypea PartStyle vlastnosti. Pokud je oddíl textu prázdný, EmptyZoneText může se zpráva zobrazit v určitých situacích.
Chrom Společné prvky uživatelského rozhraní vykreslené pro každý ovládací prvek části v zóně. To se liší od diskuze o atributech stylu, které se vztahují na samotnou zónu; Chrome se týká konkrétně ovládacích prvků obsažených částí. Chrome obsahuje slovesa, ohraničení a další atributy stylu, jako je barva pozadí nebo styl písma textu nadpisu pro ovládací prvky části zóny. Zóna určuje podrobnosti chromu pomocí jednoho chromového objektu vhodného pro typ ovládacích prvků, které obsahuje (například CatalogPartChrome objekt pro CatalogZone ovládací prvky, který obsahuje CatalogPart ). Tento jeden objekt chromu zpracovává podrobnosti o chromu a vykreslování všech ovládacích prvků částí v zóně. Vývojáři tak můžou vytvářet zóny, ve kterých můžou určit konzistentní, běžný vzhled a chování všech ovládacích prvků částí. Některé vlastnosti, které se vztahují k chromu pro ovládací prvky části zóny, zahrnují PartChromeStyle, PartChromeType, PartStylea PartTitleStyle vlastnosti. Všimněte si, že většina vlastností souvisejících s chromem, včetně konkrétní vlastnosti odkazování na objekt chromu pro konkrétní typ zóny, nejsou implementovány v základní WebZone třídě. Místo toho se většina funkcí zón specifických pro chrome implementuje na konkrétních typech zón podle potřeby jedinečných potřeb ovládacích prvků jejich částí. Podívejte se na témata pro každý typ zóny uvedený v předchozí tabulce tohoto tématu.
Ovládací prvky částí Ovládací prvky, které se nacházejí v části těla zóny. Každá zóna, která dědí z WebZone třídy, obsahuje v části těla jednu nebo více ovládacích prvků odpovídajícího typu, jak je znázorněno v předchozí tabulce v tomto tématu. Ovládací prvky této části tvoří hlavní uživatelské rozhraní aplikací webových částí. Většina typů zón odvozených z WebZone vlastnosti kolekce, která jim umožňuje odkazovat na všechny ovládací prvky obsažených částí, jako WebParts je vlastnost třídy WebPartZoneBase , a EditorParts vlastnost třídy EditorZoneBase .
Zápatí Dolní část zóny. Podobně jako v oddílu záhlaví se nenachází v každém typu zóny, ale obvykle se vyskytuje v ToolZone zónách. Typický obsah oddílu zápatí jsou slovesa, jako je příkaz OK nebo použít sloveso, které se zobrazí v zápatí EditorZoneBase zón. Mezi některé vlastnosti, které se vztahují k oddílu zápatí, patří HasFooter, FooterStyle, VerbButtonTypea VerbStyle vlastnosti.

WebZone Většina vlastností třídy je popsána v předchozí tabulce, která popisuje společné prvky uživatelského rozhraní zón. Třída WebZone má také několik metod týkajících se své role vykreslování obsahu. Všechny RenderBodymetody , , RenderContentsRenderFootera RenderHeader mohou být přepsány tak, aby poskytovaly programovou kontrolu nad vykreslováním každé konkrétní části zóny. Pokud například chcete přizpůsobit vykreslování všech oddílů zápatí zón katalogu v aplikaci, můžete dědit z CatalogZoneBase třídy, přepsat metodu RenderFooter zděděnou z WebZonea změnit vykreslování oddílu zápatí.

Poznámky pro implementátory

K vývoji vlastních zón webových částí zřídka potřebujete dědit přímo z WebZone třídy. Sada ovládacích částí webových částí obsahuje specializované zóny uvedené výše v části Poznámky a obvykle můžete odvodit z některé z nich pro přidání vlastního chování do zóny. Pokud se rozhodnete dědit přímo z WebZone třídy, musíte přepsat řadu vlastností a metod (viz dokumentace pro členy WebZone třídy). Musíte také vytvořit vlastní ovládací prvek, volitelně vlastní WebPartManagerWebPartDisplayMode ovládací prvek pro vytvoření jedinečného režimu zobrazení, ve kterém chcete zobrazit zónu a další přizpůsobení, aby vaše zóna fungovala v rámci sady ovládacích částí webových částí.

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)
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)
BackColor

Získá nebo nastaví barvu pozadí ovládacího prvku webového serveru.

(Zděděno od WebControl)
BackImageUrl

Získá nebo nastaví adresu URL na obrázek pozadí zóny.

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)
ChildControlsCreated

Získá hodnotu, která označuje, zda byly vytvořeny podřízené ovládací prvky ovládacího prvku serveru.

(Zděděno od Control)
ClientID

Získá ID ovládacího prvku pro kód HTML, který je generován ASP.NET.

(Zděděno od Control)
ClientIDMode

Získá nebo nastaví algoritmus, který se používá k vygenerování hodnoty ClientID vlastnosti.

(Zděděno od Control)
ClientIDSeparator

Získá hodnotu znaku představující oddělovač znak použitý ve ClientID vlastnosti.

(Zděděno od Control)
Context

HttpContext Získá objekt přidružený k ovládacímu prvku serveru pro aktuální webový požadavek.

(Zděděno od Control)
Controls

ControlCollection Získá objekt, který představuje podřízené ovládací prvky v objektu CompositeControl.

(Zděděno od CompositeControl)
ControlStyle

Získá styl ovládacího prvku webového serveru. Tuto vlastnost používají 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)
DesignMode

Získá hodnotu určující, zda se ovládací prvek používá na návrhové ploše.

(Zděděno od Control)
EmptyZoneText

Získá nebo nastaví zprávu, která se zobrazí, když zóna neobsahuje žádné ovládací prvky.

EmptyZoneTextStyle

Získá atributy stylu pro zástupný text v prázdné zóně.

Enabled

Získá nebo nastaví hodnotu 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)
ErrorStyle

Získá atributy stylu pro vykreslení chybové zprávy, která je zobrazena, pokud WebPart ovládací prvek nelze načíst nebo vytvořit.

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 webovému serveru ovládacího prvku.

(Zděděno od WebControl)
FooterStyle

Získá atributy stylu pro obsah oblasti zápatí zóny.

ForeColor

Získá nebo nastaví barvu popředí (obvykle barvu textu) ovládacího prvku webového serveru.

(Zděděno od WebControl)
HasAttributes

Získá hodnotu 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)
HasFooter

Získá hodnotu určující, zda zóna má oblast zápatí.

HasHeader

Získá hodnotu určující, zda zóna má oblast záhlaví.

HeaderStyle

Získá atributy stylu pro obsah oblasti záhlaví zóny.

HeaderText

Získá nebo nastaví text pro oblast záhlaví zóny.

Height

Získá nebo nastaví výšku ovládacího prvku webového serveru.

(Zděděno od WebControl)
ID

Získá nebo nastaví programový identifikátor přiřazený ovládacímu prvku serveru.

(Zděděno od Control)
IdSeparator

Získá znak použitý k oddělení identifikátorů ovládacích prvků.

(Zděděno od Control)
IsChildControlStateCleared

Získá hodnotu určující, zda ovládací prvky obsažené v tomto ovládacím prvku mají stav ovládacího prvku.

(Zděděno od Control)
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 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)
Padding

Získá nebo nastaví atributy odsazení buňky v tabulce, která obsahuje WebPart ovládací prvky v zóně.

Page

Získá odkaz na Page instanci, která obsahuje serverový ovládací prvek.

(Zděděno od Control)
Parent

Získá odkaz na nadřazený ovládací prvek ovládacího prvku serveru v hierarchii ovládacích prvků stránky.

(Zděděno od Control)
PartChromePadding

Získá nebo nastaví vzdálenost mezi obsahem WebPart ovládacího prvku a ohraničení ovládacího prvku.

PartChromeStyle

Získá vlastnosti stylu, které se vztahují na ohraničení ovládacích prvků webových částí obsažených v zóně.

PartChromeType

Získá nebo nastaví typ ohraničení, které rámečky webové části ovládací prvky obsažené v zóně.

PartStyle

Získá vlastnosti stylu, které se vztahují na ohraničení a obsah každého ovládacího prvku webové části obsažené v zóně.

PartTitleStyle

Získá atributy stylu pro obsah záhlaví pro každý ovládací prvek webové části obsažené v zóně.

RenderClientScript

Získá hodnotu, která určuje, zda se má vykreslit klientský skript na stránce webových částí.

RenderingCompatibility

Získá hodnotu, která určuje ASP.NET verzi, která vykreslený KÓD HTML bude kompatibilní s.

(Zděděno od Control)
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)
SupportsDisabledAttribute

Získá hodnotu, která určuje, zda ovládací prvek má nastavit disabled atribut vykresleného HTML elementu na "zakázáno" při vlastnosti ovládacího prvku IsEnabled je false.

(Zděděno od CompositeControl)
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ů.

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)
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)
VerbButtonType

Získá nebo nastaví, jaký typ tlačítka se používá k reprezentaci sloves v zóně.

VerbStyle

Získá atributy stylu pro příkazy uživatelského rozhraní (UI) přidružené k ovládacím částem webových částí v zóně.

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)
WebPartManager

Získá odkaz na WebPartManager ovládací prvek přidružený k WebZone instanci ovládacího prvku na stránce webových částí.

Width

Získá nebo nastaví šířku ovládacího prvku webového serveru.

(Zděděno od WebControl)

Metody

Name Description
AddAttributesToRender(HtmlTextWriter)

Přidá atributy a styly HTML, které je třeba vykreslit do zadaného HtmlTextWriterTag. Tuto metodu používají primárně vývojáři řízení.

(Zděděno od WebControl)
AddedControl(Control, Int32)

Volá se po přidání podřízeného ovládacího prvku do Controls kolekce objektu Control .

(Zděděno od Control)
AddParsedSubObject(Object)

Upozorní 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 nullhodnotu .

(Zděděno od Control)
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ý je interně WebControl používán třídou k implementaci všech vlastností souvisejících se stylem. Tuto metodu používají primárně vývojáři řízení.

(Zděděno od WebControl)
DataBind()

Vytvoří vazbu zdroje dat s podřízenými CompositeControl ovládacími prvky a všemi jeho podřízenými ovládacími prvky.

(Zděděno od CompositeControl)
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 id a celé číslo zadané v parametru pathOffset , který pomáhá při hledání. Tuto verzi FindControl metody byste neměli přepsat.

(Zděděno od Control)
FindControl(String)

Vyhledá aktuální kontejner pojmenování pro ovládací prvek serveru se zadaným id parametrem.

(Zděděno od Control)
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)
GetEffectiveChromeType(Part)

Vrátí skutečnou WebPart nebo efektivní aktuální PartChromeType hodnotu ovládacího prvku vzhledem k PartChromeType vlastnosti zóny a aktuální režim zobrazení stránky webových částí.

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)

Načte dříve uložené informace o stavu zóny.

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)
OnDataBinding(EventArgs)

DataBinding Vyvolá událost.

(Zděděno od Control)
OnInit(EventArgs)

Init Vyvolá událost.

OnLoad(EventArgs)

Load Vyvolá událost.

(Zděděno od Control)
OnPreRender(EventArgs)

PreRender Vyvolá událost.

OnUnload(EventArgs)

Unload Vyvolá událost.

(Zděděno od Control)
OpenFile(String)

Stream Získá 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)
RecreateChildControls()

Znovu vytvoří podřízené ovládací prvky v ovládacím prvku odvozeného z CompositeControl.

(Zděděno od CompositeControl)
RemovedControl(Control)

Volá se po odebrání podřízeného ovládacího prvku z Controls kolekce objektu Control .

(Zděděno od Control)
Render(HtmlTextWriter)

Zapíše CompositeControl obsah do zadaného HtmlTextWriter objektu pro zobrazení v klientovi.

(Zděděno od CompositeControl)
RenderBeginTag(HtmlTextWriter)

Vykreslí levou značku HTML ovládacího prvku zóny na zadaný HtmlTextWriter objekt.

RenderBody(HtmlTextWriter)

Přepisuje vykreslování pro tělo ovládacího prvku zóny.

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í celý obsah ovládacího prvku zóny mezi počáteční a koncovou značkou do zadaného HtmlTextWriter objektu.

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 HTML ovládacího prvku do zadaného zapisovače. Tuto metodu používají primárně vývojáři řízení.

(Zděděno od WebControl)
RenderFooter(HtmlTextWriter)

Přepisuje vykreslování zápatí ovládacího prvku zóny.

RenderHeader(HtmlTextWriter)

Přepisuje vykreslování záhlaví ovládacího prvku zóny.

ResolveAdapter()

Získá adaptér ovládacího prvku zodpovědný za vykreslení zadaného ovládacího prvku.

(Zděděno od Control)
ResolveClientUrl(String)

Získá adresu URL, kterou může prohlížeč používat.

(Zděděno od Control)
ResolveUrl(String)

Převede adresu URL na adresu URL, která je použitelná u žádajícího klienta.

(Zděděno od Control)
SaveControlState()

Uloží všechny změny stavu řízení serveru, ke kterým došlo od doby, kdy byla stránka odeslána zpět na server.

(Zděděno od Control)
SaveViewState()

Uloží všechny změny stavu zobrazení, ke kterým došlo po odeslání stránky zpět na server.

SetDesignModeState(IDictionary)

Nastaví data návrhu pro ovládací prvek.

(Zděděno od Control)
SetRenderMethodDelegate(RenderMethod)

Přiřadí delegáta obslužné rutiny události k vykreslení ovládacího prvku serveru a jeho obsahu do nadřazeného ovládacího prvku.

(Zděděno od Control)
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()

Sleduje změny stavu zobrazení ovládacího prvku zóny.

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 návrháři znovu vytvořit kolekci podřízených ovládacích prvků složeného ovládacího prvku v prostředí návrhu.

(Zděděno od CompositeControl)
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.

Platí pro

Viz také