CatalogZoneBase Classe

Definição

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Serve como a classe base para todos os controles de zona que atuam como catálogos. Os catálogos contêm listas de WebPart controles que os usuários podem adicionar a uma página da Web.

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

Herança: Object

Control

WebControl

CompositeControl

WebZone

ToolZone
CatalogZoneBase

Derivado: System.Web.UI.WebControls.WebParts.CatalogZone

Implementações: IPostBackDataHandler

Exemplos

O exemplo de código a seguir demonstra vários usos declarativos e programáticos da CatalogZoneBase classe. Como a classe é abstrata, os exemplos de código usam a classe derivada CatalogZone que é fornecida com o conjunto de controle de Web Parts, demonstrando as propriedades e os métodos herdados da CatalogZoneBase classe.

O exemplo de código tem quatro partes:

Um controle de usuário que permite alterar os modos de exibição na página da Web.
Uma página da Web que contém uma referência a um CatalogZone controle e algum código que demonstra o uso de alguns membros de classe chave CatalogZoneBase .
Um controle personalizado WebPart que é adicionado ao controle personalizado CatalogZone .
Uma descrição de como o exemplo funciona em um navegador.

A primeira parte deste exemplo de código é o controle de usuário que permite alterar os modos de exibição na página. Para obter detalhes sobre os modos de exibição e uma descrição do código-fonte nesse controle, consulte Passo a passo: alterando os modos de exibição em uma página de Web Parts.

<%@ 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>

A segunda parte do exemplo de código é uma página da Web que contém uma referência declarativa a um CatalogZone controle. Perto da parte superior da página estão duas Register diretivas: uma para o controle de usuário e outra para o controle personalizado WebPart . Observe que, abaixo do <asp:WebPartZone> elemento, há um <asp: CatalogZone> elemento que contém referências declarativas ao controle personalizado WebPart e a um controle ASP.NET Calendar . A zona também tem uma variedade de marcas e propriedades definidas para determinar sua aparência e comportamento. Entre as <script> marcas na página há uma variedade de códigos de manipulação de eventos, a maioria dos quais demonstra os vários usos programáticos dos CatalogZoneBase membros.

<%@ 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>

A terceira parte do exemplo de código é o controle personalizado WebPart chamado TextDisplayWebPart. Ele é declarado dentro da zona e um usuário final pode adicioná-lo do catálogo à página. Para que o exemplo de código seja executado, você deve compilar esse código-fonte. Você pode compilá-lo explicitamente e colocar o assembly resultante na pasta Bin do site ou no cache de assembly global. Como alternativa, você pode colocar o código-fonte na pasta App_Code do site, na qual ele será compilado dinamicamente em tempo de execução. Para obter uma demonstração de ambos os métodos de compilação, consulte Passo a passo: Desenvolvendo e usando um controle de servidor Web personalizado.

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

Observe que, para que o exemplo de código funcione, há uma configuração que você deve adicionar no arquivo Web.config para habilitar a exportação de arquivos de descrição de Web Parts. Verifique se você tem um arquivo Web.config no mesmo diretório que a página da Web para este exemplo de código. <system.web> Na seção, verifique se há um <webParts> elemento com um enableExport atributo definido como true, como na marcação a seguir.

<webParts enableExport="true">

...

</webParts>

Ao carregar a página em um navegador, você pode selecionar Catálogo na caixa de listagem suspensa para alternar para o modo de exibição do catálogo. Quando o catálogo estiver visível, você poderá ver os dois controles de servidor que podem ser adicionados do catálogo à página e também poderá observar na interface do usuário os efeitos dos usos declarativos e programáticos dos membros da CatalogZoneBase classe.

Comentários

A CatalogZoneBase classe é uma classe base que herda da ToolZone classe. Ele fornece um conjunto base de comportamentos para zonas derivadas.

A CatalogZoneBase classe fornece uma interface do usuário exclusiva que permite aos usuários adicionar WebPart controles e outros controles de servidor a páginas da Web. Controles que derivam da CatalogZoneBase classe, como CatalogZone, são os controles realmente colocados em páginas da Web. Eles atuam como contêineres para outros controles, conhecidos como CatalogPart controles, que criam listas de controles de servidor para os usuários adicionarem a uma página. As zonas derivadas da CatalogZoneBase classe só podem aparecer quando a página estiver no modo de exibição do catálogo.

Observação

Uma CatalogZoneBase zona pode conter apenas CatalogPart controles e, por outro lado, CatalogPart os controles podem residir apenas em CatalogZoneBase zonas.

O mecanismo para adicionar controles de servidor a um catálogo é o seguinte conjunto de três controles que derivam da classe base CatalogPart .

Controle	Descrição
PageCatalogPart	Mantém referências a controles que foram fechados em uma página. Esses controles podem ser reabertos (adicionados novamente à página) pelos usuários.
DeclarativeCatalogPart	Contém referências a controles declarados em um catálogo de Web Parts na marcação de uma página da Web. Esses controles podem ser adicionados a uma página da Web pelos usuários.
ImportCatalogPart	Fornece a interface do usuário para um usuário carregar um arquivo de definição em um catálogo para que o controle possa ser adicionado a uma página da Web. Arquivos de definição são arquivos XML com um . Extensão de nome de arquivo WebPart que importa configurações para um controle. O controle deve estar presente no servidor antes que o arquivo de definição possa ser importado.

A CatalogZoneBase classe tem várias propriedades que são úteis para exibir catálogos de WebPart controles. A AddVerb propriedade faz referência ao verbo que adiciona um controle selecionado do catálogo à página, enquanto a CloseVerb propriedade faz referência a um verbo que fecha o catálogo e retorna o modo de exibição da página para navegar no modo. A CatalogParts propriedade faz referência à coleção de todos os CatalogPart controles na zona. Várias propriedades orientadas a texto, como EmptyZoneText, HeaderTexte InstructionText, substituem propriedades base para fornecer texto padrão apropriado para catálogos. A SelectTargetZoneText propriedade contém o texto junto com o controle de lista suspensa que permite que os usuários escolham a qual zona um controle será adicionado.

Várias outras propriedades são incluídas na CatalogZoneBase classe. A SelectedCatalogPartID propriedade é um identificador de cadeia de caracteres exclusivo para o controle selecionado CatalogPart no momento. A ShowCatalogIcons propriedade indica se os ícones que podem ser associados a controles devem ser mostrados definindo a CatalogIconImageUrl propriedade em um WebPart controle.

A PartLinkStyle propriedade contém atributos de estilo para os links para os CatalogPart controles que não estão selecionados atualmente na zona. Por outro lado, a SelectedPartLinkStyle propriedade contém atributos de estilo para um link para o CatalogPart controle que o usuário selecionou atualmente na zona.

Além das propriedades, também há alguns métodos na CatalogZoneBase classe, além dos métodos padrão de manipulação e renderização de eventos herdados de outros controles base, que são projetados exclusivamente para tratar catálogos de controles. O CreateCatalogPartChrome método cria o cromado (elementos de interface do usuário periféricos, como uma borda, verbos, ícones e um título) que envolve cada CatalogPart controle na zona e também manipula a renderização dos controles. O CreateCatalogParts método é um método abstrato; classes derivadas o substituem para criar instâncias de todos os CatalogPart controles contidos na zona. O InvalidateCatalogParts método pode ser chamado por uma classe derivada se a coleção de CatalogPart controles na zona for alterada por algum motivo programático e a classe derivada precisar recriar a coleção. O LoadPostData método carrega o estado anteriormente existente para as caixas de seleção ao lado dos WebPart controles no catálogo, sempre que a página é postada novamente no servidor; por outro lado, o SaveControlState método salva o estado das caixas de seleção. Por fim, o RenderCatalogPartLinks método fornece toda a renderização dos links para cada CatalogPart controle contido na zona.

Notas aos Implementadores

Se você quiser desenvolver uma zona personalizada para hospedar CatalogPart controles, determine se deseja fornecer suporte ao modelo de zona. Um modelo de zona é criado por tipos que implementam a ITemplate interface e é necessário se você quiser habilitar desenvolvedores de página usando sua zona personalizada para fazer referência CatalogPart a controles dentro de sua zona na marcação declarativa de uma página da Web. Se precisar de suporte ao modelo de zona, você deverá herdar da CatalogZone classe. Por outro lado, se sua zona personalizada e seus CatalogPart controles forem autocontidos e eles forem criados programaticamente sem nenhuma opção para os desenvolvedores de página especificarem controles declarativamente em um modelo de zona, você poderá herdar diretamente da CatalogZoneBase classe. Se você herdar da CatalogZoneBase classe, deverá substituir o CreateCatalogParts() método e adicionar os controles de WebPart servidor desejados em seu catálogo a um CatalogPartCollection objeto.

Construtores

Nome	Description
CatalogZoneBase()	Inicializa a classe para uso por uma instância de classe herdada. Esse construtor só pode ser chamado por uma classe herdada.

Propriedades

Nome	Description
AccessKey	Obtém ou define a chave de acesso que permite navegar rapidamente até o controle do servidor Web. (Herdado de WebControl)
Adapter	Obtém o adaptador específico do navegador para o controle. (Herdado de Control)
AddVerb	Obtém uma referência a um WebPartVerb objeto que permite que os usuários finais adicionem controles de um catálogo a uma página de Web Parts.
AppRelativeTemplateSourceDirectory	Obtém ou define o diretório virtual relativo ao aplicativo do Page objeto ou UserControl que contém esse controle. (Herdado de Control)
AssociatedDisplayModes	Obtém a coleção de WebPartDisplayMode objetos associados a uma zona específica ToolZone . (Herdado de ToolZone)
Attributes	Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades no controle. (Herdado de WebControl)
BackColor	Obtém ou define a cor da tela de fundo do controle do servidor Web. (Herdado de WebControl)
BackImageUrl	Obtém ou define a URL como uma imagem de plano de fundo para uma zona. (Herdado de WebZone)
BindingContainer	Obtém o controle que contém a associação de dados desse controle. (Herdado de Control)
BorderColor	Obtém ou define a cor da borda do controle Web. (Herdado de WebControl)
BorderStyle	Obtém ou define o estilo de borda do controle do servidor Web. (Herdado de WebControl)
BorderWidth	Obtém ou define a largura da borda do controle do servidor Web. (Herdado de WebControl)
CatalogPartChrome	Obtém uma referência à instância da CatalogPartChrome classe associada à CatalogZoneBase zona.
CatalogParts	Obtém uma coleção de todos os CatalogPart controles contidos em uma CatalogZoneBase zona.
ChildControlsCreated	Obtém um valor que indica se os controles filho do controle do servidor foram criados. (Herdado de Control)
ClientID	Obtém a ID de controle para marcação HTML gerada por ASP.NET. (Herdado de Control)
ClientIDMode	Obtém ou define o algoritmo usado para gerar o valor da ClientID propriedade. (Herdado de Control)
ClientIDSeparator	Obtém um valor de caractere que representa o caractere separador usado na ClientID propriedade. (Herdado de Control)
CloseVerb	Obtém uma referência a um WebPartVerb objeto que permite que os usuários finais fechem a interface do usuário do catálogo e retornem a página ao modo de navegação normal.
Context	Obtém o HttpContext objeto associado ao controle do servidor para a solicitação da Web atual. (Herdado de Control)
Controls	Obtém um ControlCollection objeto que representa os controles filho em um CompositeControl. (Herdado de CompositeControl)
ControlStyle	Obtém o estilo do controle do servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
ControlStyleCreated	Obtém um valor que indica se um Style objeto foi criado para a ControlStyle propriedade. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
CssClass	Obtém ou define a classe CSS (Folha de Estilos em Cascata) renderizada pelo controle do servidor Web no cliente. (Herdado de WebControl)
DataItemContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataItemContainer. (Herdado de Control)
DataKeysContainer	Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementar IDataKeysControl. (Herdado de Control)
DesignMode	Obtém um valor que indica se um controle está sendo usado em uma superfície de design. (Herdado de Control)
Display	Obtém um valor que indica se um ToolZone controle é exibido no momento. (Herdado de ToolZone)
EditUIStyle	Obtém os atributos de estilo para os controles editáveis contidos em um ToolZone controle. (Herdado de ToolZone)
EmptyZoneText	Obtém ou define uma mensagem que aparece quando uma zona não contém controles.
EmptyZoneTextStyle	Obtém os atributos de estilo para o texto do espaço reservado em uma zona vazia. (Herdado de WebZone)
Enabled	Obtém ou define um valor que indica se o controle do servidor Web está habilitado. (Herdado de WebControl)
EnableTheming	Obtém ou define um valor que indica se os temas se aplicam a esse controle. (Herdado de WebControl)
EnableViewState	Obtém ou define um valor que indica se o controle do servidor persiste seu estado de exibição e o estado de exibição de todos os controles filho que ele contém, para o cliente solicitante. (Herdado de Control)
ErrorStyle	Obtém os atributos de estilo para renderizar a mensagem de erro exibida se um WebPart controle não puder ser carregado ou criado. (Herdado de WebZone)
Events	Obtém uma lista de representantes do manipulador de eventos para o controle. Esta propriedade é somente para leitura. (Herdado de Control)
Font	Obtém as propriedades de fonte associadas ao controle do servidor Web. (Herdado de WebControl)
FooterStyle	Obtém os atributos de estilo para o conteúdo da área do rodapé de uma zona. (Herdado de WebZone)
ForeColor	Obtém ou define a cor do primeiro plano (normalmente a cor do texto) do controle do servidor Web. (Herdado de WebControl)
HasAttributes	Obtém um valor que indica se o controle tem atributos definidos. (Herdado de WebControl)
HasChildViewState	Obtém um valor que indica se os controles filho do controle do servidor atual têm configurações de estado de exibição salvas. (Herdado de Control)
HasFooter	Obtém um valor que indica se uma zona tem uma área de rodapé. (Herdado de WebZone)
HasHeader	Obtém um valor que indica se uma zona tem uma área de cabeçalho. (Herdado de WebZone)
HeaderCloseVerb	Obtém uma referência ao WebPartVerb objeto no cabeçalho de um ToolZone controle que é usado para fechar o controle. (Herdado de ToolZone)
HeaderStyle	Obtém os atributos de estilo para o conteúdo da área de cabeçalho de uma zona. (Herdado de WebZone)
HeaderText	Obtém ou define o texto para a área de cabeçalho de uma zona.
HeaderVerbStyle	Obtém os atributos de estilo para todos os verbos de cabeçalho exibidos em um ToolZone controle. (Herdado de ToolZone)
Height	Obtém ou define a altura do controle do servidor Web. (Herdado de WebControl)
ID	Obtém ou define o identificador programático atribuído ao controle do servidor. (Herdado de Control)
IdSeparator	Obtém o caractere usado para separar identificadores de controle. (Herdado de Control)
InstructionText	Obtém ou define o texto em uma zona que fornece instruções para os usuários finais.
InstructionTextStyle	Obtém os atributos de estilo do texto de instrução que aparece na parte superior de um ToolZone controle. (Herdado de ToolZone)
IsChildControlStateCleared	Obtém um valor que indica se os controles contidos nesse controle têm estado de controle. (Herdado de Control)
IsEnabled	Obtém um valor que indica se o controle está habilitado. (Herdado de WebControl)
IsTrackingViewState	Obtém um valor que indica se o controle do servidor está salvando alterações em seu estado de exibição. (Herdado de Control)
IsViewStateEnabled	Obtém um valor que indica se o estado de exibição está habilitado para esse controle. (Herdado de Control)
LabelStyle	Obtém os atributos de estilo para o conteúdo dos rótulos que aparecem junto com os controles de edição dentro de um ToolZone controle. Os controles derivados ToolZone , como CatalogZone e EditorZone, aplicam os estilos aos rótulos. (Herdado de ToolZone)
LoadViewStateByID	Obtém um valor que indica se o controle participa no carregamento de seu estado de exibição ID em vez de índice. (Herdado de Control)
NamingContainer	Obtém uma referência ao contêiner de nomenclatura do controle de servidor, que cria um namespace exclusivo para diferenciar entre controles de servidor com o mesmo ID valor de propriedade. (Herdado de Control)
Padding	Obtém ou define os atributos de preenchimento de célula na tabela que contém os WebPart controles em uma zona. (Herdado de WebZone)
Page	Obtém uma referência à Page instância que contém o controle do servidor. (Herdado de Control)
Parent	Obtém uma referência ao controle pai do controle do servidor na hierarquia de controle de página. (Herdado de Control)
PartChromePadding	Obtém ou define a distância entre o conteúdo de um WebPart controle e a borda do controle. (Herdado de WebZone)
PartChromeStyle	Obtém características de estilo que se aplicam às bordas dos controles de Web Parts contidos por uma zona. (Herdado de WebZone)
PartChromeType	Obtém ou define o tipo de borda que enquadra os controles de Web Parts contidos por uma zona. (Herdado de WebZone)
PartLinkStyle	Obtém um objeto que contém atributos de estilo para os CatalogPart controles que não estão selecionados atualmente na zona.
PartStyle	Obtém características de estilo que se aplicam à borda e ao conteúdo de cada controle de Web Parts contido por uma zona. (Herdado de WebZone)
PartTitleStyle	Obtém atributos de estilo para o conteúdo da barra de título para cada controle de Web Parts contido por uma zona. (Herdado de WebZone)
RenderClientScript	Obtém um valor que indica se o script do cliente deve ser renderizado em uma página de Web Parts. (Herdado de WebZone)
RenderingCompatibility	Obtém um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control)
SelectedCatalogPartID	Obtém ou define uma cadeia de caracteres como um identificador para o controle atualmente selecionado CatalogPart em uma zona.
SelectedPartLinkStyle	Obtém um objeto que contém atributos de estilo para o CatalogPart controle que está selecionado atualmente na zona.
SelectTargetZoneText	Obtém ou define o texto junto com o controle na interface do usuário do catálogo que permite que os usuários escolham em qual zona adicionar seus controles selecionados.
ShowCatalogIcons	Obtém ou define um valor que indica se os controles de servidor no catálogo exibem seus ícones associados no catálogo.
Site	Obtém informações sobre o contêiner que hospeda o controle atual quando renderizado em uma superfície de design. (Herdado de Control)
SkinID	Obtém ou define a pele a ser aplicada ao controle. (Herdado de WebControl)
Style	Obtém uma coleção de atributos de texto que serão renderizados como um atributo de estilo na marca externa do controle do servidor Web. (Herdado de WebControl)
SupportsDisabledAttribute	Obtém um valor que indica se o controle deve definir o `disabled` atributo do elemento HTML renderizado como "desabilitado" quando a propriedade do IsEnabled controle é `false`. (Herdado de CompositeControl)
TabIndex	Obtém ou define o índice de tabulação do controle do servidor Web. (Herdado de WebControl)
TagKey	Obtém o HtmlTextWriterTag valor que corresponde a esse controle de servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebZone)
TagName	Obtém o nome da marca de controle. Essa propriedade é usada principalmente por desenvolvedores de controle. (Herdado de WebControl)
TemplateControl	Obtém ou define uma referência ao modelo que contém esse controle. (Herdado de Control)
TemplateSourceDirectory	Obtém o diretório virtual do Page ou UserControl que contém o controle de servidor atual. (Herdado de Control)
ToolTip	Obtém ou define o texto exibido quando o ponteiro do mouse passa o mouse sobre o controle do servidor Web. (Herdado de WebControl)
UniqueID	Obtém o identificador exclusivo e hierarquicamente qualificado para o controle do servidor. (Herdado de Control)
ValidateRequestMode	Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador em busca de valores potencialmente perigosos. (Herdado de Control)
VerbButtonType	Obtém ou define que tipo de botão é usado para representar verbos em uma zona. (Herdado de WebZone)
VerbStyle	Obtém os atributos de estilo para os verbos de interface do usuário associados aos controles de Web Parts em uma zona. (Herdado de WebZone)
ViewState	Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página. (Herdado de Control)
ViewStateIgnoresCase	Obtém um valor que indica se o StateBag objeto não diferencia maiúsculas de minúsculas. (Herdado de Control)
ViewStateMode	Obtém ou define o modo de estado de exibição desse controle. (Herdado de Control)
Visible	Obtém ou define um valor que indica se um controle de servidor é renderizado como um elemento de interface do usuário na página. (Herdado de ToolZone)
WebPartManager	Obtém uma referência ao WebPartManager controle associado a uma WebZone instância de controle em uma página de Web Parts. (Herdado de WebZone)
Width	Obtém ou define a largura do controle do servidor Web. (Herdado de WebControl)

Métodos

Nome	Description
AddAttributesToRender(HtmlTextWriter)	Adiciona atributos HTML e estilos que precisam ser renderizados ao especificado HtmlTextWriterTag. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
AddedControl(Control, Int32)	Chamado depois que um controle filho é adicionado à Controls coleção do Control objeto. (Herdado de Control)
AddParsedSubObject(Object)	Notifica o controle do servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto do controle do ControlCollection servidor. (Herdado de Control)
ApplyStyle(Style)	Copia todos os elementos nãoblank do estilo especificado para o controle da Web, substituindo quaisquer elementos de estilo existentes do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
ApplyStyleSheetSkin(Page)	Aplica as propriedades de estilo definidas na folha de estilos de página ao controle. (Herdado de Control)
BeginRenderTracing(TextWriter, Object)	Inicia o rastreamento em tempo de design dos dados de renderização. (Herdado de Control)
BuildProfileTree(String, Boolean)	Coleta informações sobre o controle do servidor e o Trace entrega na propriedade a ser exibida quando o rastreamento está habilitado para a página. (Herdado de Control)
ClearCachedClientID()	Define o valor armazenado em ClientID cache como `null`. (Herdado de Control)
ClearChildControlState()	Exclui as informações de estado de controle para os controles filho do controle do servidor. (Herdado de Control)
ClearChildState()	Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle do servidor. (Herdado de Control)
ClearChildViewState()	Exclui as informações de estado de exibição para todos os controles filho do controle do servidor. (Herdado de Control)
ClearEffectiveClientIDMode()	Define a ClientIDMode propriedade da instância de controle atual e de qualquer controle filho como Inherit. (Herdado de Control)
Close()	Alterna a página da Web do modo de exibição do catálogo para o modo de navegação normal.
CopyBaseAttributes(WebControl)	Copia as propriedades não encapsuladas pelo Style objeto do controle de servidor Web especificado para o controle do servidor Web do qual esse método é chamado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
CreateCatalogPartChrome()	Cria uma instância de um CatalogPartChrome objeto usado para renderizar os elementos da interface do usuário periférica para CatalogPart controles em uma zona.
CreateCatalogParts()	Fornece uma declaração de método base que as zonas derivadas podem substituir para lidar com os detalhes da criação dos CatalogPart controles contidos em uma zona.
CreateChildControls()	Cria o conjunto de controles filho associados a uma CatalogZoneBase zona.
CreateControlCollection()	Cria um novo ControlCollection objeto para manter os controles filho (literal e servidor) do controle do servidor. (Herdado de Control)
CreateControlStyle()	Cria o objeto de estilo que é usado internamente pela WebControl classe para implementar todas as propriedades relacionadas ao estilo. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
DataBind()	Associa uma fonte de dados a CompositeControl todos os seus controles filho. (Herdado de CompositeControl)
DataBind(Boolean)	Associa uma fonte de dados ao controle de servidor invocado e a todos os seus controles filho com uma opção para gerar o DataBinding evento. (Herdado de Control)
DataBindChildren()	Associa uma fonte de dados aos controles filho do controle do servidor. (Herdado de Control)
Dispose()	Permite que um controle de servidor execute a limpeza final antes de ser liberado da memória. (Herdado de Control)
EndRenderTracing(TextWriter, Object)	Encerra o rastreamento em tempo de design dos dados de renderização. (Herdado de Control)
EnsureChildControls()	Determina se o controle do servidor contém controles filho. Se isso não acontecer, ele criará controles filho. (Herdado de Control)
EnsureID()	Cria um identificador para controles que não têm um identificador atribuído. (Herdado de Control)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindControl(String, Int32)	Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o especificado `id` e um inteiro, especificado no parâmetro, que `pathOffset` ajuda na pesquisa. Você não deve substituir essa versão do FindControl método. (Herdado de Control)
FindControl(String)	Pesquisa o contêiner de nomenclatura atual para um controle de servidor com o parâmetro especificado `id` . (Herdado de Control)
Focus()	Define o foco de entrada como um controle. (Herdado de Control)
GetDesignModeState()	Obtém dados de tempo de design para um controle. (Herdado de Control)
GetEffectiveChromeType(Part)	Retorna o valor atual PartChromeType real ou efetivo de um WebPart controle, considerando a PartChromeType propriedade da zona e o modo de exibição atual da página Web Parts. (Herdado de WebZone)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetRouteUrl(Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control)
GetRouteUrl(String, Object)	Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetUniqueIDRelativeTo(Control)	Retorna a parte prefixada da UniqueID propriedade do controle especificado. (Herdado de Control)
HasControls()	Determina se o controle do servidor contém controles filho. (Herdado de Control)
HasEvents()	Retorna um valor que indica se os eventos são registrados para o controle ou quaisquer controles filho. (Herdado de Control)
InvalidateCatalogParts()	Destrói a coleção de CatalogPart controles associados a uma CatalogZoneBase zona.
IsLiteralContent()	Determina se o controle do servidor contém apenas conteúdo literal. (Herdado de Control)
LoadControlState(Object)	Carrega o estado de uma solicitação de página anterior para propriedades de controle que devem persistir entre postbacks mesmo quando o estado de exibição estiver desabilitado no controle.
LoadPostData(String, NameValueCollection)	Processa o estado das caixas de seleção que correspondem aos WebPart controles no catálogo, quando a página é postada novamente no servidor.
LoadViewState(Object)	Carrega informações de estado salvas anteriormente para uma zona.
MapPathSecure(String)	Recupera o caminho físico para o qual um caminho virtual, absoluto ou relativo, é mapeado. (Herdado de Control)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
MergeStyle(Style)	Copia todos os elementos nãoblank do estilo especificado para o controle da Web, mas não substituirá nenhum elemento de estilo existente do controle. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
OnBubbleEvent(Object, EventArgs)	Determina se o evento para o controle do servidor é passado para a hierarquia de controle do servidor de interface do usuário da página. (Herdado de Control)
OnDataBinding(EventArgs)	Aciona o evento DataBinding. (Herdado de Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)	Fornece uma declaração de método base que os controles derivados ToolZone podem substituir para lidar com os detalhes da alteração dos modos de exibição de página para uma zona especializada. (Herdado de ToolZone)
OnInit(EventArgs)	Registra o objeto de página para que a página exija estado de controle.
OnLoad(EventArgs)	Aciona o evento Load. (Herdado de Control)
OnPreRender(EventArgs)	Aciona o PreRender evento e registra o objeto de página para que ele exija postbacks.
OnSelectedWebPartChanged(Object, WebPartEventArgs)	Fornece uma declaração de método base que os controles derivados ToolZone podem substituir para lidar com o evento de alteração de qual controle de Web Parts é selecionado em uma zona especializada. (Herdado de ToolZone)
OnUnload(EventArgs)	Aciona o evento Unload. (Herdado de Control)
OpenFile(String)	Obtém um Stream usado para ler um arquivo. (Herdado de Control)
RaiseBubbleEvent(Object, EventArgs)	Atribui todas as fontes do evento e suas informações ao pai do controle. (Herdado de Control)
RaisePostBackEvent(String)	Executa as ações associadas a um dos verbos de zona ou gera um evento que retorna para o servidor.
RecreateChildControls()	Recria os controles filho em um controle derivado de CompositeControl. (Herdado de CompositeControl)
RemovedControl(Control)	Chamado depois que um controle filho é removido da Controls coleção do Control objeto. (Herdado de Control)
Render(HtmlTextWriter)	Renderiza a zona para o objeto especificado HtmlTextWriter .
RenderBeginTag(HtmlTextWriter)	Renderiza a marca HTML de abertura do controle de zona para o objeto especificado HtmlTextWriter . (Herdado de WebZone)
RenderBody(HtmlTextWriter)	Substitui o método base para renderizar a área do corpo de uma zona derivada da CatalogZoneBase classe.
RenderCatalogPartLinks(HtmlTextWriter)	Renderiza os links para os controles individuais CatalogPart em uma CatalogZoneBase zona.
RenderChildren(HtmlTextWriter)	Gera o conteúdo dos filhos de um controle de servidor para um objeto fornecido HtmlTextWriter , que grava o conteúdo a ser renderizado no cliente. (Herdado de Control)
RenderContents(HtmlTextWriter)	Renderiza todo o conteúdo de um controle de zona entre as marcas inicial e final para o objeto especificado HtmlTextWriter . (Herdado de WebZone)
RenderControl(HtmlTextWriter, ControlAdapter)	Gera conteúdo de controle de servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control)
RenderControl(HtmlTextWriter)	O servidor de saída controla o conteúdo de um objeto fornecido HtmlTextWriter e armazena informações de rastreamento sobre o controle se o rastreamento estiver habilitado. (Herdado de Control)
RenderEndTag(HtmlTextWriter)	Renderiza a marca de fechamento HTML do controle no gravador especificado. Esse método é usado principalmente por desenvolvedores de controle. (Herdado de WebControl)
RenderFooter(HtmlTextWriter)	Renderiza a área do rodapé para uma CatalogZoneBase zona.
RenderHeader(HtmlTextWriter)	Substitui o método base para fornecer renderização especializada para a área de cabeçalho exigida pelos ToolZone controles. (Herdado de ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)	Renderiza um verbo individual com um ToolZone controle. (Herdado de ToolZone)
RenderVerbs(HtmlTextWriter)	Renderiza os verbos na área do rodapé de uma CatalogZoneBase zona.
ResolveAdapter()	Obtém o adaptador de controle responsável por renderizar o controle especificado. (Herdado de Control)
ResolveClientUrl(String)	Obtém uma URL que pode ser usada pelo navegador. (Herdado de Control)
ResolveUrl(String)	Converte uma URL em uma que é utilizável no cliente solicitante. (Herdado de Control)
SaveControlState()	Salva as alterações no estado de um CatalogZoneBase controle que ocorrem depois que a página da Web é postada novamente no servidor.
SaveViewState()	Salva todas as alterações de estado de exibição que ocorreram depois que uma página foi postada novamente no servidor.
SetDesignModeState(IDictionary)	Define dados de tempo de design para um controle. (Herdado de Control)
SetRenderMethodDelegate(RenderMethod)	Atribui um representante do manipulador de eventos para renderizar o controle do servidor e seu conteúdo em seu controle pai. (Herdado de Control)
SetTraceData(Object, Object, Object)	Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando o objeto rastreado, a chave de dados de rastreamento e o valor dos dados de rastreamento. (Herdado de Control)
SetTraceData(Object, Object)	Define dados de rastreamento para rastreamento em tempo de design de dados de renderização, usando a chave de dados de rastreamento e o valor dos dados de rastreamento. (Herdado de Control)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TrackViewState()	Controla as alterações no estado de exibição de um controle de zona.

Eventos

Nome	Description
DataBinding	Ocorre quando o controle do servidor é associado a uma fonte de dados. (Herdado de Control)
Disposed	Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida do controle do servidor quando uma página ASP.NET é solicitada. (Herdado de Control)
Init	Ocorre quando o controle do servidor é inicializado, que é a primeira etapa em seu ciclo de vida. (Herdado de Control)
Load	Ocorre quando o controle do servidor é carregado no Page objeto. (Herdado de Control)
PreRender	Ocorre depois que o Control objeto é carregado, mas antes da renderização. (Herdado de Control)
Unload	Ocorre quando o controle do servidor é descarregado da memória. (Herdado de Control)

Implantações explícitas de interface

Nome	Description
IAttributeAccessor.GetAttribute(String)	Obtém um atributo do controle Web com o nome especificado. (Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Define um atributo do controle Web como o nome e o valor especificados. (Herdado de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Permite que um designer recrie a coleção de controles filho do controle composto no ambiente de tempo de design. (Herdado de CompositeControl)
IControlBuilderAccessor.ControlBuilder	Para obter uma descrição deste membro, consulte ControlBuilder. (Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para obter uma descrição deste membro, consulte GetDesignModeState(). (Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obter uma descrição deste membro, consulte SetDesignModeState(IDictionary). (Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para obter uma descrição deste membro, consulte SetOwnerControl(Control). (Herdado de Control)
IControlDesignerAccessor.UserData	Para obter uma descrição deste membro, consulte UserData. (Herdado de Control)
IDataBindingsAccessor.DataBindings	Para obter uma descrição deste membro, consulte DataBindings. (Herdado de Control)
IDataBindingsAccessor.HasDataBindings	Para obter uma descrição deste membro, consulte HasDataBindings. (Herdado de Control)
IExpressionsAccessor.Expressions	Para obter uma descrição deste membro, consulte Expressions. (Herdado de Control)
IExpressionsAccessor.HasExpressions	Para obter uma descrição deste membro, consulte HasExpressions. (Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para obter uma descrição deste membro, consulte AddParsedSubObject(Object). (Herdado de Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)	Implementa o LoadPostData(String, NameValueCollection) método chamando o LoadPostData(String, NameValueCollection) método da CatalogZoneBase classe.
IPostBackDataHandler.RaisePostDataChangedEvent()	Para obter uma descrição deste membro, consulte RaisePostDataChangedEvent().
IPostBackEventHandler.RaisePostBackEvent(String)	Implementa o RaisePostBackEvent(String) método. (Herdado de ToolZone)

Métodos de Extensão

Nome	Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.
EnableDynamicData(INamingContainer, Type, Object)	Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.
EnableDynamicData(INamingContainer, Type)	Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.
FindDataSourceControl(Control)	Retorna a fonte de dados associada ao controle de dados para o controle especificado.
FindFieldTemplate(Control, String)	Retorna o modelo de campo para a coluna especificada no contêiner de nomenclatura do controle especificado.
FindMetaTable(Control)	Retorna o objeto metatável para o controle de dados que contém.
GetDefaultValues(INamingContainer)	Obtém a coleção dos valores padrão para o controle de dados especificado.
GetMetaTable(INamingContainer)	Obtém os metadados da tabela para o controle de dados especificado.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Define os metadados da tabela e o mapeamento de valor padrão para o controle de dados especificado.
SetMetaTable(INamingContainer, MetaTable, Object)	Define os metadados da tabela e o mapeamento de valor padrão para o controle de dados especificado.
SetMetaTable(INamingContainer, MetaTable)	Define os metadados da tabela para o controle de dados especificado.
TryGetMetaTable(INamingContainer, MetaTable)	Determina se os metadados da tabela estão disponíveis.

Aplica-se a

Confira também

Comentários

Esta página foi útil?

Compartilhar via

CatalogZoneBase Classe

Definição

Exemplos

Comentários

Notas aos Implementadores

Construtores

Propriedades

Métodos

Eventos

Implantações explícitas de interface

Métodos de Extensão

Aplica-se a

Confira também

Comentários