WebPartManager.SupportedDisplayModes Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá jen čtení kolekce všechny režimy zobrazení, které jsou k dispozici na konkrétní webové stránce.
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 WebPartDisplayModeCollectionHodnota vlastnosti
A WebPartDisplayModeCollection obsahující sadu WebPartDisplayMode objektů, které jsou k dispozici na konkrétní webové stránce.
- Atributy
Příklady
Následující příklad kódu ukazuje programové použití SupportedDisplayModes vlastnosti . Kód používá tuto vlastnost k naplnění seznamu pouze režimy zobrazení dostupné na aktuální webové stránce.
Na této stránce jsou podporované tři režimy zobrazení: procházení, návrh a úpravy. První dva jsou vždy k dispozici a režim úprav je k dispozici v tomto příkladu kódu, protože stránka obsahuje ovládací prvek EditorZone . Katalog a režimy zobrazení připojení nejsou zobrazeny, protože jejich odpovídající zóny nejsou na této stránce.
<%@ 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>
Po načtení stránky v prohlížeči můžete pomocí ovládacího prvku rozevíracího seznamu přepnout stránku z režimu procházení do režimu návrhu a pak do režimu úprav. V režimu úprav můžete kliknout na rozevírací nabídku sloves v záhlaví jednoho ze serverových ovládacích prvků a vybrat Upravit a ovládací prvek upravit.
Poznámky
Vlastnost SupportedDisplayModes obsahuje pouze režimy zobrazení, které jsou skutečně k dispozici na stránce vzhledem k druhům ovládacích prvků zóny na stránce.
Poznámka
Režimy zobrazení mohou být zakázány, a pokud je režim zobrazení zakázán, není přidán do SupportedDisplayModes kolekce, i když je na stránce odpovídající typ zóny, která podporuje tento režim zobrazení.
Režim procházení a režim návrhu jsou vždy podporovány. Režimy zobrazení, které se můžou lišit, jsou režimy úprav, katalogu a připojení. Každý z těchto režimů zobrazení je přidružen ke konkrétnímu typu ToolZone ovládacího prvku. Je to přítomnost této speciálně typované zóny na webové stránce, která způsobuje, že určitý režim zobrazení bude přidán do kolekce, na kterou SupportedDisplayModes odkazuje vlastnost. Pokud například webová stránka obsahuje zónu EditorZone , ale ne zónu CatalogZone , je režim zobrazení úprav jedním z podporovaných režimů na této stránce, ale režim zobrazení katalogu není podporován.
Poznámka
Vlastnost SupportedDisplayModes se liší od DisplayModes vlastnosti , která odkazuje na kolekci obsahující všechny režimy zobrazení, které jsou k dispozici pro aktuální WebPartManager ovládací prvek, i ty, které nejsou na konkrétní stránce podporovány.
