WebPart.Hidden Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls.WebParts
Assemblagem:
System.Web.dll

Recebe ou define um valor que indica se um WebPart controlo é exibido numa página 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 de Propriedade

Boolean

false se o controlo WebPart for exibido numa página Web; caso contrário, true. O valor predefinido é false.

Atributos
ThemeableAttribute PersonalizableAttribute

Exemplos

O exemplo de código seguinte demonstra a utilização da Hidden propriedade para um controlo personalizado de Web Parts. Este exemplo assume o uso de um controlo personalizado, TextDisplayWebPart, que se encontra na secção Exemplo da WebPart visão geral da classe.

Note que na página Web, na marcação declarativa para o <aspSample:TextDisplayWebPart> elemento, o Hidden valor do atributo é definido para true. O TextDisplayWebPart controlo não aparecerá se a página for carregada num navegador. No entanto, o controlo continua presente na página e na sua zona, e ainda pode participar em ligações com outros WebPart controlos se criar essas ligaçõ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>

Observações

Um WebPart controlo que está oculto permanece na sua zona, é realmente renderizado na sua página e participa nas fases do ciclo de vida da página, como a PreRender fase, mesmo que não seja visível num navegador. Isto é diferente dos WebPart controlos fechados, porque os controlos fechados nem sequer são renderizados numa página, enquanto os controlos ocultos são renderizados e ativos em aplicações Web Parts, embora não visíveis para os utilizadores. O conjunto de controlo Web Parts esconde o WebPart controlo definindo o seu estilo de folha de estilo em cascata (CSS) para um valor de display:none.

Mesmo que a Hidden propriedade de um controlo esteja definida para true, o controlo continua a ser exibido se o modo de exibição atual na página permitir que controlos ocultos sejam exibidos. Por exemplo, o modo de edição permite que os controlos ocultos sejam exibidos, para que os utilizadores possam editá-los. Quando os controlos ocultos são visíveis em certos modos de visualização, o título do controlo mostra uma cadeia que indica que o controlo está em estado oculto.

Quando a Hidden propriedade de um WebPart controlo é definida para false, que é o padrão, o controlo é exibido na página. Note que, se a AllowHide propriedade estiver definida para false, os utilizadores finais não podem editar o valor da Hidden propriedade.

Esta propriedade não pode ser definida por temas ou temas de folhas de estilo. Para mais informações, consulte ThemeableAttribute e ASP.NET Temas e Skins.

Aplica-se a

Ver também