WebPartManager.SupportedDisplayModes 속성

참조

정의

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

어셈블리:: System.Web.dll

중요

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

특정 웹 페이지에서 사용할 수 있는 모든 디스플레이 모드의 읽기 전용 컬렉션을 가져옵니다.

public:
 property System::Web::UI::WebControls::WebParts::WebPartDisplayModeCollection ^ SupportedDisplayModes { System::Web::UI::WebControls::WebParts::WebPartDisplayModeCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.WebParts.WebPartDisplayModeCollection SupportedDisplayModes { get; }

[<System.ComponentModel.Browsable(false)>]
member this.SupportedDisplayModes : System.Web.UI.WebControls.WebParts.WebPartDisplayModeCollection

Public ReadOnly Property SupportedDisplayModes As WebPartDisplayModeCollection

속성 값

WebPartDisplayModeCollection

특정 웹 페이지에서 사용할 수 있는 WebPartDisplayModeCollection 개체의 집합이 들어 있는 WebPartDisplayMode입니다.

특성: BrowsableAttribute

예제

다음 코드 예제에서는 프로그래밍 방식으로 사용 하는 속성입니다 SupportedDisplayModes . 이 코드는 이 속성을 사용하여 현재 웹 페이지에서 사용할 수 있는 표시 모드로만 목록을 채웁니다.

이 페이지에는 찾아보기, 디자인 및 편집이라는 세 가지 지원되는 디스플레이 모드가 있습니다. 처음 두 가지는 항상 사용할 수 있으며 페이지에 컨트롤이 포함되어 있으므로 이 코드 예제에서 편집 모드를 EditorZone 사용할 수 있습니다. 카탈로그 및 연결 표시 모드는 해당 영역이 이 페이지에 없기 때문에 표시되지 않습니다.

<%@ 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 Page_Init(object sender, EventArgs e)
  {
    foreach (WebPartDisplayMode mode in mgr.SupportedDisplayModes)
    {
      string modeName = mode.Name;
      if (mode.IsEnabled(mgr))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }      
    }
  }

  protected void DisplayModeDropdown_SelectedIndexChanged(object 
    sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;
    WebPartDisplayMode mode = 
      mgr.SupportedDisplayModes[selectedMode];
    if (mode != null)
      mgr.DisplayMode = mode;
  }
  
</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:DropDownList ID="DisplayModeDropdown" runat="server" 
        AutoPostBack="true"
        Width="120"
        OnSelectedIndexChanged=
        "DisplayModeDropdown_SelectedIndexChanged">
      </asp:DropDownList>
    </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 Page_Init(ByVal sender As Object, _
    ByVal e As EventArgs)
    Dim mode As WebPartDisplayMode
    For Each mode In mgr.SupportedDisplayModes
      Dim modeName As String = mode.Name
      If mode.IsEnabled(mgr) Then
        Dim item As ListItem = New ListItem(modeName, modeName)
        DisplayModeDropdown.Items.Add(item)
      End If
    Next
    
  End Sub

  Protected Sub DisplayModeDropdown_SelectedIndexChanged(ByVal _
    sender As Object, ByVal e As EventArgs)
    Dim selectedMode As String = _
      DisplayModeDropdown.SelectedValue
    Dim mode As WebPartDisplayMode = _
      mgr.SupportedDisplayModes(selectedMode)
    If mode IsNot Nothing Then
      mgr.DisplayMode = mode
    End If
  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:DropDownList ID="DisplayModeDropdown" runat="server" 
        AutoPostBack="true"
        Width="120"
        OnSelectedIndexChanged=
        "DisplayModeDropdown_SelectedIndexChanged">
      </asp:DropDownList>
    </div>
    </form>
</body>
</html>

브라우저에서 페이지를 로드한 후 드롭다운 목록 컨트롤을 사용하여 페이지를 찾아보기 모드에서 디자인 모드로 전환한 다음 편집 모드로 전환할 수 있습니다. 편집 모드에서 서버 컨트롤 중 하나의 머리글에서 드롭다운 동사 메뉴를 클릭하고 편집 을 선택하여 컨트롤을 편집할 수 있습니다.

설명

속성에는 SupportedDisplayModes 페이지에 있는 영역 컨트롤의 종류에 따라 실제로 페이지에서 사용할 수 있는 표시 모드만 포함 됩니다.

참고

표시 모드를 사용하지 않도록 설정할 수 있으며 표시 모드를 사용하지 않도록 설정하면 해당 표시 모드를 SupportedDisplayModes 지원하는 영역 유형이 페이지에 있는 경우에도 컬렉션에 추가되지 않습니다.

찾아보기 모드 및 디자인 모드는 항상 지원됩니다. 다를 수 있는 표시 모드는 편집, 카탈로그 및 연결 모드입니다. 이러한 각 표시 모드는 특정 유형의 ToolZone 컨트롤과 연결됩니다. 특정 표시 모드가 속성에서 참조하는 컬렉션에 추가되도록 하는 것은 웹 페이지에 특별히 형식화된 영역이 있는 것입니다 SupportedDisplayModes . 예를 들어 웹 페이지에 영역이 포함되지 EditorZone 만 영역이 없는 CatalogZone 경우 편집 표시 모드는 해당 페이지에서 지원되는 모드 중 하나이지만 카탈로그 표시 모드는 지원되지 않습니다.

참고

속성은 SupportedDisplayModes 현재 WebPartManager 컨트롤에서 DisplayModes 사용할 수 있는 모든 표시 모드가 포함된 컬렉션을 참조하는 속성과 다르며, 특정 페이지에서 지원되지 않는 모드도 참조합니다.

적용 대상

다음을 통해 공유

WebPartManager.SupportedDisplayModes 속성

정의

속성 값

예제

설명

적용 대상

추가 정보

추가 리소스