WebPartManager.DisplayMode Свойство

  • Ссылка

Определение

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

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

public:
 virtual property System::Web::UI::WebControls::WebParts::WebPartDisplayMode ^ DisplayMode { System::Web::UI::WebControls::WebParts::WebPartDisplayMode ^ get(); void set(System::Web::UI::WebControls::WebParts::WebPartDisplayMode ^ value); };
[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.WebControls.WebParts.WebPartDisplayMode DisplayMode { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.DisplayMode : System.Web.UI.WebControls.WebParts.WebPartDisplayMode with get, set
Public Overridable Property DisplayMode As WebPartDisplayMode

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

WebPartDisplayMode

Объект WebPartDisplayMode, который определяет режим отображения страницы.

Атрибуты
BrowsableAttribute

Исключения

ArgumentNullException

Объект WebPartDisplayMode, который назначается для этого свойства, равен null.

ArgumentException

Объект WebPartDisplayMode, назначаемый для этого свойства, не является одним из поддерживаемых режимов отображения.

-или-

Объект WebPartDisplayMode, который назначается для этого свойства, отключен.

Примеры

В следующем примере кода показано программное использование DisplayMode свойства . После загрузки страницы в браузере можно использовать кнопки в нижней части страницы для переключения режимов отображения. Страница по умолчанию находится в режиме просмотра при загрузке. При переключении в режим конструктора серверные элементы управления можно перетащить из одной зоны в другую или расположить два элемента управления в одной зоне. При переключении в режим редактирования можно щелкнуть меню команд в заголовке любого из серверных элементов управления, выбрать Изменить и изменить элемент управления с помощью предоставленного пользовательского интерфейса редактирования.

Примечание

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

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    
  protected void Button1_Click(object sender, EventArgs e)
  {
    mgr.DisplayMode = WebPartManager.BrowseDisplayMode;
  }

  protected void Button2_Click(object sender, EventArgs e)
  {
    mgr.DisplayMode = WebPartManager.DesignDisplayMode;
  }

  protected void Button3_Click(object sender, EventArgs e)
  {
    mgr.DisplayMode = WebPartManager.EditDisplayMode;
  }
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr" runat="server">
      </asp:WebPartManager>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            DisplayMode="HyperLink" 
            ID="BulletedList1" 
            runat="server"
            Title="My Links">
            <asp:ListItem Value="http://www.microsoft.com">Microsoft</asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">MSN</asp:ListItem>
            <asp:ListItem Value="http://www.contoso.com">Contoso Corp.</asp:ListItem>
          </asp:BulletedList>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:EditorZone ID="EditorZone1" runat="server">
        <ZoneTemplate>
          <asp:AppearanceEditorPart runat="server" ID="Appearance1">
          </asp:AppearanceEditorPart>
          <asp:LayoutEditorPart runat="server" ID="Layout1">
          </asp:LayoutEditorPart>
        </ZoneTemplate>
      </asp:EditorZone>
      <hr />
      <asp:Button ID="Button1" runat="server" Text="Browse Mode" OnClick="Button1_Click" />
      <br />
      <asp:Button ID="Button2" runat="server" Text="Design Mode" OnClick="Button2_Click"/>
      <br />
      <asp:Button ID="Button3" runat="server" Text="Edit Mode" OnClick="Button3_Click"/>
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  
  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    mgr.DisplayMode = WebPartManager.BrowseDisplayMode
  End Sub
  
  Protected Sub Button2_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    mgr.DisplayMode = WebPartManager.DesignDisplayMode
  End Sub
  
  Protected Sub Button3_Click(ByVal sender As Object, _
  ByVal e As EventArgs)
    mgr.DisplayMode = WebPartManager.EditDisplayMode
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr" runat="server">
      </asp:WebPartManager>
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:WebPartZone ID="WebPartZone2" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            DisplayMode="HyperLink" 
            ID="BulletedList1" 
            runat="server"
            Title="My Links">
            <asp:ListItem Value="http://www.microsoft.com">Microsoft</asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">MSN</asp:ListItem>
            <asp:ListItem Value="http://www.contoso.com">Contoso Corp.</asp:ListItem>
          </asp:BulletedList>
        </ZoneTemplate>
      </asp:WebPartZone>
      <asp:EditorZone ID="EditorZone1" runat="server">
        <ZoneTemplate>
          <asp:AppearanceEditorPart runat="server" ID="Appearance1">
          </asp:AppearanceEditorPart>
          <asp:LayoutEditorPart runat="server" ID="Layout1">
          </asp:LayoutEditorPart>
        </ZoneTemplate>
      </asp:EditorZone>
      <hr />
      <asp:Button ID="Button1" runat="server" Text="Browse Mode" OnClick="Button1_Click" />
      <br />
      <asp:Button ID="Button2" runat="server" Text="Design Mode" OnClick="Button2_Click"/>
      <br />
      <asp:Button ID="Button3" runat="server" Text="Edit Mode" OnClick="Button3_Click"/>
    </div>
    </form>
</body>
</html>

Комментарии

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

Класс WebPartManager создает режимы отображения для веб-страницы. С помощью базового WebPartDisplayMode класса элемент управления создает несколько стандартных объектов режима отображения, WebPartManager которые можно использовать на страницах, содержащих элементы управления веб-частей. Эти стандартные режимы отображения описаны в обзоре WebPartDisplayMode класса.

Элемент WebPartManager управления также управляет режимами отображения для страниц, использующих элементы управления веб-частей. DisplayMode С помощью свойства WebPartManager элемент управления сохраняет ссылку на текущий режим отображения на странице. Свойство также можно использовать для DisplayMode переключения страницы в различные режимы отображения. Пример изменения режимов отображения на странице, которая использует элементы управления веб-частей, см. в разделе Пошаговое руководство. Изменение режимов отображения на странице веб-частей.

В рамках управления режимом отображения элемент управления также предоставляет события и обработчики событий, WebPartManager относящиеся к режимам OnDisplayModeChanged отображения, таким как метод и OnDisplayModeChanging метод . Эти методы предоставляют механизм для настройки поведения страницы и даже для добавления пользовательского режима отображения.

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

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