CatalogZoneBase Třída

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Slouží jako základní třída pro všechny ovládací prvky zóny, které fungují jako katalogy. Katalogy obsahují seznamy ovládacích WebPart prvků, které mohou uživatelé přidat na webovou stránku.

public ref class CatalogZoneBase abstract : System::Web::UI::WebControls::WebParts::ToolZone, System::Web::UI::IPostBackDataHandler

public abstract class CatalogZoneBase : System.Web.UI.WebControls.WebParts.ToolZone, System.Web.UI.IPostBackDataHandler

type CatalogZoneBase = class
    inherit ToolZone
    interface IPostBackDataHandler

Public MustInherit Class CatalogZoneBase
Inherits ToolZone
Implements IPostBackDataHandler

Dědičnost

Object

Control

WebControl

CompositeControl

WebZone

ToolZone

CatalogZoneBase

Odvozené

System.Web.UI.WebControls.WebParts.CatalogZone

Implementuje

IPostBackDataHandler

Příklady

Následující příklad kódu ukazuje několik deklarativních a programových použití CatalogZoneBase třídy. Vzhledem k tomu, že třída je abstraktní, příklady kódu používají odvozenou CatalogZone třídu, která se dodává s sadou ovládacích prvků webových částí a demonstruje vlastnosti a metody, které dědí z CatalogZoneBase třídy .

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.

• Webová stránka, která obsahuje odkaz na CatalogZone ovládací prvek, a kód, který demonstruje použití některých členů třídy klíčů CatalogZoneBase .

• Vlastní WebPart ovládací prvek, který je přidán do vlastního CatalogZone ovládacího prvku.

• Popis fungování příkladu v prohlížeči

První část tohoto příkladu kódu je uživatelský ovládací prvek, který umožňuje změnit režimy zobrazení na 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="&nbsp;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="&nbsp;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 je webová stránka, která obsahuje deklarativní odkaz na ovládací prvek CatalogZone . V horní části stránky jsou dvě Register direktivy – jedna pro uživatelský ovládací prvek a jedna pro vlastní WebPart ovládací prvek. Všimněte si, že pod <asp:WebPartZone> elementem <asp: CatalogZone> je element, který obsahuje deklarativní odkazy na vlastní WebPart ovládací prvek a na ovládací prvek ASP.NET Calendar . Zóna má také řadu značek a vlastností nastavených k určení jejího vzhledu a chování. <script> Mezi značkami na stránce je řada kódů pro zpracování událostí, z nichž většina ukazuje různá programová použití CatalogZoneBase členů.

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

  WebPartManager manager;

  protected void WebPartManager1_DisplayModeChanged(object sender,
    WebPartDisplayModeEventArgs e)
  {
    if (e.OldDisplayMode.Name != "Catalog")
      Panel1.Visible = true;
    else
      Panel1.Visible = false;
  }
  
  // <snippet3>
  protected void Button1_Click(object sender, EventArgs e)
  {
    if (CatalogZone1.AddVerb.Enabled)
    {
      CatalogZone1.AddVerb.Enabled = false;
      CatalogZone1.CloseVerb.Enabled = false;
    }
    else
    {
      CatalogZone1.AddVerb.Enabled = true;
      CatalogZone1.CloseVerb.Enabled = true;
    }
  }
  // </snippet3>

  // <snippet4>
  protected void Button2_Click(object sender, EventArgs e)
  {
    Label1.Text = "<h3>CatalogPart List</h3>";
    foreach(CatalogPart part in CatalogZone1.CatalogParts)
    {
      Label1.Text += part.ID + "<br />";
    }
  }
  // </snippet4>

  // <snippet5>
  protected void Button3_Click(object sender, EventArgs e)
  {
    CatalogZone1.SelectTargetZoneText = "Add to zone";
    CatalogZone1.EmptyZoneText = "Zone is empty";
    CatalogZone1.HeaderText = "My Updated Header";
    CatalogZone1.InstructionText = "My Updated Instructions";
  }
  // </snippet5>

  // <snippet6>
  protected void Button4_Click(object sender, EventArgs e)
  {
    Label1.Text = CatalogZone1.SelectedCatalogPartID;
  }
  // </snippet6>

  // <snippet7>
  protected void Button5_Click(object sender, EventArgs e)
  {
    CatalogZone1.PartLinkStyle.ForeColor = System.Drawing.Color.Red;
    CatalogZone1.SelectedPartLinkStyle.ForeColor = 
      System.Drawing.Color.Blue;
  }
  // </snippet7>

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>
      CatalogZoneBase Example
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server" 
        OnDisplayModeChanged="WebPartManager1_DisplayModeChanged" />
      <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
      <asp:webpartzone id="zone1" 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>
        </ZoneTemplate>        
      </asp:webpartzone>
      <asp:CatalogZone ID="CatalogZone1" runat="server"
        EmptyZoneText="No controls are in the zone."
        HeaderText="My Web Parts Catalog"
        InstructionText="Add Web Parts controls to the zone."
        PartLinkStyle-Font-Italic="true"
        SelectedPartLinkStyle-Font-Bold="true"
        SelectTargetZoneText="Select zone"
        AddVerb-Text="Add Control"
        CloseVerb-Description="Close and return to browse mode." 
        SelectedCatalogPartID="Currently Selected CatalogPart ID.">
        <ZoneTemplate>
          <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
            runat="server">
            <WebPartsTemplate>
              <aspSample:TextDisplayWebPart 
                runat="server"   
                id="textwebpart" 
                title = "Text Content WebPart" 
                ExportMode="All"/>  
              <asp:Calendar id="calendar1" runat="server" 
                Title="My Calendar" />               
            </WebPartsTemplate>
          </asp:DeclarativeCatalogPart> 
          <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
          <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
        </ZoneTemplate>
      </asp:CatalogZone>
      <hr />
      <asp:CatalogZone ID="CatalogZone2" runat="server"
        BorderWidth="2"
        HeaderText="My Empty CatalogZone"
        EmptyZoneText="No controls are in the zone." />
      <hr />
      <asp:Panel ID="Panel1" runat="server" Visible="false">
        <asp:Button ID="Button1" runat="server" Width="200" 
          Text="Enable or Disable Verbs" 
          OnClick="Button1_Click" />
        <br />
        <asp:Button ID="Button2" runat="server" Width="200" 
          Text="List CatalogParts" OnClick="Button2_Click" />  
        <br />
        <asp:Button ID="Button3" runat="server" Width="200" 
          Text="Set Zone Text Properties" OnClick="Button3_Click" />  
        <br />   
        <asp:Button ID="Button4" runat="server" Width="200" 
          Text="Show Selected CatalogPart ID" OnClick="Button4_Click"  />  
        <br /> 
        <asp:Button ID="Button5" runat="server" Width="200" 
          Text="Change Part Link Styles" OnClick="Button5_Click"  />  
        <br />     
        <asp:Label ID="Label1" runat="server" Text="" /></asp:Panel>
    </form>
  </body>
</html>

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


  Dim manager As WebPartManager


  Protected Sub WebPartManager1_DisplayModeChanged(ByVal sender _
    As Object, ByVal e As WebPartDisplayModeEventArgs)
    If e.OldDisplayMode.Name <> "Catalog" Then
      Panel1.Visible = True
    Else
      Panel1.Visible = False
    End If

  End Sub
   
  ' <snippet3>
  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    If CatalogZone1.AddVerb.Enabled Then
      CatalogZone1.AddVerb.Enabled = False
      CatalogZone1.CloseVerb.Enabled = False
    Else
      CatalogZone1.AddVerb.Enabled = True
      CatalogZone1.CloseVerb.Enabled = True
    End If

  End Sub
  ' </snippet3>
  
  ' <snippet4>
  Protected Sub Button2_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    Label1.Text = "<h3>CatalogPart List</h3>"
    Dim part As CatalogPart
    For Each part In CatalogZone1.CatalogParts
      Label1.Text += part.ID + "<br />"
    Next part

  End Sub
  ' </snippet4>
  
  ' <snippet5>
  Protected Sub Button3_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    CatalogZone1.SelectTargetZoneText = "Add to zone"
    CatalogZone1.EmptyZoneText = "Zone is empty"
    CatalogZone1.HeaderText = "My Updated Header"
    CatalogZone1.InstructionText = "My Updated Instructions"
  End Sub
  ' </snippet5>
  
  ' <snippet6>
  Protected Sub Button4_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    Label1.Text = CatalogZone1.SelectedCatalogPartID
  End Sub
  ' </snippet6>
  
  ' <snippet7>
  Protected Sub Button5_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    CatalogZone1.PartLinkStyle.ForeColor = _
      System.Drawing.Color.Red
    CatalogZone1.SelectedPartLinkStyle.ForeColor = _
      System.Drawing.Color.Blue
  End Sub
  ' </snippet7>
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>
      CatalogZoneBase Example
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server" 
        OnDisplayModeChanged="WebPartManager1_DisplayModeChanged" />
      <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
      <asp:webpartzone id="zone1" 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>
        </ZoneTemplate>        
      </asp:webpartzone>
      <asp:CatalogZone ID="CatalogZone1" runat="server"
        EmptyZoneText="No controls are in the zone."
        HeaderText="My Web Parts Catalog"
        InstructionText="Add Web Parts controls to the zone."
        PartLinkStyle-Font-Italic="true"
        SelectedPartLinkStyle-Font-Bold="true"
        SelectTargetZoneText="Select zone"
        AddVerb-Text="Add Control"
        CloseVerb-Description="Close and return to browse mode." 
        SelectedCatalogPartID="Currently Selected CatalogPart ID.">
        <ZoneTemplate>
          <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
            runat="server">
            <WebPartsTemplate>
              <aspSample:TextDisplayWebPart 
                runat="server"   
                id="textwebpart" 
                title = "Text Content WebPart" 
                ExportMode="All"/>  
              <asp:Calendar id="calendar1" runat="server" 
                Title="My Calendar" />               
            </WebPartsTemplate>
          </asp:DeclarativeCatalogPart> 
          <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
          <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
        </ZoneTemplate>
      </asp:CatalogZone>
      <hr />
      <asp:CatalogZone ID="CatalogZone2" runat="server"
        BorderWidth="2"
        HeaderText="My Empty CatalogZone"
        EmptyZoneText="No controls are in the zone." />
      <hr />
      <asp:Panel ID="Panel1" runat="server" Visible="false">
        <asp:Button ID="Button1" runat="server" Width="200" 
          Text="Enable or Disable Verbs" 
          OnClick="Button1_Click" />
        <br />
        <asp:Button ID="Button2" runat="server" Width="200" 
          Text="List CatalogParts" OnClick="Button2_Click" />  
        <br />
        <asp:Button ID="Button3" runat="server" Width="200" 
          Text="Set Zone Text Properties" OnClick="Button3_Click" />  
        <br />   
        <asp:Button ID="Button4" runat="server" Width="200" 
          Text="Show Selected CatalogPart ID" OnClick="Button4_Click"  />  
        <br /> 
        <asp:Button ID="Button5" runat="server" Width="200" 
          Text="Change Part Link Styles" OnClick="Button5_Click"  />  
        <br />     
        <asp:Label ID="Label1" runat="server" Text="" /></asp:Panel>
    </form>
  </body>
</html>

Třetí částí příkladu kódu je vlastní WebPart ovládací prvek s názvem TextDisplayWebPart. Je deklarován v rámci zóny a koncový uživatel ho může přidat z katalogu na stránku. Aby se příklad kódu spustil, musíte tento zdrojový kód zkompilovat. Můžete ho explicitně zkompilovat a vložit výsledné sestavení do složky Bin webu nebo globální mezipaměti sestavení (GPA). Případně můžete zdrojový kód umístit do složky App_Code webu, kde se bude dynamicky kompilovat za běhu. Ukázku obou metod 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
{
  [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

  <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

Příklad kódu funguje tak, že pokud chcete povolit export souborů s popisem webových částí, musíte do souboru Web.config přidat nastavení. Ujistěte se, že máte soubor Web.config ve stejném adresáři jako webová stránka pro tento příklad kódu. V oddílu <system.web> se ujistěte, že existuje element s atributem nastaveným enableExport na true, jak je <webParts> uvedeno v následujícím kódu.

<webParts enableExport="true">

...

</webParts>

Při načítání stránky v prohlížeči můžete výběrem možnosti Katalog z rozevíracího seznamu přepnout do režimu zobrazení katalogu. Když je katalog viditelný, uvidíte dva ovládací prvky serveru, které lze přidat z katalogu na stránku, a můžete si také všimnout v uživatelském rozhraní účinky deklarativního a programového použití CatalogZoneBase členů třídy.

Poznámky

Třída CatalogZoneBase je základní třída, která dědí z třídy ToolZone . Poskytuje základní sadu chování pro odvozené zóny.

Třída CatalogZoneBase poskytuje jedinečné uživatelské rozhraní (UI), které umožňuje uživatelům přidávat WebPart ovládací prvky a další ovládací prvky serveru na webové stránky. Ovládací prvky, které jsou odvozeny z CatalogZoneBase třídy , jsou CatalogZoneovládací prvky skutečně umístěné na webových stránkách. Fungují jako kontejnery pro další ovládací prvky, označované jako CatalogPart ovládací prvky, které vytvářejí seznamy serverových ovládacích prvků, které uživatelé můžou přidat na stránku. Zóny, které jsou odvozeny z CatalogZoneBase třídy , se mohou zobrazit pouze v případech, kdy je stránka v režimu zobrazení katalogu.

Poznámka

Zóna CatalogZoneBase může obsahovat pouze CatalogPart ovládací prvky a naopak ovládací CatalogPart prvky mohou být umístěny pouze v CatalogZoneBase zónách.

Mechanismus pro přidání serverových ovládacích prvků do katalogu je následující sada tří ovládacích prvků, které jsou odvozeny ze základní CatalogPart třídy.

Řízení	Description
PageCatalogPart	Udržuje odkazy na ovládací prvky, které byly na stránce zavřeny. Tyto ovládací prvky můžou uživatelé znovu otevřít (přidat zpátky 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 k nahrání definičního souboru do katalogu, aby bylo možné ovládací prvek přidat na webovou stránku. Definiční soubory jsou xml soubor s . Přípona názvu souboru webové části, která importuje nastavení ovládacího prvku. Ovládací prvek musí být na serveru před importem definičního souboru.

Třída CatalogZoneBase má řadu vlastností, které jsou užitečné pro zobrazení katalogů ovládacích WebPart prvků. Vlastnost AddVerb odkazuje na příkaz, který přidá vybraný ovládací prvek z katalogu na stránku, zatímco CloseVerb vlastnost odkazuje na sloveso, které zavře katalog a vrátí režim zobrazení stránky do režimu procházení. Vlastnost CatalogParts odkazuje na kolekci všech CatalogPart ovládacích prvků v zóně. Několik textově orientovaných vlastností, například EmptyZoneText, HeaderTexta InstructionText, přepisuje základní vlastnosti a poskytuje výchozí text vhodný pro katalogy. Vlastnost SelectTargetZoneText obsahuje text vedle ovládacího prvku rozevíracího seznamu, který umožňuje uživatelům zvolit, do které zóny bude ovládací prvek přidán.

Několik dalších vlastností je součástí CatalogZoneBase třídy . Vlastnost SelectedCatalogPartID je jedinečný identifikátor řetězce pro aktuálně vybraný CatalogPart ovládací prvek. Vlastnost ShowCatalogIcons určuje, zda se mají zobrazit ikony, které lze přidružit k ovládacím prvkům nastavením CatalogIconImageUrl vlastnosti ovládacího prvku WebPart .

Vlastnost PartLinkStyle obsahuje atributy stylu pro odkazy na CatalogPart ovládací prvky, které nejsou aktuálně vybrány v zóně. Naproti tomu SelectedPartLinkStyle vlastnost obsahuje atributy stylu pro odkaz na CatalogPart ovládací prvek, který uživatel aktuálně vybral v zóně.

Kromě vlastností jsou ve CatalogZoneBase třídě také některé metody, kromě standardních metod zpracování událostí a vykreslování zděděných z jiných základních ovládacích prvků, které jsou jedinečně navrženy pro účely zpracování katalogů ovládacích prvků. Metoda CreateCatalogPartChrome vytvoří chrome (prvky periferního uživatelského rozhraní, jako jsou ohraničení, slovesa, ikony a název), které obklopují každý CatalogPart ovládací prvek v zóně, a také zpracovává vykreslování ovládacích prvků. Metoda CreateCatalogParts je abstraktní metoda; odvozené třídy ji přepíšou, aby se vytvořily instance všech CatalogPart ovládacích prvků obsažených v zóně. Metodu InvalidateCatalogParts lze volat odvozenou třídou, pokud se kolekce ovládacích prvků v zóně z nějakého CatalogPart programového důvodu změní a odvozená třída potřebuje znovu vytvořit kolekci. Metoda LoadPostData načte dříve existující stav zaškrtávacích políček vedle WebPart ovládacích prvků v katalogu při každém odeslání stránky zpět na server; SaveControlState naopak metoda uloží stav zaškrtávacích políček. RenderCatalogPartLinks Nakonec metoda poskytuje veškeré vykreslování pro odkazy na každý CatalogPart ovládací prvek obsažený v zóně.

Poznámky pro implementátory

Pokud chcete vyvinout vlastní zónu pro hostování CatalogPart ovládacích prvků, musíte určit, zda chcete poskytnout podporu šablon zóny. Šablona zóny je vytvořena typy, které implementují ITemplate rozhraní, a je nezbytné, pokud chcete umožnit vývojářům stránek používat vlastní zónu odkazovat na CatalogPart ovládací prvky v rámci zóny v deklarativním kódu webové stránky. Pokud potřebujete podporu šablon zóny, měli byste dědit z CatalogZone třídy . Naproti tomu pokud vaše vlastní zóna a její CatalogPart ovládací prvky budou samostatné a budou vytvořeny programově bez jakýchkoli možností, aby vývojáři stránek určovali ovládací prvky deklarativně v šabloně zóny, pak můžete dědit přímo z CatalogZoneBase třídy . Pokud dědíte z CatalogZoneBase třídy , musíte přepsat metodu CreateCatalogParts() a přidat WebPart nebo jiné ovládací prvky serveru, které chcete v katalogu do objektu CatalogPartCollection .

Konstruktory

CatalogZoneBase()

Inicializuje třídu pro použití zděděnou instancí třídy. Tento konstruktor může být volána pouze zděděnou třídou.

Vlastnosti

AccessKey	Získá nebo nastaví přístupový klíč, který umožňuje rychle přejít na ovládací prvek webového serveru. (Zděděno od WebControl)
Adapter	Získá adaptér specifický pro prohlížeč pro ovládací prvek. (Zděděno od Control)
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í.
AppRelativeTemplateSourceDirectory	Získá nebo nastaví aplikace 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ě.
CatalogParts	Získá kolekci CatalogPart všech ovládacích prvků obsažených v CatalogZoneBase zóně.
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í 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í.
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í především vývojáři ovládacích prvků. (Zděděno od WebControl)
ControlStyleCreated	Získá hodnotu označující, zda Style objekt byl vytvořen pro ControlStyle vlastnost. Tuto vlastnost primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl)
CssClass	Získá nebo nastaví css (CSS) třídy vykreslované webový server ovládací prvek v klientovi. (Zděděno od WebControl)
DataItemContainer	Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataItemContainer. (Zděděno od Control)
DataKeysContainer	Získá odkaz na názvový kontejner, pokud názvový kontejner implementuje IDataKeysControl. (Zděděno od Control)
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.
EmptyZoneTextStyle	Získá atributy stylu zástupného textu 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 určující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, pro žádajícího klienta. (Zděděno od Control)
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í 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.
HeaderVerbStyle	Získá atributy stylu pro všechny hlavičkové příkazy 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.
InstructionTextStyle	Získá atributy stylu pro instrukční text, 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 ovládací prvek povolen. (Zděděno od WebControl)
IsTrackingViewState	Získá hodnotu, která označuje, zda serverový ovládací prvek ukládá změny do stavu zobrazení. (Zděděno od Control)
IsViewStateEnabled	Získá hodnotu označující, zda je pro tento ovládací prvek povolen stav zobrazení. (Zděděno od Control)
LabelStyle	Získá atributy stylu pro obsah popisků, které se zobrazují 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 ID zobrazení místo indexu. (Zděděno od Control)
NamingContainer	Získá odkaz na názvový kontejner ovládacího prvku serveru, který vytvoří jedinečný obor názvů pro rozdíl mezi serverovými ovládacími prvky se stejnou ID hodnotou vlastnosti. (Zděděno od Control)
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 serverový ovládací prvek nadřazený ovládací prvek 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é se vztahují na ohraničení ovládacích prvků webových částí 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ě.
PartStyle	Získá vlastnosti stylu, které se vztahují na ohraničení a obsah každé webové části ovládací prvek obsažené v zóně. (Zděděno od WebZone)
PartTitleStyle	Získá atributy stylu obsahu záhlaví pro každý ovládací prvek webových částí obsažených 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á vykreslí 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ě.
SelectedPartLinkStyle	Získá objekt, který obsahuje atributy stylu pro CatalogPart ovládací prvek, který je aktuálně vybrán v zóně.
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, kterou zónu přidat jejich vybrané ovládací prvky do.
ShowCatalogIcons	Získá nebo nastaví hodnotu, která označuje, zda serverové ovládací prvky v katalogu zobrazují jejich přidružené ikony v katalogu.
Site	Získá informace o kontejneru, který hostuje aktuální ovládací prvek při vykreslení na návrhové ploše. (Zděděno od Control)
SkinID	Získá nebo nastaví kůži na ovládací prvek. (Zděděno od WebControl)
Style	Získá kolekci text atributů, které budou vykresleny jako atribut stylu na vnější značku webového serveru ovládacího prvku. (Zděděno od WebControl)
SupportsDisabledAttribute	Získá hodnotu, která označuje, zda má ovládací prvek nastavit disabled atribut vykresleného html elementu na "zakázáno", pokud je falsevlastnost ovládacího prvku IsEnabled je . (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í primárně 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í především vývojáři ovládacích prvků. (Zděděno od WebControl)
TemplateControl	Získá nebo nastaví odkaz na šablonu, která obsahuje tento ovládací prvek. (Zděděno od Control)
TemplateSourceDirectory	Získá virtuální adresář Page nebo UserControl , který obsahuje aktuální server ovládací prvek. (Zděděno od Control)
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ý druh 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) příkazy přidružené 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říč několika požadavky na stejnou stránku. (Zděděno od Control)
ViewStateIgnoresCase	Získá hodnotu, která označuje, zda StateBag objekt nerozlišuje velká a malá písmena. (Zděděno od Control)
ViewStateMode	Získá nebo nastaví režim zobrazení stavu tohoto ovládacího prvku. (Zděděno od Control)
Visible	Získá nebo nastaví hodnotu, která označuje, zda je serverový ovládací prvek vykreslen jako prvek uživatelského rozhraní (UI) na stránce. (Zděděno od ToolZone)
WebPartManager	Získá odkaz na WebPartManager ovládací prvek přidružený WebZone k 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)

Metody

AddAttributesToRender(HtmlTextWriter)	Přidá atributy a styly HTML, které je potřeba vykreslit na zadaný 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 prvek XML nebo HTML, a přidá element do objektu ovládacího prvku ControlCollection serveru. (Zděděno od Control)
ApplyStyle(Style)	Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku a přepíše všechny existující prvky stylu ovládacího prvku. Tuto metodu primárně používají vývojáři ovládacích prvků. (Zděděno od WebControl)
ApplyStyleSheetSkin(Page)	Použije vlastnosti stylu definované v šabloně stylů stránky na ovládací prvek. (Zděděno od Control)
BeginRenderTracing(TextWriter, Object)	Zahájí trasování vykreslování dat v době návrhu. (Zděděno od Control)
BuildProfileTree(String, Boolean)	Shromáždí informace o ovládacím prvku serveru a doručí je do Trace vlastnosti, která se má zobrazit, když je pro stránku povolené trasování. (Zděděno od Control)
ClearCachedClientID()	Nastaví hodnotu v ClientID mezipaměti na null. (Zděděno od Control)
ClearChildControlState()	Odstraní informace o stavu řízení pro podřízené ovládací prvky serveru. (Zděděno od Control)
ClearChildState()	Odstraní informace o stavu zobrazení a stavu řízení pro všechny podřízené ovládací prvky serveru. (Zděděno od Control)
ClearChildViewState()	Odstraní informace o stavu zobrazení všech podřízených ovládacích prvků serveru. (Zděděno od Control)
ClearEffectiveClientIDMode()	ClientIDMode Nastaví vlastnost aktuální instance ovládacího prvku a všech podřízených ovládacích prvků na Inherit. (Zděděno od Control)
Close()	Přepne webovou stránku z režimu zobrazení katalogu do normálního režimu procházení.
CopyBaseAttributes(WebControl)	Zkopíruje vlastnosti, které nejsou zapouzdřeny objektem Style ze zadaného ovládacího prvku webového serveru do ovládacího prvku webového serveru, ze kterého je volána tato metoda. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl)
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ě.
CreateCatalogParts()	Poskytuje deklaraci základní metody, kterou odvozené zóny mohou přepsat pro zpracování podrobností o vytváření CatalogPart ovládacích prvků obsažených v zóně.
CreateChildControls()	Vytvoří sadu podřízených ovládacích prvků přidružených k CatalogZoneBase zóně.
CreateControlCollection()	Vytvoří nový ControlCollection objekt, který bude obsahovat podřízené ovládací prvky (literál i server) serverového ovládacího prvku. (Zděděno od Control)
CreateControlStyle()	Vytvoří objekt stylu, který se interně používá třídy 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()	Sváže zdroj dat se CompositeControl všemi jeho podřízenými ovládacími prvky. (Zděděno od CompositeControl)
DataBind(Boolean)	Vytvoří vazbu zdroje dat na vyvoláný serverový ovládací prvek a všechny jeho podřízené ovládací prvky s možností vyvolat DataBinding událost. (Zděděno od Control)
DataBindChildren()	Sváže zdroj dat s podřízenými ovládacími prvky serverového ovládacího prvku. (Zděděno od Control)
Dispose()	Umožňuje ovládacímu prvku serveru provést konečné vyčištění před uvolněním z paměti. (Zděděno od Control)
EndRenderTracing(TextWriter, Object)	Ukončí trasování vykreslovaných dat v době návrhu. (Zděděno od Control)
EnsureChildControls()	Určuje, zda serverový ovládací prvek obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky. (Zděděno od Control)
EnsureID()	Vytvoří identifikátor ovládacích prvků, které nemají přiřazený identifikátor. (Zděděno od Control)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
FindControl(String)	Vyhledá v aktuálním kontejneru pojmenování serverový ovládací prvek pomocí zadaného id parametru. (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 , který 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 efektivní aktuální PartChromeType hodnotu WebPart 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()	Získá aktuální Type instanci. (Zděděno od Object)
GetUniqueIDRelativeTo(Control)	Vrátí předponu vlastnosti UniqueID zadaného ovládacího prvku. (Zděděno od Control)
HasControls()	Určuje, jestli serverový ovládací prvek obsahuje nějaké podřízené ovládací prvky. (Zděděno od Control)
HasEvents()	Vrátí hodnotu označující, zda jsou události registrovány pro ovládací prvek nebo jakékoli podřízené ovládací prvky. (Zděděno od Control)
InvalidateCatalogParts()	Zničí kolekci ovládacích prvků přidružených CatalogPart k CatalogZoneBase zóně.
IsLiteralContent()	Určuje, jestli serverový ovládací prvek obsahuje pouze obsah literálu. (Zděděno od Control)
LoadControlState(Object)	Načte stav z předchozí žádosti o 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ázaný.
LoadPostData(String, NameValueCollection)	Zpracovává 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.
LoadViewState(Object)	Načte dříve uložené informace o stavu pro zónu.
MapPathSecure(String)	Načte fyzickou cestu, na kterou se mapuje virtuální cesta, absolutní nebo relativní. (Zděděno od Control)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MergeStyle(Style)	Zkopíruje všechny neprázdné prvky zadaného stylu do webového ovládacího prvku, ale nepřepíše žádné existující prvky stylu ovládacího prvku. Tuto metodu používají především vývojáři ovládacích prvků. (Zděděno od WebControl)
OnBubbleEvent(Object, EventArgs)	Určuje, zda je událost serverového ovládacího prvku předána hierarchii ovládacích prvků serveru uživatelského rozhraní stránky. (Zděděno od Control)
OnDataBinding(EventArgs)	DataBinding Vyvolá událost. (Zděděno od Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)	Poskytuje deklaraci základní metody, kterou lze přepsat odvozené ToolZone ovládací prvky zpracovat podrobnosti o změně režimů zobrazení stránky pro specializované zóny. (Zděděno od ToolZone)
OnInit(EventArgs)	Zaregistruje objekt stránky tak, aby stránka vyžadovala stav ovládacího prvku.
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í.
OnSelectedWebPartChanged(Object, WebPartEventArgs)	Poskytuje deklaraci základní metody, kterou lze přepsat odvozené ToolZone ovládací prvky zpracovat 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á zvyk ke čtení souboru. (Zděděno od Control)
RaiseBubbleEvent(Object, EventArgs)	Přiřadí všechny zdroje události a její informace nadřazené ovládacímu prvku. (Zděděno od Control)
RaisePostBackEvent(String)	Provede akce přidružené k jednomu ze zónových sloves nebo vyvolá událost, která odešle příspěvek zpět na server.
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 na zadaný HtmlTextWriter objekt.
RenderBeginTag(HtmlTextWriter)	Vykreslí levou značku HTML ovládacího prvku zóny určenému HtmlTextWriter objektu. (Zděděno od WebZone)
RenderBody(HtmlTextWriter)	Přepíše základní metodu vykreslovat oblast těla zóny odvozené z CatalogZoneBase třídy.
RenderCatalogPartLinks(HtmlTextWriter)	Vykreslí odkazy na jednotlivé CatalogPart ovládací prvky v CatalogZoneBase zóně.
RenderChildren(HtmlTextWriter)	Vypíše obsah podřízených položek serverového ovládacího prvku do zadaného HtmlTextWriter objektu, který zapíše obsah, který se má vykreslit v klientovi. (Zděděno od Control)
RenderContents(HtmlTextWriter)	Vykreslí celý obsah ovládacího prvku zóny mezi počátečními a koncovými značkami určenému objektu HtmlTextWriter . (Zděděno od WebZone)
RenderControl(HtmlTextWriter)	Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu a uloží informace o trasování ovládacího prvku, pokud je trasování povolené. (Zděděno od Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Vypíše obsah ovládacích prvků serveru do zadaného HtmlTextWriter objektu pomocí zadaného ControlAdapter objektu. (Zděděno od Control)
RenderEndTag(HtmlTextWriter)	Vykreslí koncovou značku 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 .
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.
ResolveAdapter()	Získá řídicí adaptér zodpovědný za vykreslení zadaného ovládacího prvku. (Zděděno od Control)
ResolveClientUrl(String)	Získá adresu URL, kterou lze použít v prohlížeči. (Zděděno od Control)
ResolveUrl(String)	Převede adresu URL na adresu URL, která je použitelná v žádajícím klientovi. (Zděděno od Control)
SaveControlState()	Uloží všechny změny ve CatalogZoneBase stavu ovládacího prvku, ke kterým dojde po odeslání webové stránky zpět na server.
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 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, který vykresluje serverový ovládací prvek a jeho obsah do nadřazeného ovládacího prvku. (Zděděno od Control)
SetTraceData(Object, Object)	Nastaví trasovací data pro trasování vykreslovaných dat v době návrhu pomocí klíče dat trasování a hodnoty dat trasování. (Zděděno od Control)
SetTraceData(Object, Object, Object)	Nastaví trasovací data pro trasování vykreslování dat v době návrhu pomocí trasovaného objektu, klíče dat trasování a hodnoty dat trasování. (Zděděno od Control)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TrackViewState()	Sleduje změny stavu zobrazení ovládacího prvku zóny.

Událost

DataBinding	Nastane, když ovládací prvek serveru vytvoří vazbu na zdroj dat. (Zděděno od Control)
Disposed	Nastane při uvolnění serverového ovládacího prvku z paměti, což je poslední fáze životního cyklu řízení serveru, když je požadována stránka ASP.NET. (Zděděno od Control)
Init	Nastane při inicializaci ovládacího prvku serveru, což je první krok v jeho životním cyklu. (Zděděno od Control)
Load	Nastane při načtení serverového ovládacího prvku do objektu Page . (Zděděno od Control)
PreRender	Nastane po načtení objektu Control , ale před vykreslením. (Zděděno od Control)
Unload	Nastane při uvolnění serverového ovládacího prvku z paměti. (Zděděno od Control)

Explicitní implementace rozhraní

IAttributeAccessor.GetAttribute(String)	Získá atribut webového ovládacího prvku se zadaným názvem. (Zděděno od WebControl)
IAttributeAccessor.SetAttribute(String, String)	Nastaví atribut webového ovládacího prvku na zadaný název a hodnotu. (Zděděno od WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Umožňuje 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 .
IPostBackDataHandler.RaisePostDataChangedEvent()	Popis tohoto člena najdete v tématu RaisePostDataChangedEvent().
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ý datový ovládací prvek.
GetMetaTable(INamingContainer)	Získá metadata tabulky pro zadaný datový ovládací prvek.
SetMetaTable(INamingContainer, MetaTable)	Nastaví metadata tabulky pro zadaný ovládací prvek dat.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Nastaví metadata tabulky a mapování výchozích hodnot pro zadaný ovládací prvek dat.
SetMetaTable(INamingContainer, MetaTable, Object)	Nastaví metadata tabulky a mapování výchozích hodnot pro zadaný ovládací prvek dat.
TryGetMetaTable(INamingContainer, MetaTable)	Určuje, jestli jsou k dispozici metadata tabulky.
EnableDynamicData(INamingContainer, Type)	Povolí chování dynamických dat pro zadaný datový ovládací prvek.
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Povolí chování dynamických dat pro zadaný datový ovládací prvek.
EnableDynamicData(INamingContainer, Type, Object)	Povolí chování dynamických dat pro zadaný datový ovládací prvek.

Viz také

• CatalogPart
• ASP.NET ovládací prvky webových částí