CatalogZone Classe

Definição

Serve como o controle principal no conjunto de controles de Web Parts para hospedar controles CatalogPart em uma página da Web.

public ref class CatalogZone : System::Web::UI::WebControls::WebParts::CatalogZoneBase
public class CatalogZone : System.Web.UI.WebControls.WebParts.CatalogZoneBase
type CatalogZone = class
    inherit CatalogZoneBase
Public Class CatalogZone
Inherits CatalogZoneBase
Herança

Exemplos

O exemplo de código a seguir demonstra o uso declarativo e programático do CatalogZone controle . 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.

  • Um arquivo com o código-fonte para um controle personalizado CatalogZone e um controle personalizado WebPart que é importado pelo catálogo e adicionado à página da Web.

  • Uma página da Web que declara o controle de usuário e o controle personalizado CatalogZone .

  • Uma explicação de como executar o exemplo.

A primeira parte desse exemplo de código é o controle de usuário que permite que os usuários alterem os modos de exibição em uma página da Web. Para obter detalhes sobre modos de exibição e uma descrição do código-fonte nesse controle, consulte Passo a passo: alterando 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=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>
<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
  ' Use a field to reference the current WebPartManager.
  Dim _manager As WebPartManager

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

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

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

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

  End Sub

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

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

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

  End Sub

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

A segunda parte do exemplo de código contém o código para os controles e WebPart personalizadosCatalogZone. O código para o CatalogZone controle demonstra como herdar da CatalogZone classe e personalizar suas propriedades definindo alguns valores de propriedade padrão no construtor. O código-fonte também demonstra como criar uma classe personalizada WebPart chamada TextDisplayWebPart. Esse é o controle associado ao . Arquivo de descrição de WebPart que você importará como parte deste exemplo de código. Depois de importar o arquivo de descrição usando o ImportCatalogPart controle na página da Web, você poderá adicionar o TextDisplayWebPart controle à página, totalmente pré-configurado conforme especificado no arquivo de descrição.

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. Este exemplo de código usa compilação dinâmica, portanto, se você quiser executar o exemplo dessa forma, nomeie o arquivo de código-fonte e adicione-o a uma subpasta App_Code do diretório raiz do aplicativo Web. Para obter um passo a passo que demonstra os dois 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
{
  // Create a customized CatalogZone control by setting 
  // some properties in the constructor.
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class MyCatalogZone : CatalogZone
  {
    public MyCatalogZone()
    {
      this.HeaderText = "My Company Catalog";
      this.HeaderCloseVerb.Text = "Close Catalog";
      this.CloseVerb.Text = "Close Catalog";
    }
  }

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

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

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

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

      input = new TextBox();
      this.Controls.Add(input);
      Button update = new Button();
      update.Text = "Set Label Content";
      update.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(update);
    }

    private void submit_Click(object sender, EventArgs e)
    {
      // Update the label string.
      if (!string.IsNullOrEmpty(input.Text))
      {
        _contentText = input.Text + @"<br />";
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }
  }
}
Imports System.Collections
Imports System.ComponentModel
Imports System.Drawing
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

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

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

  End Class


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

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

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

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

      input = New TextBox()
      Me.Controls.Add(input)
      Dim update As New Button()
      update.Text = "Set Label Content"
      AddHandler update.Click, AddressOf Me.submit_Click
      Me.Controls.Add(update)

    End Sub

    Private Sub submit_Click(ByVal sender As Object, _
                             ByVal e As EventArgs)
      ' Update the label string.
      If input.Text <> String.Empty Then
        _contentText = input.Text + "<br />"
        input.Text = String.Empty
        DisplayContent.Text = Me.ContentText
      End If

    End Sub

  End Class

End Namespace

A terceira parte do exemplo de código é a página da Web que contém os controles. Ele contém uma Register diretiva para o controle de usuário e outra para o arquivo de origem com os controles personalizados. Observe que, na segunda diretiva, ele não nomeia o assembly, pois o exemplo não usa um assembly, ele usa a compilação dinâmica com o código-fonte colocado na subpasta App_Code. A página da Web declara um WebPartZone controle e, dentro de seu elemento filho <zonetemplate> , declara um BulletedList controle . Embora esse seja um controle de ASP.NET padrão, ele terá funcionalidade completa de Web Parts em tempo de execução, pois o WebPartManager controle encapsula qualquer controle de servidor colocado em um WebPartZone com um GenericWebPart objeto , para que outros controles de servidor possam participar de aplicativos de Web Parts. Também é declarado nessa zona o controle personalizado WebPart chamado TextDisplayWebPart. Observe que esse controle tem um atributo de ExportMode="All" declarado nele. Isso permite exportar um . Arquivo de descrição de WebPart que contém os valores de propriedade do controle , que podem ser importados por outros usuários para adicionar o controle pré-configurado a outras páginas da Web.

Observação

Para permitir que os usuários de um aplicativo de Web Parts exportem um arquivo de descrição para WebPart controles, você também deve habilitar o recurso de exportação no aplicativo Web adicionando um enableExport="true" atributo ao <webParts> elemento (que é filho do <system.web> elemento) no arquivo Web.config. A exportação está desabilitada por padrão, portanto, se você ainda não tiver habilitado a exportação para seu aplicativo, edite o arquivo Web.config e faça-o agora.

A página da Web também declara o controle personalizado CatalogZone e, dentro dele, um <zonetemplate> elemento que contém um ImportCatalogPart controle . O usuário usará esse controle em tempo de execução para importar o . Arquivo de descrição de WebPart para o controle personalizado WebPart .

<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ Register TagPrefix="aspSample"
  Namespace="Samples.AspNet.CS.Controls" %> 
  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
    <asp:WebPartZone ID="WebPartZone1" runat="server">
      <ZoneTemplate>
        <asp:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <asp:ListItem Value="http://msdn.microsoft.com">
            MSDN
          </asp:ListItem>
          <asp:ListItem Value="http://www.asp.net">
            ASP.NET
          </asp:ListItem>
          <asp:ListItem Value="http://www.msn.com">
            MSN
          </asp:ListItem>
        </asp:BulletedList>
        <aspsample:textdisplaywebpart id="wp1" runat="server" 
           Title="My Text Display WebPart" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <aspSample:MyCatalogZone ID="CatalogZone1" runat="server">
      <ZoneTemplate>
        <asp:ImportCatalogPart id="ImportCatalogPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyCatalogZone>
  </form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ Register TagPrefix="aspSample"
  Namespace="Samples.AspNet.VB.Controls"  %> 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
    <asp:WebPartZone ID="WebPartZone1" runat="server">
      <ZoneTemplate>
        <asp:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <asp:ListItem Value="http://msdn.microsoft.com">
            MSDN
          </asp:ListItem>
          <asp:ListItem Value="http://www.asp.net">
            ASP.NET
          </asp:ListItem>
          <asp:ListItem Value="http://www.msn.com">
            MSN
          </asp:ListItem>
        </asp:BulletedList>
        <aspsample:textdisplaywebpart id="wp1" runat="server" 
           Title="My Text Display WebPart" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <aspSample:MyCatalogZone ID="CatalogZone1" runat="server">
      <ZoneTemplate>
        <asp:ImportCatalogPart id="ImportCatalogPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyCatalogZone>
  </form>
</body>
</html>

Agora, execute o exemplo de código. Carregue a página da Web em um navegador. A primeira etapa é exportar um . Arquivo de descrição da WebPart para o TextDisplayWebPart controle. Clique no menu de verbos no controle personalizado (representado pela seta para baixo na barra de título) e clique em Exportar. Siga as instruções para salvar um arquivo de descrição para o controle. Abra o . Arquivo de descrição de WebPart em um editor e edite o valor do texto da propriedade de título. Localize o <property> elemento que tem o atributo e edite name="Title"o texto do título contido entre as marcas de abertura e fechamento <property> . Agora feche a página da Web e edite a origem da página em um editor. Exclua o <aspSample:TextDisplayWebPart> elemento de declaração de controle e salve e feche o arquivo.

Carregue a página da Web novamente em um navegador. O TextDisplayWebPart controle não deve aparecer porque você o removeu. Use o controle de lista suspensa Modo de Exibição e selecione Catálogo para alternar a página para o modo de catálogo. Observe que o controle personalizado CatalogZone é exibido, juntamente com o ImportCatalogPart controle . Clique no botão Procurar para localizar o . Arquivo de descrição da WebPart que você exportou para o TextDisplayWebPart controle. Você pode clicar em Carregar, marcar a caixa de seleção ao lado do controle importado e clicar em Adicionar para adicioná-lo à página. Clique em Fechar Catálogo para retornar a página ao modo de navegação normal. O controle importado agora deve aparecer na página e o título que aparece na barra de título do controle deve ser o texto do título que você adicionou ao . Arquivo de descrição da WebPart.

Comentários

Dentro do conjunto de controle de Web Parts, uma zona é uma região em uma página da Web que contém controles de Web Parts. Uma zona de Web Parts é criada por um controle de zona, que é um tipo de CompositeControl projetado para conter outros controles. As principais funções de uma zona são definir os controles que ela contém e fornecer uma interface do usuário comum para esses controles. Para obter informações gerais sobre zonas e como elas são usadas em aplicativos de Web Parts, consulte a classe base WebZone e Visão geral do conjunto de controle de Web Parts.

Um recurso importante dos controles de Web Parts é que eles permitem que os usuários finais modifiquem (ou personalizem) páginas da Web de acordo com suas preferências e salvem suas configurações personalizadas para sessões futuras do navegador. Um aspecto da modificação de páginas de Web Parts inclui a capacidade de adicionar WebPart controles ou outros controles de servidor a uma página de Web Parts. O CatalogZone controle fornece uma lista ou catálogo de controles que os usuários podem adicionar a uma página.

O CatalogZone controle é um dos controles fundamentais no conjunto de controle de Web Parts. Ele deriva da classe e a CatalogZoneBase maior parte de seu comportamento é herdada dessa classe. A CatalogZone classe essencialmente adiciona à classe base um modelo de zona, que é uma implementação da ITemplate interface. O modelo de zona permite que os desenvolvedores adicionem CatalogPart controles declarativamente a uma zona no formato de persistência de página.

Importante

Uma CatalogZone zona pode conter apenas CatalogPart controles e, por outro lado, CatalogPart os controles só podem residir em zonas derivadas da CatalogZoneBase classe , como CatalogZone.

Um CatalogZone controle fica visível somente quando um usuário alterna uma página da Web para o modo de exibição de catálogo (CatalogDisplayMode). Um catálogo pode conter vários tipos de CatalogPart controles. Cada CatalogPart controle é um tipo de contêiner que contém os controles de servidor que os usuários podem adicionar à página. Os CatalogPart controles diferem de acordo com a origem dos controles de servidor que eles contêm. A tabela a seguir resume os CatalogPart controles fornecidos com o conjunto de controle de Web Parts e, para cada controle, que tipo de servidor ele contém.

Control 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 (um arquivo XML com um . Extensão WebPart e um formato especificado que contém informações de estado) para um controle a um catálogo, para que o controle possa ser adicionado a uma página da Web.

Como a CatalogZone classe adiciona apenas um modelo de zona ao comportamento de sua classe base, ela tem poucos membros. O CatalogZone construtor é um construtor sem parâmetros; com ele, você pode inicializar uma nova instância da CatalogZone classe . A ZoneTemplate propriedade obtém ou define uma referência ao ITemplate objeto que contém os controles da zona. O CreateCatalogParts método é crítico. Ele substitui o método base para criar a coleção de todos os CatalogPart controles contidos no modelo de zona.

Observação

Os botões na interface do CatalogZone usuário exigem scripts do lado do cliente para funcionar corretamente. Se o script estiver desabilitado no navegador, o usuário não poderá executar ações por meio da interface do CatalogZone usuário.

Acessibilidade

A marcação renderizada por padrão para esse controle pode não estar em conformidade com os padrões de acessibilidade, como as diretrizes de prioridade 1.0 (Diretrizes de Acessibilidade de Conteúdo da Web 1.0). Para obter detalhes sobre o suporte de acessibilidade para esse controle, consulte Controles de ASP.NET e Acessibilidade.

Notas aos Herdeiros

Você pode criar classes personalizadas CatalogZone se quiser mais controle sobre a renderização e o comportamento da interface do usuário do catálogo. Se você não precisar fornecer aos usuários de seu controle a capacidade de adicionar CatalogPart controles declarativamente, poderá herdar diretamente da CatalogZoneBase classe . Se você quiser permitir que os controles sejam adicionados declarativamente, a abordagem mais simples é herdar da CatalogZone classe , pois ela fornece o modelo de zona essencial.

Se você herdar da CatalogZone classe , poderá substituir o CreateCatalogParts() método e usar o método para adicionar controles personalizados CatalogPart a um , se quiser um CatalogPartCollectionmaior controle programático sobre a adição de controles personalizados CatalogPart à zona.

Construtores

CatalogZone()

Inicializa uma nova instância da classe CatalogZone.

Propriedades

AccessKey

Obtém ou define a tecla de acesso que permite navegar rapidamente para o controle do servidor Web.

(Herdado de WebControl)
Adapter

Obtém o adaptador específico de navegador para o controle.

(Herdado de Control)
AddVerb

Obtém uma referência a um objeto de WebPartVerb que permite que os usuários finais adicionem controles de um catálogo a uma página de Web Parts.

(Herdado de CatalogZoneBase)
AppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle.

(Herdado de Control)
AssociatedDisplayModes

Obtém a coleção de objetos WebPartDisplayMode associados a uma zona ToolZone específica.

(Herdado de ToolZone)
Attributes

Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades do 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 de uma imagem da tela de fundo para uma zona.

(Herdado de WebZone)
BindingContainer

Obtém o controle que contém a vinculaçã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 de servidor Web.

(Herdado de WebControl)
BorderWidth

Obtém ou define a largura da borda do controle de servidor Web.

(Herdado de WebControl)
CatalogPartChrome

Obtém uma referência à instância da classe CatalogPartChrome associada à zona de CatalogZoneBase.

(Herdado de CatalogZoneBase)
CatalogParts

Obtém uma coleção de todos os controles de CatalogPart contidos em uma zona de CatalogZoneBase.

(Herdado de CatalogZoneBase)
ChildControlsCreated

Obtém um valor que indica se os controles filho do controle de servidor foram criados.

(Herdado de Control)
ClientID

Obtém a ID de controle de marcação HTML gerada pelo ASP.NET.

(Herdado de Control)
ClientIDMode

Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID.

(Herdado de Control)
ClientIDSeparator

Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID.

(Herdado de Control)
CloseVerb

Obtém uma referência a um objeto de WebPartVerb que permite aos usuários finais fecharem a interface do usuário (IU) do catálogo e retornarem a página para o modo de navegação normal.

(Herdado de CatalogZoneBase)
Context

Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual.

(Herdado de Control)
Controls

Obtém um objeto ControlCollection que representa os controles filho em um CompositeControl.

(Herdado de CompositeControl)
ControlStyle

Obtém o estilo de um controle de servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebControl)
ControlStyleCreated

Obtém um valor que indica se um objeto Style foi criado para a propriedade ControlStyle. 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 implementa o IDataItemContainer.

(Herdado de Control)
DataKeysContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o 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 controle ToolZone é exibido no momento.

(Herdado de ToolZone)
EditUIStyle

Obtém os atributos de estilo para os controles editáveis contidos em um controle ToolZone.

(Herdado de ToolZone)
EmptyZoneText

Obtém ou define uma mensagem que aparece quando uma zona não contém nenhum controle.

(Herdado de CatalogZoneBase)
EmptyZoneTextStyle

Obtém os atributos de estilo para o texto de 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 de servidor persiste seu estado de exibição e o estado de exibição de quaisquer 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 que será exibida se um controle WebPart não puder ser carregado ou criado.

(Herdado de WebZone)
Events

Obtém uma lista de delegados de 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 de rodapé da zona.

(Herdado de WebZone)
ForeColor

Obtém ou define a cor de primeiro plano (normalmente a cor do texto) do controle de 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 de servidor atual têm alguma configuração de estado de exibição salva.

(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 objeto WebPartVerb no cabeçalho de um controle ToolZone que é usado para fechar o controle.

(Herdado de ToolZone)
HeaderStyle

Obtém os atributos de estilo para o conteúdo da área do cabeçalho da zona.

(Herdado de WebZone)
HeaderText

Obtém ou define o texto para a área do cabeçalho de uma zona.

(Herdado de CatalogZoneBase)
HeaderVerbStyle

Obtém os atributos de estilo para todos os verbos de cabeçalho exibidos em um controle ToolZone.

(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 de 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.

(Herdado de CatalogZoneBase)
InstructionTextStyle

Obtém os atributos de estilo para o texto de instrução exibido na parte superior de um controle ToolZone.

(Herdado de ToolZone)
IsChildControlStateCleared

Obtém um valor que indica se os controles contidos dentro deste 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 de servidor está salvando alterações no 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 exibidos junto com os controles de edição dentro de um controle ToolZone. Os controles ToolZone derivados, como CatalogZone e EditorZone, aplicam os estilos aos rótulos.

(Herdado de ToolZone)
LoadViewStateByID

Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice.

(Herdado de Control)
NamingContainer

Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID.

(Herdado de Control)
Padding

Obtém ou define os atributos de preenchimento de célula em uma tabela que contém o controles WebPart em uma zona.

(Herdado de WebZone)
Page

Obtém uma referência para a instância Page que contém o controle de servidor.

(Herdado de Control)
Parent

Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página.

(Herdado de Control)
PartChromePadding

Obtém ou define a distância entre o conteúdo de um controle WebPart e a borda do controle.

(Herdado de WebZone)
PartChromeStyle

Obtém as 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 emoldura 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 controles de CatalogPart que não estão selecionados atualmente na zona.

(Herdado de CatalogZoneBase)
PartStyle

Obtém as características de estilo que se aplicam às bordas e ao conteúdo de cada controle de Web Parts contido por uma zona.

(Herdado de WebZone)
PartTitleStyle

Obtém os atributos de estilo do conteúdo da barra de título de cada controle de Web Parts contido por uma zona.

(Herdado de WebZone)
RenderClientScript

Obtém um valor que indica se o script de cliente em uma página de Web Parts deve ser renderizado.

(Herdado de WebZone)
RenderingCompatibility

Obtém um valor que especifica a versão do 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 de CatalogPart selecionado no momento em uma zona.

(Herdado de CatalogZoneBase)
SelectedPartLinkStyle

Obtém um objeto que contém atributos de estilo para o controle de CatalogPart que está selecionado atualmente na zona.

(Herdado de CatalogZoneBase)
SelectTargetZoneText

Obtém ou define o texto junto com o controle na interface do usuário (UI) de catálogo que permite aos usuários escolher para qual zona adicionar seus controles selecionados.

(Herdado de CatalogZoneBase)
ShowCatalogIcons

Obtém ou define um valor que indica se os controles de servidor no catálogo exibem seus ícones associados no catálogo.

(Herdado de CatalogZoneBase)
Site

Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design.

(Herdado de Control)
SkinID

Obtém ou define a capa 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 de servidor Web.

(Herdado de WebControl)
SupportsDisabledAttribute

Obtém um valor que indica se o controle deve definir o atributo disabled do elemento HTML renderizado para "desabilitado" quando a propriedade do controle IsEnabled é 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 valor HtmlTextWriterTag que corresponde ao controle do 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 este controle.

(Herdado de Control)
TemplateSourceDirectory

Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual.

(Herdado de Control)
ToolTip

Obtém ou define o texto exibido quando o ponteiro do mouse passa sobre o controle de servidor Web.

(Herdado de WebControl)
UniqueID

Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor.

(Herdado de Control)
ValidateRequestMode

Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos.

(Herdado de Control)
VerbButtonType

Obtém ou define o tipo de botão usado para representar verbos em uma zona.

(Herdado de WebZone)
VerbStyle

Obtém os atributos de estilo para os verbos da UI (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 objeto StateBag não diferencia maiúsculas de minúsculas.

(Herdado de Control)
ViewStateMode

Obtém ou define o modo de estado de exibição deste controle.

(Herdado de Control)
Visible

Obtém ou define um valor que indica se um controle de servidor é renderizado como um elemento da interface do usuário na página.

(Herdado de ToolZone)
WebPartManager

Obtém uma referência para o controle WebPartManager associado a uma instância do controle WebZone em uma página de Web Parts.

(Herdado de WebZone)
Width

Obtém ou define a largura do controle de servidor Web.

(Herdado de WebControl)
ZoneTemplate

Obtém ou define um modelo para conter controles filho dentro de um controles de CatalogZone no formato de persistência de página.

Métodos

AddAttributesToRender(HtmlTextWriter)

Adiciona atributos HTML e estilos que precisam ser renderizadas ao HtmlTextWriterTag especificado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
AddedControl(Control, Int32)

Chamado após um controle filho ser adicionado à coleção Controls do objeto Control.

(Herdado de Control)
AddParsedSubObject(Object)

Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor.

(Herdado de Control)
ApplyStyle(Style)

Copia os elementos não vazios do estilo especificado para o controle da Web, substituindo os elementos de estilo existentes no controle. Esse método é usado principalmente por desenvolvedores de controles.

(Herdado de WebControl)
ApplyStyleSheetSkin(Page)

Aplica as propriedades de estilo definidas na folha de estilos da página ao controle.

(Herdado de Control)
BeginRenderTracing(TextWriter, Object)

Inicia o rastreamento de tempo de design de dados de renderização.

(Herdado de Control)
BuildProfileTree(String, Boolean)

Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página.

(Herdado de Control)
ClearCachedClientID()

Define o valor ClientID armazenado em cache como null.

(Herdado de Control)
ClearChildControlState()

Exclui as informações de estado de controle para os controles filho do controle de 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 de servidor.

(Herdado de Control)
ClearChildViewState()

Exclui as informações de estado de exibição para todos os controles filho do controle de servidor.

(Herdado de Control)
ClearEffectiveClientIDMode()

Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit.

(Herdado de Control)
Close()

Alterna a página da Web do modo de exibição de catálogo para o modo de navegação normal.

(Herdado de CatalogZoneBase)
CopyBaseAttributes(WebControl)

Copia as propriedades que não são encapsuladas pelo objeto Style de controle do servidor Web especificado ao controle de servidor Web do qual este método é chamado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
CreateCatalogPartChrome()

Cria uma instância de um objeto de CatalogPartChrome usado para renderizar os elementos periféricos da interface do usuário (IU) para controles de CatalogPart em uma zona.

(Herdado de CatalogZoneBase)
CreateCatalogParts()

Cria uma instância de cada tipo de CatalogPart que é declarado na zona.

CreateChildControls()

Cria o conjunto de controles filhos associados a uma zona de CatalogZoneBase.

(Herdado de CatalogZoneBase)
CreateControlCollection()

Cria um novo objeto ControlCollection 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 classe WebControl para implementar todas as propriedades relacionadas a estilo. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
DataBind()

Associa uma fonte de dados ao CompositeControl e a todos os seus controles filho.

(Herdado de CompositeControl)
DataBind(Boolean)

Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding.

(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 do lançamento da memória.

(Herdado de Control)
EndRenderTracing(TextWriter, Object)

Encerra o rastreamento de tempo de design de dados de renderização.

(Herdado de Control)
EnsureChildControls()

Determinará se o controle de servidor contiver controles filho. Se ele não contiver, 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)

Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro id especificado.

(Herdado de Control)
FindControl(String, Int32)

Procura o contêiner de nomenclatura atual para um controle de servidor com o id especificado e um inteiro especificado no parâmetro pathOffset, que auxilia na pesquisa. Você não deve substituir esta versão do método FindControl.

(Herdado de Control)
Focus()

Define o foco de entrada para um controle.

(Herdado de Control)
GetDesignModeState()

Obtém os dados de tempo de design para um controle.

(Herdado de Control)
GetEffectiveChromeType(Part)

Retorna o valor PartChromeType atual real ou efetivo de um controle WebPart, considerando a propriedade PartChromeType da zona e o modo de exibição atual da página de 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 propriedade UniqueID do controle especificado.

(Herdado de Control)
HasControls()

Determina se o controle de servidor contém algum controle filho.

(Herdado de Control)
HasEvents()

Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho.

(Herdado de Control)
InvalidateCatalogParts()

Destrói a coleção de controles de CatalogPart associados a uma zona de CatalogZoneBase.

(Herdado de CatalogZoneBase)
IsLiteralContent()

Determina se o controle de servidor contém apenas o conteúdo literal.

(Herdado de Control)
LoadControlState(Object)

Carrega o estado de uma solicitação de página anterior para as propriedades de controle que devem persistir em postbacks, mesmo quando o estado de exibição estiver desabilitado no controle.

(Herdado de CatalogZoneBase)
LoadPostData(String, NameValueCollection)

Processa o estado das caixas de seleção que correspondem aos controles de WebPart no catálogo, quando a página é postada de volta no servidor.

(Herdado de CatalogZoneBase)
LoadViewState(Object)

Carrega informações de estado salvas anteriormente para uma zona.

(Herdado de CatalogZoneBase)
MapPathSecure(String)

Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual.

(Herdado de Control)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
MergeStyle(Style)

Copia os elementos não vazios do estilo especificado para o controle da Web, mas não substituirá os elementos de estilo existentes do controle. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
OnBubbleEvent(Object, EventArgs)

Determina se o evento do controle de servidor é passado um nível acima da hierarquia de controle de servidor da 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 ToolZone derivados podem substituir para manipular os detalhes de alteração os modos de exibição da página para uma zona especializada.

(Herdado de ToolZone)
OnInit(EventArgs)

Registra o objeto de página para o qual a página exige o estado do controle.

(Herdado de CatalogZoneBase)
OnLoad(EventArgs)

Aciona o evento Load.

(Herdado de Control)
OnPreRender(EventArgs)

Gera o evento de PreRender e registra o objeto da página para que ele exija postbacks.

(Herdado de CatalogZoneBase)
OnSelectedWebPartChanged(Object, WebPartEventArgs)

Fornece uma declaração de método base que os controles ToolZone derivados podem substituir para manipular o evento de alteração de qual controle de Web Parts está 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 quaisquer fontes de evento e suas informações para o pai do controle.

(Herdado de Control)
RaisePostBackEvent(String)

Executa as ações associadas a um dos verbos de zona ou aciona um evento que é enviado de volta para o servidor.

(Herdado de CatalogZoneBase)
RecreateChildControls()

Recria os controles filho em um controle derivado de CompositeControl.

(Herdado de CompositeControl)
RemovedControl(Control)

Chamado após um controle filho ser removido da coleção Controls do objeto Control.

(Herdado de Control)
Render(HtmlTextWriter)

Renderiza a zona para o objeto de HtmlTextWriter especificado.

(Herdado de CatalogZoneBase)
RenderBeginTag(HtmlTextWriter)

Renderiza a marca HTML de abertura do controle de zona para o objeto HtmlTextWriter especificado.

(Herdado de WebZone)
RenderBody(HtmlTextWriter)

Substitui o método base para renderizar a área do corpo de uma zona derivada da classe CatalogZoneBase.

(Herdado de CatalogZoneBase)
RenderCatalogPartLinks(HtmlTextWriter)

Renderiza os links para os controles de CatalogPart individuais em uma zona de CatalogZoneBase.

(Herdado de CatalogZoneBase)
RenderChildren(HtmlTextWriter)

Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, 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 no objeto HtmlTextWriter especificado.

(Herdado de WebZone)
RenderControl(HtmlTextWriter)

Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado.

(Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.

(Herdado de Control)
RenderEndTag(HtmlTextWriter)

Renderiza a marca de fechamento HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
RenderFooter(HtmlTextWriter)

Renderiza a área do rodapé para uma zona de CatalogZoneBase.

(Herdado de CatalogZoneBase)
RenderHeader(HtmlTextWriter)

Substitui o método base para fornecer renderização especializada para a área de cabeçalho necessária para os controles ToolZone.

(Herdado de ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)

Renderiza um verbo individual com um controle ToolZone.

(Herdado de ToolZone)
RenderVerbs(HtmlTextWriter)

Renderiza os verbos na área de rodapé de uma zona de CatalogZoneBase.

(Herdado de CatalogZoneBase)
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 possa ser usada no cliente solicitante.

(Herdado de Control)
SaveControlState()

Salva as alterações no estado de um controle de CatalogZoneBase que ocorre após o postback da página da Web no servidor.

(Herdado de CatalogZoneBase)
SaveViewState()

Salva as alterações de estado de exibição que ocorreram após o postback da página no servidor.

(Herdado de CatalogZoneBase)
SetDesignModeState(IDictionary)

Define os dados de tempo de design para um controle.

(Herdado de Control)
SetRenderMethodDelegate(RenderMethod)

Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai.

(Herdado de Control)
SetTraceData(Object, Object)

Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento.

(Herdado de Control)
SetTraceData(Object, Object, Object)

Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de 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 do controle de uma zona.

(Herdado de CatalogZoneBase)

Eventos

DataBinding

Ocorre quando o controle de 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 de controle de servidor quando uma página ASP.NET é solicitada.

(Herdado de Control)
Init

Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida.

(Herdado de Control)
Load

Ocorre quando o controle de servidor é carregado no objeto Page.

(Herdado de Control)
PreRender

Ocorre depois que o objeto Control é carregado, mas antes da renderização.

(Herdado de Control)
Unload

Ocorre quando o controle de servidor é descarregado da memória.

(Herdado de Control)

Implantações explícitas de interface

IAttributeAccessor.GetAttribute(String)

Obtém um atributo do controle da Web com o nome especificado.

(Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)

Define um atributo do controle da Web para o nome e o valor especificados.

(Herdado de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Permite que um designer recrie a coleção de controles filho do controle de composição no ambiente de tempo de design.

(Herdado de CompositeControl)
IControlBuilderAccessor.ControlBuilder

Para obter uma descrição desse membro, confira ControlBuilder.

(Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição desse membro, confira GetDesignModeState().

(Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary).

(Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obter uma descrição desse membro, confira SetOwnerControl(Control).

(Herdado de Control)
IControlDesignerAccessor.UserData

Para obter uma descrição desse membro, confira UserData.

(Herdado de Control)
IDataBindingsAccessor.DataBindings

Para obter uma descrição desse membro, confira DataBindings.

(Herdado de Control)
IDataBindingsAccessor.HasDataBindings

Para obter uma descrição desse membro, confira HasDataBindings.

(Herdado de Control)
IExpressionsAccessor.Expressions

Para obter uma descrição desse membro, confira Expressions.

(Herdado de Control)
IExpressionsAccessor.HasExpressions

Para obter uma descrição desse membro, confira HasExpressions.

(Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)

Para obter uma descrição desse membro, confira AddParsedSubObject(Object).

(Herdado de Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Implementa o método LoadPostData(String, NameValueCollection) chamando o método LoadPostData(String, NameValueCollection) da classe CatalogZoneBase.

(Herdado de CatalogZoneBase)
IPostBackDataHandler.RaisePostDataChangedEvent()

Para obter uma descrição desse membro, confira RaisePostDataChangedEvent().

(Herdado de CatalogZoneBase)
IPostBackEventHandler.RaisePostBackEvent(String)

Implementa o método RaisePostBackEvent(String).

(Herdado de ToolZone)

Métodos de Extensão

FindDataSourceControl(Control)

Retorna a fonte de dados associada ao controle de dados do controle especificado.

FindFieldTemplate(Control, String)

Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.

FindMetaTable(Control)

Retorna o objeto metatable para o controle que contém dados.

GetDefaultValues(INamingContainer)

Obtém a coleção de valores padrão para o controle de dados especificado.

GetMetaTable(INamingContainer)

Obtém os metadados de tabela para o controle de dados especificado.

SetMetaTable(INamingContainer, MetaTable)

Define os metadados de tabela para o controle de dados especificado.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado.

SetMetaTable(INamingContainer, MetaTable, Object)

Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado.

TryGetMetaTable(INamingContainer, MetaTable)

Determina se os metadados da tabela estão disponíveis.

EnableDynamicData(INamingContainer, Type)

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.

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.

Aplica-se a

Confira também