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 kullanılabilen 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 sayfa bir EditorZone denetim içerdiğinden düzenleme modu bu kod örneğinde kullanılabilir. Katalog ve bağlantı görüntüleme modları gösterilmez, çünkü karşılık gelen bölgeleri 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 mevcut olan bölge denetimleri türlerine göre yalnızca bir sayfada gerçekten kullanılabilir olan görüntüleme modlarını içerir.

Not

Görüntü 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 . Özelliği tarafından SupportedDisplayModes başvuruda bulunulmuş koleksiyona belirli bir görüntüleme modunun eklenmesine neden olan, bir Web sayfasında özel olarak yazılan bölgenin varlığıdır. Örneğin, bir Web sayfası 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 denetim için 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.