CatalogZone Třída

Definice

Slouží jako primární ovládací prvek v ovládacích prvcích webových částí pro hostování CatalogPart ovládacích prvků na webové stránce.

public ref class CatalogZone : System::Web::UI::WebControls::WebParts::CatalogZoneBase
public class CatalogZone : System.Web.UI.WebControls.WebParts.CatalogZoneBase
type CatalogZone = class
    inherit CatalogZoneBase
Public Class CatalogZone
Inherits CatalogZoneBase
Dědičnost

Příklady

Následující příklad kódu ukazuje deklarativní a programové použití CatalogZone ovládacího prvku. Příklad kódu má čtyři části:

  • Uživatelský ovládací prvek, který umožňuje změnit režimy zobrazení na webové stránce.

  • Soubor se zdrojovým kódem pro vlastní CatalogZone ovládací prvek a vlastní WebPart ovládací prvek, který je importován katalogem a přidán na webovou stránku.

  • Webová stránka, která deklaruje uživatelský ovládací prvek a vlastní CatalogZone ovládací prvek.

  • Vysvětlení, jak spustit příklad

První část tohoto příkladu kódu je uživatelský ovládací prvek, který umožňuje uživatelům měnit režimy zobrazení na webové stránce. Podrobnosti o režimech zobrazení a popis zdrojového kódu v tomto ovládacím prvku najdete v tématu Návod: Změna režimů zobrazení na stránce webových částí.

<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
  
 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

    // If shared scope is allowed for this user, display the scope-switching
    // UI and select the appropriate radio button for the current user scope.
    if (_manager.Personalization.CanEnterSharedScope)
    {
      Panel2.Visible = true;
      if (_manager.Personalization.Scope == PersonalizationScope.User)
        RadioButton1.Checked = true;
      else
        RadioButton2.Checked = true;
    }
    
  }
 
  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;
  }

  // Set the selected item equal to the current display mode.
  void Page_PreRender(object sender, EventArgs e)
  {
    ListItemCollection items = DisplayModeDropdown.Items;
    int selectedIndex = 
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
    DisplayModeDropdown.SelectedIndex = selectedIndex;
  }

  // Reset all of a user's personalization data for the page.
  protected void LinkButton1_Click(object sender, EventArgs e)
  {
    _manager.Personalization.ResetPersonalizationState();
  }

  // If not in User personalization scope, toggle into it.
  protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.Scope == PersonalizationScope.Shared)
      _manager.Personalization.ToggleScope();
  }

  // If not in Shared scope, and if user is allowed, toggle the scope.
  protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.CanEnterSharedScope && 
        _manager.Personalization.Scope == PersonalizationScope.User)
      _manager.Personalization.ToggleScope();
  }
</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>
<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
  ' Use a field to reference the current WebPartManager.
  Dim _manager As WebPartManager

  Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
    AddHandler Page.InitComplete, AddressOf InitComplete
  End Sub

  Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
    _manager = WebPartManager.GetCurrentWebPartManager(Page)
      
    Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
      
    ' Fill the dropdown with the names of supported display modes.
    Dim mode As WebPartDisplayMode
    For Each mode In _manager.SupportedDisplayModes
      Dim modeName As String = mode.Name
      ' Make sure a mode is enabled before adding it.
      If mode.IsEnabled(_manager) Then
        Dim item As New ListItem(modeName, modeName)
        DisplayModeDropdown.Items.Add(item)
      End If
    Next mode
      
    ' If shared scope is allowed for this user, display the scope-switching
    ' UI and select the appropriate radio button for the current user scope.
    If _manager.Personalization.CanEnterSharedScope Then
      Panel2.Visible = True
      If _manager.Personalization.Scope = PersonalizationScope.User Then
        RadioButton1.Checked = True
      Else
        RadioButton2.Checked = True
      End If
    End If
   
  End Sub

  ' Change the page to the selected display mode.
  Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    Dim selectedMode As String = DisplayModeDropdown.SelectedValue   
    Dim mode As WebPartDisplayMode = _
      _manager.SupportedDisplayModes(selectedMode)
    If Not (mode Is Nothing) Then
      _manager.DisplayMode = mode
    End If

  End Sub
   
  ' Set the selected item equal to the current display mode.
  Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
    Dim items As ListItemCollection = DisplayModeDropdown.Items
    Dim selectedIndex As Integer = _
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
    DisplayModeDropdown.SelectedIndex = selectedIndex

  End Sub

  ' Reset all of a user's personalization data for the page.
  Protected Sub LinkButton1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    _manager.Personalization.ResetPersonalizationState()
    
  End Sub

  ' If not in User personalization scope, toggle into it.
  Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.Scope = PersonalizationScope.Shared Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub
   
  ' If not in Shared scope, and if user is allowed, toggle the scope.
  Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.CanEnterSharedScope AndAlso _
      _manager.Personalization.Scope = PersonalizationScope.User Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub

</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

Druhá část příkladu kódu obsahuje kód pro vlastní CatalogZone ovládací prvky a WebPart ovládací prvky. Kód CatalogZone ovládacího prvku ukazuje, jak dědit z CatalogZone třídy a přizpůsobit její vlastnosti nastavením některých výchozích hodnot vlastností v konstruktoru. Zdrojový kód také ukazuje, jak vytvořit vlastní WebPart třídu s názvem TextDisplayWebPart. Toto je ovládací prvek přidružený k . Soubor popisu webové části, který budete importovat jako součást tohoto příkladu kódu. Po importu souboru s popisem pomocí ImportCatalogPart ovládacího prvku na webové stránce budete moct přidat TextDisplayWebPart ovládací prvek na stránku, který je plně předkonfigurovaný tak, jak je uvedeno v souboru popisu.

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. Tento příklad kódu používá dynamickou kompilaci, takže pokud chcete tento příklad spustit tímto způsobem, pojmenujte soubor zdrojového kódu a přidejte ho do podsložky App_Code kořenového adresáře vaší webové aplikace. 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.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

namespace Samples.AspNet.CS.Controls
{
  // Create a customized CatalogZone control by setting 
  // some properties in the constructor.
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class MyCatalogZone : CatalogZone
  {
    public MyCatalogZone()
    {
      this.HeaderText = "My Company Catalog";
      this.HeaderCloseVerb.Text = "Close Catalog";
      this.CloseVerb.Text = "Close Catalog";
    }
  }

  // Create a custom WebPart control to add to a WebPartZone.
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class TextDisplayWebPart : WebPart
  {
    private String _contentText = null;
    TextBox input;
    Label DisplayContent;
    Literal lineBreak;

    [Personalizable(), WebBrowsable]
    public String ContentText
    {
      get { return _contentText; }
      set { _contentText = value; }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      this.Controls.Add(DisplayContent);

      lineBreak = new Literal();
      lineBreak.Text = @"<br />";
      Controls.Add(lineBreak);

      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);
    }

    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.Collections
Imports System.ComponentModel
Imports System.Drawing
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

  ' Create a custom CatalogZone control by setting some 
  ' properties in the constructor.
  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class MyCatalogZone
    Inherits CatalogZone

    Public Sub New()
      Me.HeaderText = "My Company Catalog"
      Me.HeaderCloseVerb.Text = "Close Catalog"
      Me.CloseVerb.Text = "Close Catalog"
    End Sub

  End Class


  ' Create a custom WebPart to add to a WebPartZone.
  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class TextDisplayWebPart
    Inherits WebPart
    Private _contentText As String = Nothing
    Private _fontStyle As String = Nothing
    Private input As TextBox
    Private DisplayContent As Label
    Private lineBreak As Literal

    <Personalizable(), WebBrowsable()> _
    Public Property ContentText() As String
      Get
        Return _contentText
      End Get
      Set(ByVal value As String)
        _contentText = value
      End Set
    End Property

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      DisplayContent = New Label()
      DisplayContent.BackColor = Color.LightBlue
      DisplayContent.Text = Me.ContentText
      Me.Controls.Add(DisplayContent)

      lineBreak = New Literal()
      lineBreak.Text = "<br />"
      Controls.Add(lineBreak)

      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)

    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

Třetí částí příkladu kódu je webová stránka, která obsahuje ovládací prvky. Obsahuje direktivu Register pro uživatelský ovládací prvek a další direktivu pro zdrojový soubor s vlastními ovládacími prvky. Všimněte si, že v druhé direktivě není pojmenováno sestavení, protože příklad nepoužívá sestavení, ale používá dynamickou kompilaci se zdrojovým kódem umístěným v podsložce App_Code. Webová stránka deklaruje WebPartZone ovládací prvek a v rámci svého podřízeného <zonetemplate>BulletedList prvku deklaruje ovládací prvek. I když se jedná o standardní ASP.NET ovládací prvek, bude mít za běhu úplnou funkčnost webových částí, protože WebPartManager ovládací prvek zabalí všechny ovládací prvky serveru umístěné v objektu WebPartZoneGenericWebPart , aby se ostatní serverové ovládací prvky mohly účastnit aplikací webových částí. V této zóně je také deklarován vlastní WebPart ovládací prvek s názvem TextDisplayWebPart. Všimněte si, že tento ovládací prvek má deklarovaný atribut ExportMode="All" . To vám umožní exportovat . Soubor popisu webové části, který obsahuje hodnoty vlastností ovládacího prvku, které mohou být importovány jinými uživateli, aby se předkonfigurovaný ovládací prvek přidal na jiné webové stránky.

Poznámka

Chcete-li uživatelům aplikace webových částí povolit export souboru popisu ovládacích WebPart prvků, musíte také povolit funkci exportu ve webové aplikaci přidáním enableExport="true" atributu do elementu <webParts> (který je podřízený <system.web> prvek) v souboru Web.config. Export je ve výchozím nastavení zakázaný, takže pokud jste export pro aplikaci ještě nepovolili, upravte soubor Web.config a udělejte to teď.

Webová stránka také deklaruje vlastní CatalogZone ovládací prvek a v něm prvek, <zonetemplate> který obsahuje ovládací prvek ImportCatalogPart . Uživatel použije tento ovládací prvek za běhu k importu . Soubor popisu webové části pro vlastní WebPart ovládací prvek.

<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ Register TagPrefix="aspSample"
  Namespace="Samples.AspNet.CS.Controls" %> 
  
<!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 runat="server">
    <title>Untitled Page</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">
      <ZoneTemplate>
        <asp:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <asp:ListItem Value="http://msdn.microsoft.com">
            MSDN
          </asp:ListItem>
          <asp:ListItem Value="http://www.asp.net">
            ASP.NET
          </asp:ListItem>
          <asp:ListItem Value="http://www.msn.com">
            MSN
          </asp:ListItem>
        </asp:BulletedList>
        <aspsample:textdisplaywebpart id="wp1" runat="server" 
           Title="My Text Display WebPart" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <aspSample:MyCatalogZone ID="CatalogZone1" runat="server">
      <ZoneTemplate>
        <asp:ImportCatalogPart id="ImportCatalogPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyCatalogZone>
  </form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ Register TagPrefix="aspSample"
  Namespace="Samples.AspNet.VB.Controls"  %> 

<!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 runat="server">
    <title>Untitled Page</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">
      <ZoneTemplate>
        <asp:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <asp:ListItem Value="http://msdn.microsoft.com">
            MSDN
          </asp:ListItem>
          <asp:ListItem Value="http://www.asp.net">
            ASP.NET
          </asp:ListItem>
          <asp:ListItem Value="http://www.msn.com">
            MSN
          </asp:ListItem>
        </asp:BulletedList>
        <aspsample:textdisplaywebpart id="wp1" runat="server" 
           Title="My Text Display WebPart" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <aspSample:MyCatalogZone ID="CatalogZone1" runat="server">
      <ZoneTemplate>
        <asp:ImportCatalogPart id="ImportCatalogPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyCatalogZone>
  </form>
</body>
</html>

Teď spusťte příklad kódu. Načtěte webovou stránku v prohlížeči. Prvním krokem je export souboru . Soubor TextDisplayWebPart popisu webové části ovládacího prvku. Klikněte na nabídku sloves ve vlastním ovládacím prvku (reprezentované šipkou dolů v záhlaví) a klikněte na Exportovat. Podle pokynů uložte soubor s popisem ovládacího prvku. Otevřete . Soubor popisu webové části v editoru a upravte hodnotu textu vlastnosti nadpisu. <property> Vyhledejte element, který má atribut name="Title", a upravte text nadpisu, který je obsažen mezi levou a pravou <property> značkou. Teď zavřete webovou stránku a upravte zdroj stránky v editoru. <aspSample:TextDisplayWebPart> Odstraňte element deklarace ovládacího prvku a pak soubor uložte a zavřete.

Znovu načtěte webovou stránku v prohlížeči. Ovládací TextDisplayWebPart prvek by se neměl zobrazit, protože jste ho odebrali. Pomocí ovládacího prvku rozevíracího seznamu Režim zobrazení a výběrem možnosti Katalog přepněte stránku do režimu katalogu. Všimněte si, že se zobrazí vlastní CatalogZone ovládací prvek společně s ovládacím ImportCatalogPart prvku. Kliknutím na tlačítko Procházet vyhledejte . Soubor popisu webové části, který jste exportovali pro TextDisplayWebPart ovládací prvek. Můžete kliknout na Nahrát, zaškrtnout políčko vedle importovaného ovládacího prvku a kliknutím na Přidat ho přidat na stránku. Kliknutím na Zavřít katalog vrátíte stránku do normálního režimu procházení. Importovaný ovládací prvek by se teď měl zobrazit na stránce a název, který se zobrazí v záhlaví ovládacího prvku, by měl být text nadpisu, který jste přidali do . Soubor popisu webové části.

Poznámky

V rámci sady ovládacích prvků webové části je zóna oblast na webové stránce, která obsahuje ovládací prvky webových částí. Zóna webových částí je vytvořena ovládacím prvku zóny, což je typ CompositeControl navržený tak, aby obsahoval další ovládací prvky. Primárními funkcemi zóny je rozložení ovládacích prvků, které obsahuje, a poskytnutí společného uživatelského rozhraní pro tyto ovládací prvky. Obecné informace o zónách a způsobu jejich použití v aplikacích webových částí najdete v základních WebZone třídách a přehledu sady ovládacích částí webových částí.

Klíčovou funkcí ovládacích prvků webových částí je to, že koncovým uživatelům umožňují upravovat (nebo přizpůsobovat) webové stránky podle svých preferencí a ukládat si přizpůsobená nastavení pro budoucí relace prohlížeče. Jedním z aspektů úprav stránek webových částí je možnost přidat WebPart ovládací prvky nebo jiné serverové ovládací prvky na stránku webových částí. Ovládací CatalogZone prvek poskytuje seznam nebo katalog ovládacích prvků, které mohou uživatelé přidat na stránku.

Ovládací CatalogZone prvek je jedním ze základních ovládacích prvků v sadě ovládacích prvků webových částí. Odvozuje se od CatalogZoneBase třídy a většina jeho chování je zděděna z této třídy. Třída CatalogZone v podstatě přidá do základní třídy šablonu zóny, což je implementace ITemplate rozhraní. Šablona zóny umožňuje vývojářům deklarativně přidat CatalogPart ovládací prvky do zóny ve formátu trvalosti stránky.

Důležité

Zóna CatalogZone může obsahovat pouze CatalogPart ovládací prvky a naopak ovládací CatalogPart prvky mohou být umístěny pouze v zónách, které jsou odvozeny z CatalogZoneBase třídy, například CatalogZone.

Ovládací CatalogZone prvek se zobrazí pouze tehdy, když uživatel přepne webovou stránku do režimu zobrazení katalogu (CatalogDisplayMode). Katalog může obsahovat několik typů ovládacích CatalogPart prvků. Každý CatalogPart ovládací prvek je typ kontejneru, který obsahuje serverové ovládací prvky, které uživatelé můžou přidat na stránku. Ovládací CatalogPart prvky se liší podle toho, odkud ovládací prvky serveru, které obsahují, pocházejí. Následující tabulka obsahuje CatalogPart souhrn ovládacích prvků poskytovaných se sadou ovládacích prvků webové části a pro každý ovládací prvek, jaký druh serverových ovládacích prvků obsahuje.

Řízení Description
PageCatalogPart Udržuje odkazy na ovládací prvky, které byly na stránce uzavřeny. Uživatelé můžou tyto ovládací prvky znovu otevřít (přidat zpět na stránku).
DeclarativeCatalogPart Obsahuje odkazy na ovládací prvky, které jsou deklarovány v katalogu webových částí ve značkách webové stránky. Tyto ovládací prvky můžou uživatelé přidat na webovou stránku.
ImportCatalogPart Poskytuje uživatelské rozhraní pro uživatele, aby nahrál definiční soubor (soubor XML s příponou . Rozšíření webové části a zadaný formát, který obsahuje informace o stavu) pro ovládací prvek do katalogu, aby bylo možné ovládací prvek přidat na webovou stránku.

Vzhledem k tomu, že CatalogZone třída přidává pouze šablonu zóny k chování své základní třídy, má několik členů. Konstruktor CatalogZone je konstruktor bez parametrů; pomocí něj můžete inicializovat novou instanci CatalogZone třídy. Vlastnost ZoneTemplate získá nebo nastaví odkaz na ITemplate objekt, který obsahuje ovládací prvky pro zónu. Metoda CreateCatalogParts je kritická. Přepíše základní metodu a vytvoří kolekci všech CatalogPart ovládacích prvků obsažených v šabloně zóny.

Poznámka

Aby tlačítka v uživatelském CatalogZone rozhraní správně fungovala, vyžadují skriptování na straně klienta. Pokud je skriptování v prohlížeči zakázané, uživatel nebude moct provádět akce prostřednictvím CatalogZone uživatelského rozhraní.

Usnadnění

Značky vykreslované ve výchozím nastavení pro tento ovládací prvek nemusí odpovídat standardům přístupnosti, jako jsou pokyny wcAG (Web Content Accessibility Guidelines 1.0) priority 1. Podrobnosti o podpoře přístupnosti pro tento ovládací prvek najdete v tématu ASP.NET Ovládací prvky a přístupnost.

Poznámky pro dědice

Pokud chcete mít větší kontrolu nad vykreslováním a chováním uživatelského rozhraní katalogu, můžete vytvořit vlastní CatalogZone třídy. Pokud nepotřebujete uživatelům ovládacího prvku poskytnout možnost přidávat CatalogPart ovládací prvky deklarativně, můžete dědit přímo z CatalogZoneBase třídy. Pokud chcete povolit, aby ovládací prvky byly přidány deklarativně, jednoduchý přístup je dědit z CatalogZone třídy, protože poskytuje šablonu základní zóny.

Pokud dědíte z CatalogZone třídy, můžete přepsat metodu CreateCatalogParts() a použít metodu k přidání vlastních CatalogPart ovládacích prvků do CatalogPartCollectiontřídy , pokud chcete mít větší programovou kontrolu nad přidáváním vlastních CatalogPart ovládacích prvků do vaší zóny.

Konstruktory

CatalogZone()

Inicializuje novou instanci CatalogZone třídy .

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

Získá odkaz na WebPartVerb objekt, který umožňuje koncovým uživatelům přidat ovládací prvky z katalogu na stránku webových částí.

(Zděděno od CatalogZoneBase)
AppRelativeTemplateSourceDirectory

Získá nebo nastaví aplikaci relativní virtuální adresář nebo UserControl objektuPage, který obsahuje tento ovládací prvek.

(Zděděno od Control)
AssociatedDisplayModes

Získá kolekci WebPartDisplayMode objektů, které jsou přidruženy k určité ToolZone zóně.

(Zděděno od ToolZone)
Attributes

Získá kolekci libovolných atributů (pouze pro vykreslování), které neodpovídají vlastnostem ovládacího prvku.

(Zděděno od WebControl)
BackColor

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

(Zděděno od WebControl)
BackImageUrl

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

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

Získá odkaz na instanci CatalogPartChrome třídy přidružené k CatalogZoneBase zóně.

(Zděděno od CatalogZoneBase)
CatalogParts

Získá kolekci CatalogPart všech ovládacích prvků obsažených v CatalogZoneBase zóně.

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

Získá odkaz na WebPartVerb objekt, který umožňuje koncovým uživatelům zavřít uživatelské rozhraní katalogu (UI) a vrátit stránku do normálního režimu procházení.

(Zděděno od CatalogZoneBase)
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 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í kaskádové šablony stylů (CSS) třídy vykreslené ovládacím prvkem webového serveru v klientovi.

(Zděděno od WebControl)
DataItemContainer

Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataItemContainer.

(Zděděno od Control)
DataKeysContainer

Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataKeysControl.

(Zděděno od Control)
DesignMode

Získá hodnotu označující, zda je ovládací prvek použit na návrhové ploše.

(Zděděno od Control)
Display

Získá hodnotu, která označuje, zda ToolZone je aktuálně zobrazen ovládací prvek.

(Zděděno od ToolZone)
EditUIStyle

Získá atributy stylu pro upravitelné ovládací prvky obsažené v ovládacím prvku ToolZone .

(Zděděno od ToolZone)
EmptyZoneText

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

(Zděděno od CatalogZoneBase)
EmptyZoneTextStyle

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

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

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

(Zděděno od WebZone)
Events

Získá seznam delegátů obslužné rutiny události pro ovládací prvek. Tato vlastnost je jen ke čtení.

(Zděděno od Control)
Font

Získá vlastnosti písma přidružené k ovládacímu prvku webového serveru.

(Zděděno od WebControl)
FooterStyle

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

(Zděděno od WebZone)
ForeColor

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

(Zděděno od WebControl)
HasAttributes

Získá hodnotu označující, zda ovládací prvek má nastaveny atributy.

(Zděděno od WebControl)
HasChildViewState

Získá hodnotu označující, zda podřízené ovládací prvky aktuálního serveru mají nějaké uložené nastavení stavu zobrazení.

(Zděděno od Control)
HasFooter

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

(Zděděno od WebZone)
HasHeader

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

(Zděděno od WebZone)
HeaderCloseVerb

Získá odkaz na WebPartVerb objekt v záhlaví ToolZone ovládacího prvku, který se používá k zavření ovládacího prvku.

(Zděděno od ToolZone)
HeaderStyle

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

(Zděděno od WebZone)
HeaderText

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

(Zděděno od CatalogZoneBase)
HeaderVerbStyle

Získá atributy stylu pro všechny příkazy záhlaví zobrazené v ovládacím prvku ToolZone .

(Zděděno od ToolZone)
Height

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

(Zděděno od WebControl)
ID

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

(Zděděno od Control)
IdSeparator

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

(Zděděno od Control)
InstructionText

Získá nebo nastaví text v zóně, která poskytuje pokyny pro koncové uživatele.

(Zděděno od CatalogZoneBase)
InstructionTextStyle

Získá atributy stylu pro text instrukce, který se zobrazí v horní části ovládacího prvku ToolZone .

(Zděděno od ToolZone)
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 povolen ovládací prvek.

(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)
LabelStyle

Získá atributy stylu pro obsah popisků, které se zobrazí spolu s ovládacími prvky pro úpravy v rámci ovládacího prvku ToolZone . Odvozené ToolZone ovládací prvky, například CatalogZone a EditorZone, aplikují styly na popisky.

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

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

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

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

(Zděděno od WebZone)
PartChromeStyle

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

(Zděděno od WebZone)
PartChromeType

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

(Zděděno od WebZone)
PartLinkStyle

Získá objekt, který obsahuje atributy stylu pro CatalogPart ovládací prvky, které nejsou aktuálně vybrány v zóně.

(Zděděno od CatalogZoneBase)
PartStyle

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

(Zděděno od WebZone)
PartTitleStyle

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

(Zděděno od WebZone)
RenderClientScript

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

(Zděděno od WebZone)
RenderingCompatibility

Získá hodnotu, která určuje ASP.NET verze, která vykreslovala HTML bude kompatibilní s.

(Zděděno od Control)
SelectedCatalogPartID

Získá nebo nastaví řetězec jako identifikátor pro aktuálně vybraný CatalogPart ovládací prvek v zóně.

(Zděděno od CatalogZoneBase)
SelectedPartLinkStyle

Získá objekt, který obsahuje atributy stylu pro CatalogPart ovládací prvek, který je aktuálně vybrán v zóně.

(Zděděno od CatalogZoneBase)
SelectTargetZoneText

Získá nebo nastaví text spolu s ovládacím prvku v uživatelském rozhraní katalogu (UI), který umožňuje uživatelům zvolit, do které zóny se mají přidat vybrané ovládací prvky.

(Zděděno od CatalogZoneBase)
ShowCatalogIcons

Získá nebo nastaví hodnotu, která označuje, zda ovládací prvky serveru v katalogu zobrazí jejich přidružené ikony v katalogu.

(Zděděno od CatalogZoneBase)
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í vzhled pro použití ovládacího prvku.

(Zděděno od WebControl)
Style

Získá kolekci textových 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 disabled atribut vykresleného elementu HTML na "zakázáno", pokud je vlastnost ovládacího prvku IsEnabled je false.

(Zděděno od CompositeControl)
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 WebZone)
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í serverový ovládací prvek.

(Zděděno od Control)
ToolTip

Získá nebo nastaví text zobrazený, když ukazatel myši najede na ovládací prvek webového serveru.

(Zděděno od WebControl)
UniqueID

Získá jedinečný hierarchicky kvalifikovaný identifikátor serverového ovládacího prvku.

(Zděděno od Control)
ValidateRequestMode

Získá nebo nastaví hodnotu, která označuje, zda ovládací prvek kontroluje vstup klienta z prohlížeče pro potenciálně nebezpečné hodnoty.

(Zděděno od Control)
VerbButtonType

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

(Zděděno od WebZone)
VerbStyle

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

(Zděděno od WebZone)
ViewState

Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení serverového ovládacího prvku napříč více požadavky na stejnou stránku.

(Zděděno od Control)
ViewStateIgnoresCase

Získá hodnotu, která označuje, zda StateBag objekt nerozlišuje malá a velká 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í (UI) prvek na stránce.

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

(Zděděno od WebZone)
Width

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

(Zděděno od WebControl)
ZoneTemplate

Získá nebo nastaví šablonu tak, aby obsahovala podřízené CatalogZone ovládací prvky v rámci ovládacího prvku ve formátu trvalosti stránky.

Metody

AddAttributesToRender(HtmlTextWriter)

Přidá atributy a styly HTML, které je potřeba vykreslit do zadaného HtmlTextWriterTag. Tuto metodu používají především vývojáři ovládacích prvků.

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

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

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

Upozorní ovládací prvek serveru, že byl analyzován 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 null.

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

Přepne webovou stránku z režimu zobrazení katalogu do normálního režimu procházení.

(Zděděno od CatalogZoneBase)
CopyBaseAttributes(WebControl)

Zkopíruje vlastnosti neza zapouzdřené 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)
CreateCatalogPartChrome()

Vytvoří instanci objektu CatalogPartChrome sloužící k vykreslení prvků periferního uživatelského rozhraní (UI) pro CatalogPart ovládací prvky v zóně.

(Zděděno od CatalogZoneBase)
CreateCatalogParts()

Vytvoří instanci každého CatalogPart typu, který je deklarován v zóně.

CreateChildControls()

Vytvoří sadu podřízených ovládacích prvků přidružených k CatalogZoneBase zóně.

(Zděděno od CatalogZoneBase)
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ý je interně používán třídou k implementaci všech vlastností souvisejících se stylem WebControl . Tuto metodu používají především vývojáři ovládacích prvků.

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

Vytvoří vazbu zdroje dat na CompositeControl a všechny jeho podřízené ovládací prvky.

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

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

Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek se zadaným id a celočíselným číslem zadaným v parametru pathOffset , což pomáhá při hledání. Tuto verzi metody byste neměli FindControl přepsat.

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

Nastaví fokus vstupu na ovládací prvek.

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

Získá data v době návrhu pro ovládací prvek.

(Zděděno od Control)
GetEffectiveChromeType(Part)

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

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

Zničí kolekci ovládacích prvků přidružených CatalogPart k CatalogZoneBase zóně.

(Zděděno od CatalogZoneBase)
IsLiteralContent()

Určuje, zda serverový ovládací prvek obsahuje pouze obsah literálu.

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

Načte stav z předchozího požadavku na stránku pro vlastnosti ovládacího prvku, které by měly přetrvávat napříč zpětnými operacemi, i když je stav zobrazení na ovládacím prvku zakázán.

(Zděděno od CatalogZoneBase)
LoadPostData(String, NameValueCollection)

Zpracuje stav zaškrtávacích políček, která odpovídají ovládacím prvkům WebPart v katalogu, když je stránka odeslána zpět na server.

(Zděděno od CatalogZoneBase)
LoadViewState(Object)

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

(Zděděno od CatalogZoneBase)
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)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)

Poskytuje deklaraci základní metody, kterou mohou odvozené ToolZone ovládací prvky přepsat pro zpracování podrobností o změně režimů zobrazení stránky pro specializovanou zónu.

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

Zaregistruje objekt stránky tak, aby stránka vyžadovala stav ovládacího prvku.

(Zděděno od CatalogZoneBase)
OnLoad(EventArgs)

Load Vyvolá událost.

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

PreRender Vyvolá událost a zaregistruje objekt stránky tak, aby vyžadoval zpětné odeslání.

(Zděděno od CatalogZoneBase)
OnSelectedWebPartChanged(Object, WebPartEventArgs)

Poskytuje deklaraci základní metody, kterou mohou odvozené ToolZone ovládací prvky přepsat, aby zvládly událost změny, které webové části ovládacího prvku je vybrán v rámci specializované zóny.

(Zděděno od ToolZone)
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)
RaisePostBackEvent(String)

Provede akce spojené s některou ze zónových příkazů nebo vyvolá událost, která odešle příspěvek zpět na server.

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

Vykreslí zónu určenému HtmlTextWriter objektu.

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

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

(Zděděno od WebZone)
RenderBody(HtmlTextWriter)

Přepíše základní metodu pro vykreslení oblasti těla zóny odvozené z CatalogZoneBase třídy .

(Zděděno od CatalogZoneBase)
RenderCatalogPartLinks(HtmlTextWriter)

Vykreslí odkazy na jednotlivé CatalogPart ovládací prvky v CatalogZoneBase zóně.

(Zděděno od CatalogZoneBase)
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í celý obsah ovládacího prvku zóny mezi počáteční a koncovou značkou na zadaný HtmlTextWriter objekt.

(Zděděno od WebZone)
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 HTML ovládacího prvku do zadaného zapisovače. Tuto metodu používají především vývojáři ovládacích prvků.

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

Vykreslí oblast zápatí pro zónu CatalogZoneBase .

(Zděděno od CatalogZoneBase)
RenderHeader(HtmlTextWriter)

Přepíše základní metodu tak, aby poskytovala specializované vykreslování oblasti záhlaví vyžadované ovládacími ToolZone prvky.

(Zděděno od ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)

Vykreslí jednotlivé sloveso ToolZone pomocí ovládacího prvku.

(Zděděno od ToolZone)
RenderVerbs(HtmlTextWriter)

Vykreslí příkazy v oblasti zápatí CatalogZoneBase zóny.

(Zděděno od CatalogZoneBase)
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 CatalogZoneBase ovládacího prvku, ke kterým dojde po odeslání webové stránky zpět na server.

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

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

(Zděděno od CatalogZoneBase)
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í datového klíče trasování a hodnoty dat trasování.

(Zděděno od Control)
SetTraceData(Object, Object, Object)

Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí trasovaného objektu, datového klíče 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.

(Zděděno od CatalogZoneBase)

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

Vyvolá se 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 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 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)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Implementuje metodu LoadPostData(String, NameValueCollection) voláním LoadPostData(String, NameValueCollection) metody CatalogZoneBase třídy.

(Zděděno od CatalogZoneBase)
IPostBackDataHandler.RaisePostDataChangedEvent()

Popis tohoto člena najdete v tématu RaisePostDataChangedEvent().

(Zděděno od CatalogZoneBase)
IPostBackEventHandler.RaisePostBackEvent(String)

Implementuje metodu RaisePostBackEvent(String) .

(Zděděno od ToolZone)

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)

Umožňuje dynamické chování dat pro zadaný datový ovládací prvek.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Umožňuje dynamické chování dat pro zadaný datový ovládací prvek.

EnableDynamicData(INamingContainer, Type, Object)

Umožňuje dynamické chování dat pro zadaný datový ovládací prvek.

Platí pro

Viz také