WebPart.Hidden Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls.WebParts
Zestaw:
System.Web.dll

Pobiera lub ustawia wartość wskazującą, czy kontrolka WebPart jest wyświetlana na stronie sieci 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

Wartość właściwości

Boolean

false jeśli kontrolka jest wyświetlana WebPart na stronie sieci Web; w przeciwnym razie true. Wartość domyślna to false.

Atrybuty
ThemeableAttribute PersonalizableAttribute

Przykłady

W poniższym przykładzie kodu pokazano użycie Hidden właściwości dla niestandardowej kontrolki składniki Web Part. W tym przykładzie przyjęto założenie, że użyto niestandardowej kontrolki , TextDisplayWebPartktóra znajduje się w sekcji Przykład w przeglądzie WebPart klasy.

Zwróć uwagę, że na stronie sieci Web w deklaratywnej adiustacji elementu <aspSample:TextDisplayWebPart> Hidden wartość atrybutu jest ustawiona na truewartość . Kontrolka TextDisplayWebPart nie będzie wyświetlana, jeśli strona zostanie załadowana w przeglądarce. Jednak kontrolka jest nadal obecna na stronie i w jej strefie i nadal może uczestniczyć w połączeniach z innymi WebPart kontrolkami, jeśli te połączenia zostały utworzone.

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

Uwagi

Kontrolka WebPart ukryta pozostaje w strefie, jest faktycznie renderowana na swojej stronie i uczestniczy w fazach cyklu życia strony, takich jak PreRender faza, mimo że nie jest widoczna w przeglądarce. Różni się to od WebPart kontrolek, które są zamknięte, ponieważ zamknięte kontrolki nie są nawet renderowane na stronie, podczas gdy ukryte kontrolki są renderowane i aktywne w aplikacjach składniki Web Part, choć nie są widoczne dla użytkowników. Zestaw kontrolek składniki Web Part ukrywa kontrolkęWebPart, ustawiając styl kaskadowego arkusza stylów (CSS) na wartość display:none.

Nawet jeśli Hidden właściwość kontrolki jest ustawiona na true, kontrolka jest nadal wyświetlana, jeśli bieżący tryb wyświetlania na stronie umożliwia wyświetlanie ukrytych kontrolek. Na przykład tryb edycji umożliwia wyświetlanie ukrytych kontrolek, dzięki czemu użytkownicy mogą je edytować. Gdy ukryte kontrolki są widoczne w niektórych trybach wyświetlania, tytuł kontrolki wyświetla ciąg wskazujący, że kontrolka jest w stanie ukrytym.

Hidden Gdy właściwość kontrolki WebPart jest ustawiona na falsewartość , która jest wartością domyślną, kontrolka jest wyświetlana na stronie. Należy pamiętać, że jeśli AllowHide właściwość jest ustawiona na false, użytkownicy końcowi nie mogą edytować Hidden wartości właściwości.

Tej właściwości nie można ustawić za pomocą motywów ani motywów arkusza stylów. Aby uzyskać więcej informacji, zobacz ThemeableAttribute tematy i ASP.NET motywy i skórki.

Dotyczy

Zobacz też