Aracılığıyla paylaş

WebPartManager.SupportedDisplayModes Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls.WebParts
Bütünleştirilmiş Kod:
System.Web.dll

Belirli bir Web sayfasında kullanılabilen tüm görüntüleme modlarından oluşan salt okunur bir koleksiyon alır.

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

Özellik Değeri

WebPartDisplayModeCollection

WebPartDisplayModeCollection Belirli bir Web sayfasında bulunan nesne kümesini WebPartDisplayMode içeren.

Öznitelikler
BrowsableAttribute

Örnekler

Aşağıdaki kod örneği, özelliğinin program aracılığıyla kullanımını SupportedDisplayModes gösterir. Kod, listeyi yalnızca geçerli Web sayfasında kullanılabilen görüntüleme modlarıyla doldurmak için bu özelliği kullanır.

Bu sayfada desteklenen üç görüntü modu vardır: göz atma, tasarlama ve düzenleme. İlk ikisi her zaman kullanılabilir ve düzenleme modu bu kod örneğinde kullanılabilir çünkü sayfa bir EditorZone denetim içerir. Katalog ve bağlantı görüntüleme modları gösterilmez çünkü bunlara karşılık gelen bölgeler bu sayfada değildir.

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

Sayfayı bir tarayıcıda yükledikten sonra, açılan liste denetimini kullanarak sayfayı göz atma modundan tasarım moduna ve ardından düzenleme moduna geçirebilirsiniz. Düzenleme modunda, sunucu denetimlerinden birinin üst bilgisindeki açılan fiiller menüsüne tıklayabilir ve denetimi düzenlemek için Düzenle'yi seçebilirsiniz.

Açıklamalar

SupportedDisplayModes özelliği, sayfada bulunan bölge denetimi türlerine göre yalnızca bir sayfada gerçekten kullanılabilen görüntüleme modlarını içerir.

Not

Görüntüleme modları devre dışı bırakılabilir ve bir görüntüleme modu devre dışı bırakıldığında, bu görüntüleme modunu destekleyen ilgili bölge türü sayfada mevcut olsa bile koleksiyona eklenmez SupportedDisplayModes .

Gözatma modu ve tasarım modu her zaman desteklenir. Değişiklik gösterebilen görüntü modları düzenleme, katalog ve bağlantı modlarıdır. Bu görüntü modlarının her biri belirli bir denetim türüyle ilişkilendirilir ToolZone . Web sayfasında, özelliği tarafından SupportedDisplayModes başvuruda bulunulmuş koleksiyona belirli bir görüntüleme modunun eklenmesine neden olan, özel olarak yazılan bölgenin varlığıdır. Örneğin, bir Web sayfası bir bölge içeriyorsa ancak bölge içermiyorsa EditorZoneCatalogZone , görüntüleme modunu düzenleme o sayfadaki desteklenen modlardan biridir, ancak katalog görüntüleme modu desteklenmez.

Not

SupportedDisplayModes özelliği, belirli bir sayfada desteklenmeyenler DisplayModes bile geçerli WebPartManager denetimde kullanılabilen tüm görüntüleme modlarını içeren bir koleksiyona başvuran özelliğinden farklıdır.

Şunlara uygulanır

Ayrıca bkz.