WebPart.Hidden Proprietà

Definizione

Ottiene o imposta un valore che indica se un controllo WebPart viene visualizzato in una pagina Web.Gets or sets a value indicating whether a WebPart control is displayed on a Web page.

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; }
member this.Hidden : bool with get, set
Public Overridable Property Hidden As Boolean

Valore della proprietà

false se il controllo WebPart è visualizzato in una pagina Web. In caso contrario, true.false if the WebPart control is displayed on a Web page; otherwise, true. Il valore predefinito è false.The default value is false.

Attributi

Esempi

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo della proprietà Hidden per un controllo Web part personalizzato.The following code example demonstrates the use of the Hidden property for a custom Web Parts control. Questo esempio presuppone l'uso di un controllo personalizzato, TextDisplayWebPart, presente nella sezione di esempio della panoramica della classe WebPart.This example assumes the use of a custom control, TextDisplayWebPart, which is found in the Example section of the WebPart class overview.

Si noti che nella pagina Web, nel markup dichiarativo per l'elemento <aspSample:TextDisplayWebPart>, il valore dell'attributo Hidden è impostato su true.Notice that in the Web page, in the declarative markup for the <aspSample:TextDisplayWebPart> element, the Hidden attribute value is set to true. Il controllo TextDisplayWebPart non verrà visualizzato se la pagina viene caricata in un browser.The TextDisplayWebPart control will not appear if the page is loaded in a browser. Tuttavia, il controllo è ancora presente nella pagina e nella relativa zona e può comunque partecipare alle connessioni con altri controlli WebPart se sono state create tali connessioni.However, the control is still present on the page and in its zone, and it still could participate in connections with other WebPart controls if you created those connections.

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

Commenti

Un controllo WebPart nascosto rimane nella propria zona, ne viene effettivamente eseguito il rendering nella pagina e partecipa alle fasi del ciclo di vita della pagina, ad esempio la fase di PreRender, anche se non è visibile in un browser.A WebPart control that is hidden remains in its zone, is actually rendered on its page, and participates in page life cycle phases such as the PreRender phase, even though it is not visible in a browser. Questa operazione è diversa da quella dei controlli WebPart chiusi, perché i controlli chiusi non vengono sottoposti a rendering in una pagina, mentre i controlli nascosti vengono sottoposti a rendering e attivi nelle applicazioni Web part, anche se non sono visibili agli utenti.This is different from WebPart controls that are closed, because closed controls are not even rendered on a page, while hidden controls are rendered and active in Web Parts applications, though not visible to users. Il set di controllo Web part nasconde il controllo WebPart impostando lo stile CSS (CSS) su un valore di display:none.The Web Parts control set hides the WebPart control by setting its cascading style sheet (CSS) style to a value of display:none.

Anche se la proprietà Hidden per un controllo è impostata su true, il controllo viene comunque visualizzato se la modalità di visualizzazione corrente nella pagina consente la visualizzazione dei controlli nascosti.Even if the Hidden property for a control is set to true, the control is still displayed if the current display mode on the page allows hidden controls to be displayed. Ad esempio, la modalità di modifica consente di visualizzare i controlli nascosti, in modo che gli utenti possano modificarli.For example, edit mode allows hidden controls to be displayed, so that users can edit them. Quando i controlli nascosti sono visibili in determinate modalità di visualizzazione, il titolo del controllo Visualizza una stringa che indica che lo stato del controllo è nascosto.When hidden controls are visible in certain display modes, the title of the control displays a string indicating that the control is in hidden status.

Quando la proprietà Hidden in un controllo WebPart è impostata su false, che è l'impostazione predefinita, il controllo viene visualizzato nella pagina.When the Hidden property on a WebPart control is set to false, which is the default, the control is displayed on the page. Si noti che se la proprietà AllowHide è impostata su false, gli utenti finali non sono autorizzati a modificare il valore della proprietà Hidden.Note that if the AllowHide property is set to false, end users are not allowed to edit the Hidden property value.

Questa proprietà non può essere impostata da temi oppure temi di fogli di stile.This property cannot be set by themes or style sheet themes. Per ulteriori informazioni, vedere i temi e le interfaccedi ThemeableAttribute e ASP.NET.For more information, see ThemeableAttribute and ASP.NET Themes and Skins.

Si applica a

Vedi anche