Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe CatalogZoneBase

 

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

Namespace:   System.Web.UI.WebControls.WebParts
Assembly:  System.Web (em System.Web.dll)

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.CompositeControl
        System.Web.UI.WebControls.WebParts.WebZone
          System.Web.UI.WebControls.WebParts.ToolZone
            System.Web.UI.WebControls.WebParts.CatalogZoneBase
              System.Web.UI.WebControls.WebParts.CatalogZone

public abstract class CatalogZoneBase : ToolZone, IPostBackDataHandler

NomeDescrição
System_CAPS_protmethodCatalogZoneBase()

Inicializa a classe para uso por uma instância de classe herdada. Este construtor só pode ser chamado por uma classe herdada.

NomeDescrição
System_CAPS_pubpropertyAccessKey

Obtém ou define uma tecla de acesso que permite que você navegue rapidamente para um controle. (Herdado de WebControl.)

System_CAPS_protpropertyAdapter

Obtém as especificações do navegador para o controle. (Herdado de Control.)

System_CAPS_pubpropertyAddVerb

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

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo de aplicativo da Page ou UserControl objeto que contém este controle.(Herdado de Control.)

System_CAPS_pubpropertyAssociatedDisplayModes

Obtém a coleção de WebPartDisplayMode objetos associados um determinado ToolZone zona.(Herdado de ToolZone.)

System_CAPS_pubpropertyAttributes

Obtém a coleção de atributos arbitrários (para renderizar apenas) que não correspondem às propriedades do controle.(Herdado de WebControl.)

System_CAPS_pubpropertyBackColor

Obtém ou define a cor do plano de fundo do controle. (Herdado de WebControl.)

System_CAPS_pubpropertyBackImageUrl

Obtém ou define a URL para uma imagem de plano de fundo de uma zona.(Herdado de WebZone.)

System_CAPS_pubpropertyBindingContainer

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém o controle que contém a associação de dados deste controle.(Herdado de Control.)

System_CAPS_pubpropertyBorderColor

Obtém ou define a cor da borda do controle. (Herdado de WebControl.)

System_CAPS_pubpropertyBorderStyle

Obtém ou define o estilo de borda do controle. (Herdado de WebControl.)

System_CAPS_pubpropertyBorderWidth

Obtém ou define a largura da borda do controle. (Herdado de WebControl.)

System_CAPS_pubpropertyCatalogPartChrome

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

System_CAPS_pubpropertyCatalogParts

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

System_CAPS_protpropertyChildControlsCreated

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

System_CAPS_pubpropertyClientID

Obtém o identificador do controle gerado pelo ASP.NET. (Herdado de Control.)

System_CAPS_pubpropertyClientIDMode

Obtém ou define o algoritmo que é usado para gerar o valor de ClientID propriedade.(Herdado de Control.)

System_CAPS_protpropertyClientIDSeparator

Obtém um valor de caractere que representa o caractere separador usado no ClientID propriedade.(Herdado de Control.)

System_CAPS_pubpropertyCloseVerb

Obtém uma referência a um WebPartVerb objeto que permite aos usuários finais feche a interface de usuário (UI) do catálogo e retorna a página para o modo de procura normal.

System_CAPS_protpropertyContext

Obtém o HttpContext objeto associado com o controle de servidor para a solicitação da Web atual.(Herdado de Control.)

System_CAPS_pubpropertyControls

Obtém um ControlCollection controla o objeto que representa o filho em um CompositeControl.(Herdado de CompositeControl.)

System_CAPS_pubpropertyControlStyle

Obtém o estilo do controle do servidor Web. Esta propriedade é usada principalmente por desenvolvedores de controle.(Herdado de WebControl.)

System_CAPS_pubpropertyControlStyleCreated

Obtém um valor que indica se um Style objeto foi criado para o ControlStyle propriedade. Essa propriedade é usada principalmente por desenvolvedores de controle.(Herdado de WebControl.)

System_CAPS_pubpropertyCssClass

Obtém ou define a classe de folha de estilo em cascata (CSS) processada pelo controle de servidor Web no cliente.(Herdado de WebControl.)

System_CAPS_pubpropertyDataItemContainer

Obtém uma referência para o recipiente de nomenclatura se o recipiente de nomenclatura implementa IDataItemContainer.(Herdado de Control.)

System_CAPS_pubpropertyDataKeysContainer

Obtém uma referência para o recipiente de nomenclatura se o recipiente de nomenclatura implementa IDataKeysControl.(Herdado de Control.)

System_CAPS_protpropertyDesignMode

Obtém um valor que indica se um controle está sendo usado em uma superfície de design.(Herdado de Control.)

System_CAPS_protpropertyDisplay

Obtém um valor que indica se um ToolZone controle é exibido no momento.(Herdado de ToolZone.)

System_CAPS_pubpropertyEditUIStyle

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

System_CAPS_pubpropertyEmptyZoneText

Obtém ou define uma mensagem que aparece quando uma zona contém controles não.(Substitui o WebZone.EmptyZoneText.)

System_CAPS_pubpropertyEmptyZoneTextStyle

Obtém os atributos de estilo para o texto de espaço reservado em uma zona vazia.(Herdado de WebZone.)

System_CAPS_pubpropertyEnabled

Obtém ou define um valor que indica se o controle de servidor Web está habilitado.(Herdado de WebControl.)

System_CAPS_pubpropertyEnableTheming

Obtém ou define um valor que indica se os temas se aplicam a esse controle.(Herdado de WebControl.)

System_CAPS_pubpropertyEnableViewState

Obtém ou define um valor que indica se o controle de servidor persiste o estado de exibição e o estado de exibição de todos os controles filho contém, para o cliente solicitante.(Herdado de Control.)

System_CAPS_pubpropertyErrorStyle

Obtém os atributos de estilo para processar a mensagem de erro que será exibido se um WebPart controle não pode ser carregado ou criado.(Herdado de WebZone.)

System_CAPS_protpropertyEvents

Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente leitura.(Herdado de Control.)

System_CAPS_pubpropertyFont

Obtém as propriedades de fonte associadas com o controle de servidor Web.(Herdado de WebControl.)

System_CAPS_pubpropertyFooterStyle

Obtém os atributos de estilo para o conteúdo da área de rodapé da zona.(Herdado de WebZone.)

System_CAPS_pubpropertyForeColor

Obtém ou define a cor de primeiro plano (normalmente a cor do texto) do controle do servidor Web.(Herdado de WebControl.)

System_CAPS_pubpropertyHasAttributes

Obtém um valor que indica se o controle tem atributos definido.(Herdado de WebControl.)

System_CAPS_protpropertyHasChildViewState

Obtém um valor indicando se os atuais controles filhos do controle do servidor têm quaisquer configurações do estado de visualização salvas.(Herdado de Control.)

System_CAPS_protpropertyHasFooter

Obtém um valor que indica se uma zona tem uma área de rodapé.(Herdado de WebZone.)

System_CAPS_protpropertyHasHeader

Obtém um valor que indica se uma zona tem uma área de cabeçalho.(Herdado de WebZone.)

System_CAPS_pubpropertyHeaderCloseVerb

Obtém uma referência para o WebPartVerb objeto no cabeçalho de uma ToolZone controle que é usado para fechar o controle.(Herdado de ToolZone.)

System_CAPS_pubpropertyHeaderStyle

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

System_CAPS_pubpropertyHeaderText

Obtém ou define o texto para a área do cabeçalho de uma zona.(Substitui o WebZone.HeaderText.)

System_CAPS_pubpropertyHeaderVerbStyle

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

System_CAPS_pubpropertyHeight

Obtém ou define a altura do controle de servidor Web.(Herdado de WebControl.)

System_CAPS_pubpropertyID

Obtém ou define o identificador programático atribuído ao controle de servidor.(Herdado de Control.)

System_CAPS_protpropertyIdSeparator

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém o caractere usado para separar os identificadores de controle.(Herdado de Control.)

System_CAPS_pubpropertyInstructionText

Obtém ou define o texto em uma zona que fornece instruções para os usuários finais.(Substitui o ToolZone.InstructionText.)

System_CAPS_pubpropertyInstructionTextStyle

Obtém os atributos de estilo para o texto de instrução que aparece na parte superior de um ToolZone controle.(Herdado de ToolZone.)

System_CAPS_protpropertyIsChildControlStateCleared

Obtém um valor que indica se os controles contidos dentro deste controle têm estado do controle.(Herdado de Control.)

System_CAPS_protpropertyIsEnabled

Obtém um valor que indica se o controle está habilitado.(Herdado de WebControl.)

System_CAPS_protpropertyIsTrackingViewState

Obtém um valor que indica se o controle de servidor está salvando as alterações em seu estado de exibição.(Herdado de Control.)

System_CAPS_protpropertyIsViewStateEnabled

Obtém um valor que indica se o estado de exibição está habilitado para este controle.(Herdado de Control.)

System_CAPS_pubpropertyLabelStyle

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. Derivado ToolZone controles, como CatalogZone e EditorZone, aplicar os estilos para os rótulos.(Herdado de ToolZone.)

System_CAPS_protpropertyLoadViewStateByID

Obtém um valor que indica se o controle participa de carregar seu estado de exibição por ID em vez de índice.(Herdado de Control.)

System_CAPS_pubpropertyNamingContainer

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

System_CAPS_pubpropertyPadding

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

System_CAPS_pubpropertyPage

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

System_CAPS_pubpropertyParent

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

System_CAPS_pubpropertyPartChromePadding

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

System_CAPS_pubpropertyPartChromeStyle

Obtém as características de estilo que se aplicam às bordas das Web Parts controles contidos em uma zona.(Herdado de WebZone.)

System_CAPS_pubpropertyPartChromeType

Obtém ou define o tipo de borda que controles de Web Parts de quadros contidos por uma região.(Herdado de WebZone.)

System_CAPS_pubpropertyPartLinkStyle

Obtém um objeto que contém atributos de estilo para o CatalogPart controles que não estão selecionados atualmente na zona.

System_CAPS_pubpropertyPartStyle

Obtém as características de estilo que se aplicam para a borda e o conteúdo de cada controle de Web Parts contidos em uma zona.(Herdado de WebZone.)

System_CAPS_pubpropertyPartTitleStyle

Obtém os atributos de estilo para o conteúdo da barra de título de cada controle de Web Parts contido em uma zona.(Herdado de WebZone.)

System_CAPS_protpropertyRenderClientScript

Obtém um valor que indica se deve processar o script de cliente em uma página de Web Parts.(Herdado de WebZone.)

System_CAPS_pubpropertyRenderingCompatibility

Obtém um valor que especifica a versão do ASP.NET que renderizado HTML será compatível com.(Herdado de Control.)

System_CAPS_pubpropertySelectedCatalogPartID

Obtém ou define uma cadeia de caracteres como um identificador para o elemento selecionado atualmente CatalogPart controle em uma zona.

System_CAPS_pubpropertySelectedPartLinkStyle

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

System_CAPS_pubpropertySelectTargetZoneText

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

System_CAPS_pubpropertyShowCatalogIcons

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

System_CAPS_pubpropertySite

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

System_CAPS_pubpropertySkinID

Obtém ou define a capa para aplicar ao controle.(Herdado de WebControl.)

System_CAPS_pubpropertyStyle

Obtém uma coleção de atributos de texto que será processada como um atributo de estilo da marca externa do controle do servidor Web.(Herdado de WebControl.)

System_CAPS_pubpropertySupportsDisabledAttribute

Obtém um valor que indica se o controle deve definir o disabled atributo do elemento HTML renderizado para "desativado" quando o controle IsEnabled é de propriedade false.(Herdado de CompositeControl.)

System_CAPS_pubpropertyTabIndex

Obtém ou define o índice de tabulação do controle do servidor Web.(Herdado de WebControl.)

System_CAPS_protpropertyTagKey

Obtém o HtmlTextWriterTag valor que corresponde a esse controle de servidor Web. Esta propriedade é usada principalmente por desenvolvedores de controle.(Herdado de WebZone.)

System_CAPS_protpropertyTagName

Obtém o nome da marca do controle. Esta propriedade é usada principalmente por desenvolvedores de controle.(Herdado de WebControl.)

System_CAPS_pubpropertyTemplateControl

Obtém ou define uma referência para o modelo que contém este controle.(Herdado de Control.)

System_CAPS_pubpropertyTemplateSourceDirectory

Obtém o diretório virtual da Page ou UserControl que contém o controle de servidor atual.(Herdado de Control.)

System_CAPS_pubpropertyToolTip

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

System_CAPS_pubpropertyUniqueID

Obtém o identificador exclusivo e hierarquicamente qualificado para o controle de servidor.(Herdado de Control.)

System_CAPS_pubpropertyValidateRequestMode

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

System_CAPS_pubpropertyVerbButtonType

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

System_CAPS_pubpropertyVerbStyle

Obtém os atributos de estilo para os verbos de interface de usuário associados a controles de Web Parts em uma zona.(Herdado de WebZone.)

System_CAPS_protpropertyViewState

Obtém um dicionário de informações de estado que permite você salvar e restaurar o estado de exibição de um controle de servidor nas várias solicitações para a mesma página. (Herdado de Control.)

System_CAPS_protpropertyViewStateIgnoresCase

Obtém um valor que indica se o StateBag objeto diferencia maiusculas de minúsculas.(Herdado de Control.)

System_CAPS_pubpropertyViewStateMode

Obtém ou define o modo de estado de exibição deste controle.(Herdado de Control.)

System_CAPS_pubpropertyVisible

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

System_CAPS_protpropertyWebPartManager

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

System_CAPS_pubpropertyWidth

Obtém ou define a largura do controle de servidor Web.(Herdado de WebControl.)

NomeDescrição
System_CAPS_protmethodAddAttributesToRender(HtmlTextWriter)

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

System_CAPS_protmethodAddedControl(Control, Int32)

Chamado depois que um controle filho é adicionado para o Controls coleção do Control objeto.(Herdado de Control.)

System_CAPS_protmethodAddParsedSubObject(Object)

Notifica o controle de servidor que um elemento XML ou HTML é analisado e adiciona o elemento para o controle de servidor ControlCollection objeto.(Herdado de Control.)

System_CAPS_pubmethodApplyStyle(Style)

Copia quaisquer elementos não vazios do estilo especificado para o controle da Web, substituindo os elementos de estilo existente do controle. Esse método é usado principalmente por desenvolvedores de controle.(Herdado de WebControl.)

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

Aplica-se as propriedades de estilo definidas na folha de estilo da página para o controle.(Herdado de Control.)

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

Começa o rastreamento de tempo de design de dados de renderização.(Herdado de Control.)

System_CAPS_protmethodBuildProfileTree(String, Boolean)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Reúne informações sobre o controle de servidor e enviá-lo para o Trace propriedade a ser exibida quando o rastreamento está habilitado para a página.(Herdado de Control.)

System_CAPS_protmethodClearCachedClientID()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Define o cache ClientID valor null.(Herdado de Control.)

System_CAPS_protmethodClearChildControlState()

Exclui as informações de estado de controle para os controles filho do controle de servidor.(Herdado de Control.)

System_CAPS_protmethodClearChildState()

Exclui as informações de estado de exibição e estado de controle para controles filho de todo o controle de servidor.(Herdado de Control.)

System_CAPS_protmethodClearChildViewState()

Exclui as informações de estado de exibição para controles filho de todo o controle de servidor.(Herdado de Control.)

System_CAPS_protmethodClearEffectiveClientIDMode()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Conjuntos de ClientIDMode propriedade da instância atual do controle e de todos os controles filho para Inherit.(Herdado de Control.)

System_CAPS_protmethodClose()

Alterna a página da Web do modo de exibição de catálogo para o modo de procura normal.(Substitui o ToolZone.Close().)

System_CAPS_pubmethodCopyBaseAttributes(WebControl)

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

System_CAPS_protmethodCreateCatalogPartChrome()

Cria uma instância de um CatalogPartChrome objeto usado para renderizar o usuário periférico elementos de interface do usuário para CatalogPart controles em uma zona.

System_CAPS_protmethodCreateCatalogParts()

Fornece uma declaração de método base que é derivada de zonas pode substituir para lidar com os detalhes da criação de CatalogPart controles contidos em uma zona.

System_CAPS_protmethodCreateChildControls()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Cria o conjunto de filhos controles associados a um CatalogZoneBase zona.(Substitui o Control.CreateChildControls().)

System_CAPS_protmethodCreateControlCollection()

Cria um novo ControlCollection objeto para manter os controles filho (literal e servidor) do controle do servidor.(Herdado de Control.)

System_CAPS_protmethodCreateControlStyle()

Cria o objeto de estilo que é usado internamente pelo WebControl propriedades relacionadas a classe para implementar todos os estilos. Esse método é usado principalmente por desenvolvedores de controle.(Herdado de WebControl.)

System_CAPS_pubmethodDataBind()

Associa uma fonte de dados para o CompositeControl e todos os seus controles filho.(Herdado de CompositeControl.)

System_CAPS_protmethodDataBind(Boolean)

Associa uma fonte de dados para o controle de servidor chamado e todos os seus controles filho com uma opção para gerar o DataBinding evento.(Herdado de Control.)

System_CAPS_protmethodDataBindChildren()

Associa uma fonte de dados para os controles filho do controle de servidor.(Herdado de Control.)

System_CAPS_pubmethodDispose()

Permite que um controle de servidor executar final Limpar antes do lançamento da memória.(Herdado de Control.)

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

Termina o rastreamento em tempo de design de dados de renderização.(Herdado de Control.)

System_CAPS_protmethodEnsureChildControls()

Determina se o controle de servidor contém controles filho. Se não estiver, ele cria filho controles.(Herdado de Control.)

System_CAPS_protmethodEnsureID()

Cria um identificador para controles que não têm um identificador atribuído.(Herdado de Control.)

System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)

System_CAPS_pubmethodFindControl(String)

Procura o contêiner de nomeação atual para um controle de servidor com especificado id parâmetro.(Herdado de Control.)

System_CAPS_protmethodFindControl(String, Int32)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Procura o contêiner de nomeação atual para um controle de servidor com especificado id e um inteiro especificado no pathOffset parâmetro, que auxilia na pesquisa. Você não deve substituir esta versão do FindControl método.(Herdado de Control.)

System_CAPS_pubmethodFocus()

Define o foco para um controle de entrada.(Herdado de Control.)

System_CAPS_protmethodGetDesignModeState()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém dados de tempo de design para um controle.(Herdado de Control.)

System_CAPS_pubmethodGetEffectiveChromeType(Part)

Retorna atual real ou eficiente PartChromeType valor de um WebPart controle, dado o PartChromeType propriedade da zona e o modo de exibição atual da página de Web Parts.(Herdado de WebZone.)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetRouteUrl(Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.(Herdado de Control.)

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.(Herdado de Control.)

System_CAPS_pubmethodGetRouteUrl(String, Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.(Herdado de Control.)

System_CAPS_pubmethodGetRouteUrl(String, RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.(Herdado de Control.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

Retorna a parte de prefixo do UniqueID propriedade do controle especificado.(Herdado de Control.)

System_CAPS_pubmethodHasControls()

Determina se o controle de servidor contém todos os controles filho.(Herdado de Control.)

System_CAPS_protmethodHasEvents()

Retorna um valor que indica se os eventos são registrados para o controle ou os controles filho.(Herdado de Control.)

System_CAPS_protmethodInvalidateCatalogParts()

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

System_CAPS_protmethodIsLiteralContent()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Determina se o controle de servidor contém apenas o conteúdo literal.(Herdado de Control.)

System_CAPS_protmethodLoadControlState(Object)

Carrega o estado de uma solicitação de página anterior para as propriedades de controle que deve persistir em postagens, mesmo quando o estado de exibição está desabilitado no controle.(Substitui o Control.LoadControlState(Object).)

System_CAPS_protmethodLoadPostData(String, NameValueCollection)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. O estado das caixas de seleção que correspondem dos processos de WebPart controles no catálogo, quando a página é postada para o servidor.

System_CAPS_protmethodLoadViewState(Object)

Cargas de informação de estado para uma zona salva anteriormente.(Substitui o ToolZone.LoadViewState(Object).)

System_CAPS_protmethodMapPathSecure(String)

Recupera o caminho físico que é mapeado para um caminho virtual, relativo ou absoluto.(Herdado de Control.)

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do atual Object.(Herdado de Object.)

System_CAPS_pubmethodMergeStyle(Style)

Copia quaisquer elementos não vazios do estilo especificado para a Web de controle, mas não substituirá os elementos de estilo existente do controle. Esse método é usado principalmente por desenvolvedores de controle.(Herdado de WebControl.)

System_CAPS_protmethodOnBubbleEvent(Object, EventArgs)

Determina se o evento para o controle de servidor é passado a hierarquia de controle de servidor da página da interface do usuário.(Herdado de Control.)

System_CAPS_protmethodOnDataBinding(EventArgs)

Gera o DataBinding evento.(Herdado de Control.)

System_CAPS_protmethodOnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)

Fornece uma declaração de método base derivada ToolZone controles podem substituir para lidar com os detalhes de alterar modos de exibição de página para uma zona especializado.(Herdado de ToolZone.)

System_CAPS_protmethodOnInit(EventArgs)

Registra o objeto page para que a página requer o estado do controle.(Substitui o ToolZone.OnInit(EventArgs).)

System_CAPS_protmethodOnLoad(EventArgs)

Gera o Load evento.(Herdado de Control.)

System_CAPS_protmethodOnPreRender(EventArgs)

Gera o PreRender eventos e registra a página do objeto para que ele requer postbacks.(Substitui o WebZone.OnPreRender(EventArgs).)

System_CAPS_protmethodOnSelectedWebPartChanged(Object, WebPartEventArgs)

Fornece uma declaração de método base derivada ToolZone controles podem substituir para manipular o evento de alteração do qual controle de Web Parts é selecionado dentro de uma zona especializada.(Herdado de ToolZone.)

System_CAPS_protmethodOnUnload(EventArgs)

Gera o Unload evento.(Herdado de Control.)

System_CAPS_protmethodOpenFile(String)

Obtém um Stream usada para ler um arquivo.(Herdado de Control.)

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

Atribui quaisquer fontes de evento e suas informações para o pai do controle.(Herdado de Control.)

System_CAPS_protmethodRaisePostBackEvent(String)

Executa as ações associadas a um dos verbos zona ou gera um evento que envia de volta para o servidor.(Substitui o ToolZone.RaisePostBackEvent(String).)

System_CAPS_protmethodRecreateChildControls()

Recria os controles filho em um controle derivado de CompositeControl.(Herdado de CompositeControl.)

System_CAPS_protmethodRemovedControl(Control)

Chamado após a remoção de um controle filho a Controls coleção do Control objeto.(Herdado de Control.)

System_CAPS_protmethodRender(HtmlTextWriter)

Renderiza a zona especificado HtmlTextWriter objeto.(Substitui o CompositeControl.Render(HtmlTextWriter).)

System_CAPS_pubmethodRenderBeginTag(HtmlTextWriter)

Processa a marca HTML do controle especificado zona abertura HtmlTextWriter objeto.(Herdado de WebZone.)

System_CAPS_protmethodRenderBody(HtmlTextWriter)

Substitui o método base para renderizar a área do corpo de uma zona que deriva de CatalogZoneBase classe.(Substitui o WebZone.RenderBody(HtmlTextWriter).)

System_CAPS_protmethodRenderCatalogPartLinks(HtmlTextWriter)

Renderiza os links para a pessoa CatalogPart controles em um CatalogZoneBase zona.

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

Gera o conteúdo de filhos de um controle de servidor a um fornecido HtmlTextWriter objeto, que grava o conteúdo a ser processado no cliente.(Herdado de Control.)

System_CAPS_protmethodRenderContents(HtmlTextWriter)

Processa todo o conteúdo de um controle de zona entre o início e fim as marcas especificado HtmlTextWriter objeto.(Herdado de WebZone.)

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

Gera o conteúdo do controle de servidor a um fornecido HtmlTextWriter de objeto e armazena informações de rastreamento sobre o controle se o rastreamento está habilitado.(Herdado de Control.)

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

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

System_CAPS_pubmethodRenderEndTag(HtmlTextWriter)

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

System_CAPS_protmethodRenderFooter(HtmlTextWriter)

Renderiza a área de rodapé para um CatalogZoneBase zona.(Substitui o ToolZone.RenderFooter(HtmlTextWriter).)

System_CAPS_protmethodRenderHeader(HtmlTextWriter)

Substitui o método base para fornecer processamento especializado para a área de cabeçalho necessária ToolZone controles.(Herdado de ToolZone.)

System_CAPS_protmethodRenderVerb(HtmlTextWriter, WebPartVerb)

Processa um verbo individual com um ToolZone controle.(Herdado de ToolZone.)

System_CAPS_protmethodRenderVerbs(HtmlTextWriter)

Renderiza os verbos na área de rodapé de um CatalogZoneBase zona.(Substitui o ToolZone.RenderVerbs(HtmlTextWriter).)

System_CAPS_protmethodResolveAdapter()

Obtém o adaptador de controle responsável por processar o controle especificado.(Herdado de Control.)

System_CAPS_pubmethodResolveClientUrl(String)

Obtém uma URL que pode ser usada pelo navegador.(Herdado de Control.)

System_CAPS_pubmethodResolveUrl(String)

Converte uma URL em que pode ser usado no cliente solicitante.(Herdado de Control.)

System_CAPS_protmethodSaveControlState()

Salva as alterações em um CatalogZoneBase estado do controle que ocorrem após a página da Web é lançada de volta para o servidor.(Substitui o Control.SaveControlState().)

System_CAPS_protmethodSaveViewState()

Salva as alterações de estado de exibição que ocorreram depois que uma página foi postada no servidor.(Substitui o ToolZone.SaveViewState().)

System_CAPS_protmethodSetDesignModeState(IDictionary)

Define os dados de tempo de design para um controle.(Herdado de Control.)

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Atribui um delegado do manipulador de eventos para processar o controle de servidor e seu conteúdo em seu controle pai.(Herdado de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object)

Conjuntos de dados de rastreamento de dados de renderização, usando a chave de dados de rastreamento e o valor de dados de rastreamento de tempo de design de rastreamento.(Herdado de Control.)

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

Conjuntos de dados de rastreamento de dados de renderização, usando o objeto rastreado, a chave de dados de rastreamento e o valor de dados de rastreamento de tempo de design de rastreamento.(Herdado de Control.)

System_CAPS_pubmethodToString()

Retorna uma string que representa o objeto atual.(Herdado de Object.)

System_CAPS_protmethodTrackViewState()

Controla as alterações para o estado de exibição do controle de uma zona.(Substitui o ToolZone.TrackViewState().)

NomeDescrição
System_CAPS_pubeventDataBinding

Ocorre quando o server control vincula a uma fonte de dados.(Herdado de Control.)

System_CAPS_pubeventDisposed

Ocorre quando um server control é liberado da memória, que é a última etapa do ciclo de vida do server contorl quando uma página ASP.NET é solicitada.(Herdado de Control.)

System_CAPS_pubeventInit

Ocorre quando o server control é inicializado, que é o primeiro passo em seu ciclo de vida.(Herdado de Control.)

System_CAPS_pubeventLoad

Ocorre quando o controle de servidor é carregado para o Page objeto.(Herdado de Control.)

System_CAPS_pubeventPreRender

Ocorre após o Control objeto é carregado, mas antes do processamento.(Herdado de Control.)

System_CAPS_pubeventUnload

Ocorre quando o server control é descarregado da memória.(Herdado de Control.)

NomeDescrição
System_CAPS_pubinterfaceSystem_CAPS_privmethodIAttributeAccessor.GetAttribute(String)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Obtém um atributo do controle da Web com o nome especificado.(Herdado de WebControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIAttributeAccessor.SetAttribute(String, String)

Define um atributo de controle da Web para o nome especificado e o valor.(Herdado de WebControl.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição desse membro, consulte IControlDesignerAccessor.GetDesignModeState.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição desse membro, consulte IControlDesignerAccessor.SetDesignModeState.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Para obter uma descrição desse membro, consulte IControlDesignerAccessor.SetOwnerControl.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

Para obter uma descrição desse membro, consulte IParserAccessor.AddParsedSubObject.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackDataHandler.LoadPostData(String, NameValueCollection)

Implementa o IPostBackDataHandler.LoadPostData método chamando o LoadPostData método o CatalogZoneBase classe.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackDataHandler.RaisePostDataChangedEvent()

Para obter uma descrição desse membro, consulte RaisePostDataChangedEvent.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackEventHandler.RaisePostBackEvent(String)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Implementa o RaisePostBackEvent método.(Herdado de ToolZone.)

System_CAPS_pubinterfaceSystem_CAPS_privmethodICompositeControlDesignerAccessor.RecreateChildControls()

Permite que um designer recriar a coleção de controles filho no ambiente de tempo de design do controle composto.(Herdado de CompositeControl.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

Para obter uma descrição desse membro, consulte IControlBuilderAccessor.ControlBuilder.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

Para obter uma descrição desse membro, consulte IControlDesignerAccessor.UserData.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

Para obter uma descrição desse membro, consulte IDataBindingsAccessor.DataBindings.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

Para obter uma descrição desse membro, consulte IDataBindingsAccessor.HasDataBindings.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

Para obter uma descrição desse membro, consulte IExpressionsAccessor.Expressions.(Herdado de Control.)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

Para obter uma descrição desse membro, consulte IExpressionsAccessor.HasExpressions.(Herdado de Control.)

NomeDescrição
System_CAPS_pubmethodEnableDynamicData(Type)

Sobrecarregado. Habilita o comportamento dinâmico de dados para o controle de dados especificado.(Definido pelo DataControlExtensions.)

System_CAPS_pubmethodEnableDynamicData(Type, IDictionary<String, Object>)

Sobrecarregado. Habilita o comportamento dinâmico de dados para o controle de dados especificado.(Definido pelo DataControlExtensions.)

System_CAPS_pubmethodEnableDynamicData(Type, Object)

Sobrecarregado. Habilita o comportamento dinâmico de dados para o controle de dados especificado.(Definido pelo DataControlExtensions.)

System_CAPS_pubmethodFindDataSourceControl()

Retorna a fonte de dados que está associada com o controle de dados para o controle especificado.(Definido pelo DynamicDataExtensions.)

System_CAPS_pubmethodFindFieldTemplate(String)

Retorna que o modelo de campo para a coluna especificada no controle especificado do contêiner de nomeação.(Definido pelo DynamicDataExtensions.)

System_CAPS_pubmethodFindMetaTable()

Retorna o objeto metatable contendo o controle de dados.(Definido pelo DynamicDataExtensions.)

System_CAPS_pubmethodGetDefaultValues()

Sobrecarregado. Obtém a coleção de valores padrão para o controle de dados especificado.(Definido pelo DynamicDataExtensions.)

System_CAPS_pubmethodGetMetaTable()

Sobrecarregado. Obtém os metadados da tabela para o controle de dados especificado.(Definido pelo DynamicDataExtensions.)

System_CAPS_pubmethodSetMetaTable(MetaTable)

Sobrecarregado. Define os metadados de tabela para o controle de dados especificado.(Definido pelo DynamicDataExtensions.)

System_CAPS_pubmethodSetMetaTable(MetaTable, IDictionary<String, Object>)

Sobrecarregado. Define o metadados e o padrão valor mapeamento de tabela para o controle de dados especificado.(Definido pelo DynamicDataExtensions.)

System_CAPS_pubmethodSetMetaTable(MetaTable, Object)

Sobrecarregado. Define o metadados e o padrão valor mapeamento de tabela para o controle de dados especificado.(Definido pelo DynamicDataExtensions.)

System_CAPS_pubmethodTryGetMetaTable(MetaTable)

Sobrecarregado. Determina se os metadados da tabela estão disponível.(Definido pelo DynamicDataExtensions.)

O CatalogZoneBase classe é uma classe base que herda de ToolZone classe. Ele fornece um conjunto básico de comportamentos para zonas derivadas.

O CatalogZoneBase classe fornece uma interface de usuário exclusivo (UI) que permite aos usuários adicionar WebPart controles e outros controles de servidor para páginas da Web. Controles que derivam de CatalogZoneBase classe, como CatalogZone, são os controles, na verdade, colocada em páginas da Web. Eles atuam como contêineres para outros controles, conhecidos como CatalogPart controles, criar listas de controles de servidor para os usuários adicionar a uma página. As zonas que derivam de CatalogZoneBase classe pode aparecer somente quando a página está no modo de exibição de catálogo.

System_CAPS_noteObservação

A CatalogZoneBase zona só pode conter CatalogPart controles e por outro lado, CatalogPart controles podem residir apenas no CatalogZoneBase zonas.

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

Controle

Descrição

PageCatalogPart

Mantém referências a controles que foram fechados em uma página. Esses controles podem ser reabertos (adicionado de volta à página) pelos usuários.

DeclarativeCatalogPart

Contém referências a controles que são 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 para um catálogo para que o controle pode ser adicionado a uma página da Web. Arquivos de definição são arquivos XML com um. Web Part extensão de nome de arquivo que importar configurações para um controle. O controle deve estar presente no servidor antes do arquivo de definição pode ser importado.

O CatalogZoneBase classe tem um número de propriedades que são úteis para exibir os catálogos de WebPart controles. O AddVerb propriedade referencia o verbo que adiciona um controle selecionado do catálogo para a página, enquanto o CloseVerb propriedade referencia um verbo que fecha o catálogo e retorna o modo de exibição da página para o modo procurar. O CatalogParts a coleção de todas as referências de propriedade CatalogPart controles na região. Várias propriedades de texto, como EmptyZoneText, HeaderText, e InstructionText, substituir as propriedades de base para fornecer um texto padrão apropriado para os catálogos. O SelectTargetZoneText propriedade contém o texto juntamente com o controle de lista suspensa que permite aos usuários escolher qual zona um controle será adicionada ao.

Várias outras propriedades são incluídas na CatalogZoneBase classe. O SelectedCatalogPartID propriedade é um identificador de cadeia de caracteres exclusiva para o elemento selecionado atualmente CatalogPart controle. O ShowCatalogIcons propriedade indica se os ícones que podem ser associados a controles, definindo o CatalogIconImageUrl propriedade em um WebPart controle.

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

Além das propriedades, também existem alguns métodos na CatalogZoneBase classe, além de manipulação de eventos padrão e métodos de processamento herdada de outros controles de base, que são projetados exclusivamente para fins de tratamento de catálogos de controles. O CreateCatalogPartChrome método cria o cromado (elementos de interface do usuário periféricos, como uma borda e um título, ícones e verbos) ao redor de cada CatalogPart controle na zona e também gerencia o processamento dos controles. O CreateCatalogParts método é um método abstrato; classes derivadas substituem-la 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 nas alterações de zona para algum motivo a programação e a classe derivada precisa recriar a coleção. O LoadPostData método carrega o estado existente para as caixas de seleção ao lado de WebPart controles no catálogo, sempre que a página está lançada novamente para o servidor; por outro lado, o SaveControlState método salva o estado das caixas de seleção. Por fim, o RenderCatalogPartLinks método fornece processamento para os links a cada CatalogPart controle contido na zona.

Observações para os Herdeiros:

Se você quiser desenvolver uma zona personalizada para hospedagem CatalogPart controles, você deve determinar se deseja fornecer suporte de modelo de zona. Um modelo de zona é criado por tipos que implementam o ITemplate da interface e é necessário se você quiser permitir que os desenvolvedores de página usando sua zona personalizada para fazer referência a CatalogPart controles dentro de sua região na marcação declarativa de uma página da Web. Se você precisar de zona de suporte de modelo, você deve herdar da CatalogZone classe. Por outro lado, se a zona personalizada e sua CatalogPart controles serão independentes e eles serão criados programaticamente sem opções para os desenvolvedores de páginas especificar controles de forma declarativa em um modelo de zona, você pode herdar diretamente da CatalogZoneBase classe. Se você herdar a CatalogZoneBase classe, você deve substituir o CreateCatalogParts método e adicione o WebPart ou outros controles de servidor que você deseja em seu catálogo uma CatalogPartCollection objeto.

O exemplo de código a seguir demonstra vários declarativa e usa programático da CatalogZoneBase classe. Porque a classe é abstrata, os exemplos de código usam derivados CatalogZone fornecido com o conjunto de controles Web Parts, demonstrando as propriedades e métodos que herda da classe de CatalogZoneBase classe.

O exemplo de código tem quatro partes:

  • Um controle de usuário que permite que você altere 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 algumas das principais CatalogZoneBase membros de classe.

  • Um personalizado WebPart controle que é adicionado ao personalizado CatalogZone controle.

  • 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 que você altere os modos de exibição na página. Para obter detalhes sobre modos e uma descrição do código-fonte de exibição neste controle, consulte Walkthrough: Changing Display Modes on a Web Parts Page.

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

A segunda parte do exemplo de código é uma página da Web que contém uma referência declarativa para um CatalogZone controle. Na parte superior da página são dois Register diretivas – um controle de usuário e outro para personalizado WebPart controle. Observe que abaixo o <asp:WebPartZone> elemento é um <asp: CatalogZone> elemento que contém referências declarativas para personalizado WebPart controle e um ASP.NET Calendar controle. A zona também tem uma variedade de marcas e propriedades definidas para determinar sua aparência e comportamento. Entre os <script> marcas na página é uma variedade de códigos de manipulação de eventos, mais do que demonstra os programático vários usos do 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;
  }

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

  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 />";
    }
  }

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

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

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

</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>

A terceira parte do exemplo de código é personalizado WebPart controle chamado TextDisplayWebPart. Ela é declarada dentro da zona e um usuário final pode adicioná-lo do catálogo para a página. Para 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 seu site da Web ou cache de assembly global. Como alternativa, você pode colocar o código-fonte na pasta App_Code de seu site, onde ele será compilado dinamicamente em tempo de execução. Para 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 (input.Text != String.Empty)
      {
        _contentText = input.Text + @"<br />";
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }

  }
}

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

<webParts enableExport="true">

...

</webParts>

Quando você carregar a página em um navegador, você pode selecionar catálogo na caixa de lista suspensa para alternar para modo de exibição de catálogo. Quando o catálogo está visível, você pode ver os dois controles de servidor que podem ser adicionados à página do catálogo e pode Observe também, na interface do usuário, os efeitos do programático e declarativo usam do CatalogZoneBase membros de classe.

.NET Framework
Disponível desde 2.0

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: