WebPart.Hidden Свойство

Определение

Получает или задает значение, указывающее, отображается ли элемент управления 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

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

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

Атрибуты

Примеры

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

Обратите внимание, что на веб-странице в декларативной разметке <aspSample:TextDisplayWebPart> для элемента задано значение атрибута Hiddentrue. Элемент 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 элемент управления, устанавливая для его каскадной таблицы стилей display:none(CSS) значение .

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

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

Значение для данного свойства нельзя задать с помощью тем или тем таблиц стилей. Дополнительные сведения см. в разделе ThemeableAttribute и ASP.NET темы и обложки.

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

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