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 метод. Эти методы предоставляют механизм для настройки поведения страницы и даже для добавления настраиваемого режима отображения.

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

WebPartManager.DisplayMode Свойство

Определение

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

Исключения

Примеры

Комментарии

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

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

Дополнительные ресурсы