Udostępnij za pośrednictwem

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

falsejeśli kontrolka WebPart jest wyświetlana 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ładników 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 swojej strefie, jest faktycznie renderowana na 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ładników Web Part, choć nie są widoczne dla użytkowników. Zestaw kontrolek składników 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 ThemeableAttributei ASP.NET Motywy i skórki.

Dotyczy

Zobacz też