WebPartManager.DisplayMode 속성

참조

정의

네임스페이스:: System.Web.UI.WebControls.WebParts

어셈블리:: System.Web.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

웹 파트 컨트롤이 들어 있는 웹 페이지의 활성 디스플레이 모드를 가져오거나 설정합니다.

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 . 브라우저에서 페이지를 로드한 후 페이지 아래쪽에 있는 단추를 사용하여 표시 모드를 전환할 수 있습니다. 페이지가 로드되면 기본적으로 찾아보기 모드에 있습니다. 디자인 모드로 전환하면 서버 컨트롤을 한 영역에서 다른 영역으로 끌거나 한 영역 내에 두 개의 컨트롤을 정렬할 수 있습니다. 편집 모드로 전환하면 서버 컨트롤의 머리글에서 동사 메뉴를 클릭하고, 편집 을 선택하고, 제공된 편집 UI(사용자 인터페이스)를 사용하여 컨트롤을 편집할 수 있습니다.

참고

웹 파트 애플리케이션의 디스플레이 모드 간에 전환 하는 것은 매우 흔히 및 웹 파트 컨트롤이 들어 있는 모든 페이지에이 작업을 수행 하는 일관 되 고 다시 사용할 수 있는 방법을 제공 하는 것이 좋습니다. 표시 모드를 변경하고 여러 페이지에서 다시 사용할 수 있는 사용자 컨트롤의 예는 연습: 웹 파트 페이지에서 표시 모드 변경을 참조하세요.

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

정의

속성 값

예외

예제

설명

적용 대상

추가 정보

추가 리소스