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

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

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

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