Поделиться через

WebPart.Hidden Свойство

Определение

Пространство имен:
System.Web.UI.WebControls.WebParts
Сборка:
System.Web.dll

Возвращает или задает значение, указывающее, отображается ли WebPart элемент управления на веб-странице.

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

Значение свойства

Boolean

false WebPart Значение , trueесли элемент управления отображается на веб-странице; в противном случае . Значение по умолчанию — false.

Атрибуты
ThemeableAttribute PersonalizableAttribute

Примеры

В следующем примере кода показано использование Hidden свойства для пользовательского элемента управления веб-частей. В этом примере предполагается использование пользовательского элемента управления, TextDisplayWebPartкоторый находится в разделе WebPart "Пример" обзора класса.

Обратите внимание, что на веб-странице в декларативной разметке для <aspSample:TextDisplayWebPart> элемента Hidden задается trueзначение атрибута. Элемент TextDisplayWebPart управления не будет отображаться, если страница загружается в браузере. Однако элемент управления по-прежнему присутствует на странице и в его зоне, и он по-прежнему может участвовать в соединениях с другими WebPart элементами управления, если вы создали эти подключения.

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

Комментарии

Элемент WebPart управления, скрытый остается в зоне, фактически отображается на своей странице и участвует в этапах жизненного цикла страницы, таких как PreRender этап, даже если он не отображается в браузере. Это отличается от WebPart элементов управления, которые закрыты, поскольку закрытые элементы управления даже не отображаются на странице, а скрытые элементы управления отображаются и активны в приложениях веб-частей, хотя и не отображаются пользователям. Набор элементов управления веб-частей скрывает WebPart элемент управления, задав его каскадный стиль таблицы стилей (CSS) значением display:none.

Даже если Hidden для элемента управления задано trueсвойство, элемент управления по-прежнему отображается, если текущий режим отображения на странице позволяет отображать скрытые элементы управления. Например, режим редактирования позволяет отображать скрытые элементы управления, чтобы пользователи могли редактировать их. Если скрытые элементы управления отображаются в определенных режимах отображения, заголовок элемента управления отображает строку, указывающую, что элемент управления находится в скрытом состоянии.

Hidden Если свойству WebPart элемента управления присвоено falseзначение по умолчанию, элемент управления отображается на странице. Обратите внимание, что если AllowHide для свойства задано falseзначение, конечные пользователи не могут изменять Hidden значение свойства.

Это свойство не может быть задано темами или темами таблицы стилей. Дополнительные сведения см. в статье ThemeableAttributeи ASP.NET темы и скины.

Применяется к

См. также раздел