WebPart.Hidden Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls.WebParts
Ensamblado:
System.Web.dll

Obtiene o establece un valor que indica si un control WebPart se muestra en una 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 propiedad

Boolean

false si el control WebPart se muestra en una página Web; en caso contrario, true. El valor predeterminado es false.

Atributos
ThemeableAttribute PersonalizableAttribute

Ejemplos

En el ejemplo de código siguiente se muestra el uso de la Hidden propiedad para un control de elementos web personalizado. En este ejemplo se supone el uso de un control personalizado, TextDisplayWebPart, que se encuentra en la sección Ejemplo de la información general de la WebPart clase.

Observe que en la página web, en el marcado declarativo del <aspSample:TextDisplayWebPart> elemento , el valor del Hidden atributo se establece trueen . El TextDisplayWebPart control no aparecerá si la página se carga en un explorador. Sin embargo, el control todavía está presente en la página y en su zona, y todavía podría participar en conexiones con otros WebPart controles si creó esas conexiones.

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

Comentarios

Un WebPart control oculto permanece en su zona, se representa realmente en su página y participa en las fases del ciclo de vida de la página, como la PreRender fase, aunque no esté visible en un explorador. Esto es diferente de WebPart los controles que están cerrados, ya que los controles cerrados ni siquiera se representan en una página, mientras que los controles ocultos se representan y activan en elementos web aplicaciones, aunque no son visibles para los usuarios. El conjunto de controles elementos web oculta el WebPart control estableciendo su estilo de hoja de estilos en cascada (CSS) en un valor de display:none.

Incluso si la Hidden propiedad de un control está establecida trueen , el control se sigue mostrando si el modo de presentación actual de la página permite mostrar controles ocultos. Por ejemplo, el modo de edición permite mostrar controles ocultos para que los usuarios puedan editarlos. Cuando los controles ocultos están visibles en determinados modos de presentación, el título del control muestra una cadena que indica que el control está en estado oculto.

Cuando la Hidden propiedad de un WebPart control se establece falseen , que es el valor predeterminado, el control se muestra en la página. Tenga en cuenta que si la AllowHide propiedad está establecida falseen , los usuarios finales no pueden editar el valor de la Hidden propiedad.

Esta propiedad no se puede establecer mediante temas o temas de la hoja de estilos. Para obtener más información, vea ThemeableAttribute y ASP.NET Temas y máscaras.

Se aplica a

Consulte también