Compartilhar via

WebPart.Hidden Propriedade

  • Referência

Definição

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

Obtém ou define um valor que indica se um controle WebPart é exibido em uma página da Web.

public:
 virtual property bool Hidden { bool get(); void set(bool value); };
[System.Web.UI.Themeable(false)]
[System.Web.UI.WebControls.WebParts.Personalizable]
public virtual bool Hidden { get; set; }
[<System.Web.UI.Themeable(false)>]
[<System.Web.UI.WebControls.WebParts.Personalizable>]
member this.Hidden : bool with get, set
Public Overridable Property Hidden As Boolean

Valor da propriedade

Boolean

false se o controle WebPart for exibido em uma página da Web; caso contrário, true. O valor padrão é false.

Atributos
ThemeableAttribute PersonalizableAttribute

Exemplos

O exemplo de código a seguir demonstra o uso da Hidden propriedade para um controle de Web Parts personalizado. Este exemplo pressupõe o uso de um controle personalizado, TextDisplayWebPartque é encontrado na seção Exemplo da visão geral da WebPart classe.

Observe que, na página da Web, na marcação declarativa do <aspSample:TextDisplayWebPart> elemento, o valor do Hidden atributo é definido como true. O TextDisplayWebPart controle não será exibido se a página for carregada em um navegador. No entanto, o controle ainda está presente na página e em sua zona e ainda poderá participar de conexões com outros WebPart controles se você criou essas conexões.

<%@ page language="C#" %>
<%@ 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">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            Hidden="true" />
          </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

<%@ page language="VB" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.VB.Controls" 
             Assembly="TextDisplayWebPartVB"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
  <form id="Form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server" />
    <asp:webpartzone
      id="WebPartZone1"
      runat="server"
      title="Zone 1"
      PartChromeType="TitleAndBorder">
        <parttitlestyle font-bold="true" ForeColor="#3300cc" />
        <partstyle
          borderwidth="1px"   
          borderstyle="Solid"  
          bordercolor="#81AAF2" />
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" 
            Hidden="true" />
          </zonetemplate>
    </asp:webpartzone>
  </form>
</body>
</html>

Comentários

Um WebPart controle que está oculto permanece em sua zona, na verdade é renderizado em sua página e participa de fases do ciclo de vida da página, como a PreRender fase, embora não esteja visível em um navegador. Isso é diferente dos WebPart controles fechados, pois os controles fechados nem são renderizados em uma página, enquanto os controles ocultos são renderizados e ativos em aplicativos Web Parts, embora não visíveis para os usuários. O conjunto de controle Web Parts oculta o WebPart controle definindo seu estilo CSS (folha de estilos em cascata) como um valor de display:none.

Mesmo que a Hidden propriedade de um controle esteja definida como true, o controle ainda será exibido se o modo de exibição atual na página permitir que controles ocultos sejam exibidos. Por exemplo, o modo de edição permite que controles ocultos sejam exibidos para que os usuários possam editá-los. Quando os controles ocultos estão visíveis em determinados modos de exibição, o título do controle exibe uma cadeia de caracteres indicando que o controle está em status oculto.

Quando a Hidden propriedade em um WebPart controle é definida como false, que é o padrão, o controle é exibido na página. Observe que, se a AllowHide propriedade estiver definida como false, os usuários finais não poderão editar o valor da Hidden propriedade.

Essa propriedade não pode ser definida por temas ou temas de folha de estilos. Para obter mais informações, consulte ThemeableAttribute e ASP.NET Temas e Peles.

Aplica-se a

Confira também