WebPartManager.SupportedDisplayModes Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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.WebPartDisplayModeCollectionPublic ReadOnly Property SupportedDisplayModes As WebPartDisplayModeCollectionÖzellik Değeri
WebPartDisplayModeCollection Belirli bir Web sayfasında kullanılabilen nesne kümesini WebPartDisplayMode içeren.
- Öznitelikler
Ö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ü modlarıyla doldurmak için bu özelliği kullanır.
Bu sayfada desteklenen üç görüntüleme modu vardır: gözatma, 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ü 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, yalnızca sayfada bulunan bölge denetimi türleri göz önünde bulundurularak bir sayfada gerçekten kullanılabilir olan görüntüleme modlarını içerir.
Uyarı
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 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 ToolZone ilişkilendirilir. Özelliği tarafından 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 SupportedDisplayModes . Örneğin, web sayfası bir EditorZone bölge içeriyorsa ancak bölge içermiyorsa CatalogZone , görüntüleme modunu düzenleme bu sayfadaki desteklenen modlardan biridir, ancak katalog görüntüleme modu desteklenmez.
Uyarı
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.
