WebPartManager.SupportedDisplayModes Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u een verzameling alleen-lezen op van alle weergavemodi die beschikbaar zijn op een bepaalde webpagina.
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 WebPartDisplayModeCollectionWaarde van eigenschap
Een WebPartDisplayModeCollection met de set WebPartDisplayMode objecten die beschikbaar zijn op een specifieke webpagina.
- Kenmerken
Voorbeelden
In het volgende codevoorbeeld ziet u het programmatische gebruik van de SupportedDisplayModes eigenschap. De code gebruikt deze eigenschap om de lijst te vullen met alleen de weergavemodi die beschikbaar zijn op de huidige webpagina.
Er zijn drie ondersteunde weergavemodi op deze pagina: bladeren, ontwerpen en bewerken. De eerste twee zijn altijd beschikbaar en de bewerkingsmodus is beschikbaar in dit codevoorbeeld omdat de pagina een EditorZone besturingselement bevat. De weergavemodi catalogus en verbinding maken worden niet weergegeven, omdat de bijbehorende zones zich niet op deze pagina bevinden.
<%@ 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>
Nadat u de pagina in een browser hebt geladen, kunt u het besturingselement voor de vervolgkeuzelijst gebruiken om de pagina over te schakelen van de bladermodus naar de ontwerpmodus en vervolgens om de bewerkingsmodus te bewerken. In de bewerkingsmodus kunt u in de koptekst van een van de serverbesturingselementen op de vervolgkeuzelijst klikken en Bewerken selecteren om het besturingselement te bewerken.
Opmerkingen
De SupportedDisplayModes eigenschap bevat alleen de weergavemodi die daadwerkelijk beschikbaar zijn op een pagina, gezien de soorten zonebesturingselementen die aanwezig zijn op de pagina.
Note
Weergavemodi kunnen worden uitgeschakeld en wanneer een weergavemodus is uitgeschakeld, wordt deze niet toegevoegd aan de SupportedDisplayModes verzameling, zelfs niet wanneer het bijbehorende type zone dat ondersteuning biedt voor de weergavemodus aanwezig is op de pagina.
Bladermodus en ontwerpmodus worden altijd ondersteund. De weergavemodi die kunnen variëren, zijn de bewerkings-, catalogus- en verbindingsmodi. Elk van deze weergavemodi is gekoppeld aan een bepaald type ToolZone besturingselement. Het is de aanwezigheid van die speciaal getypte zone op een webpagina die ervoor zorgt dat een bepaalde weergavemodus wordt toegevoegd aan de verzameling waarnaar wordt verwezen door de SupportedDisplayModes eigenschap. Als een webpagina bijvoorbeeld een EditorZone zone bevat maar geen CatalogZone zone, is de bewerkingsweergavemodus een van de ondersteunde modi op die pagina, maar wordt de catalogusweergavemodus niet ondersteund.
Note
De SupportedDisplayModes eigenschap verschilt van de DisplayModes eigenschap, die verwijst naar een verzameling met alle weergavemodi die beschikbaar zijn voor het huidige WebPartManager besturingselement, zelfs naar de weergavemodi die niet worden ondersteund op een bepaalde pagina.