WebPartManager.SupportedDisplayModes Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft eine schreibgeschützte Auflistung aller Anzeigemodi ab, die auf einer bestimmten Webseite verfügbar sind.
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 WebPartDisplayModeCollectionEigenschaftswert
Eine WebPartDisplayModeCollection, die den Satz der auf einer bestimmten Webseite verfügbaren WebPartDisplayMode-Objekte enthält.
- Attribute
Beispiele
Im folgenden Codebeispiel wird die programmgesteuerte Verwendung der SupportedDisplayModes -Eigenschaft veranschaulicht. Der Code verwendet diese Eigenschaft, um die Liste nur mit den Anzeigemodi aufzufüllen, die auf der aktuellen Webseite verfügbar sind.
Auf dieser Seite werden drei Anzeigemodi unterstützt: Durchsuchen, Entwerfen und Bearbeiten. Die ersten beiden sind immer verfügbar, und der Bearbeitungsmodus ist in diesem Codebeispiel verfügbar, da die Seite ein EditorZone -Steuerelement enthält. Die Anzeigemodi "Katalog" und "Verbinden" werden nicht angezeigt, da sich die entsprechenden Zonen nicht auf dieser Seite befinden.
<%@ 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>
Nachdem Sie die Seite in einem Browser geladen haben, können Sie das Dropdownlistensteuerelement verwenden, um die Seite aus dem Suchmodus in den Entwurfsmodus und dann in den Bearbeitungsmodus zu wechseln. Im Bearbeitungsmodus können Sie in der Kopfzeile eines der Serversteuerelemente auf das Dropdownmenü Verben klicken und Bearbeiten auswählen, um das Steuerelement zu bearbeiten.
Hinweise
Die SupportedDisplayModes -Eigenschaft enthält nur die Anzeigemodi, die tatsächlich auf einer Seite verfügbar sind, vorausgesetzt, die Arten von Zonensteuerelementen, die auf der Seite vorhanden sind.
Hinweis
Anzeigemodi können deaktiviert werden, und wenn ein Anzeigemodus deaktiviert ist, wird er nicht zur SupportedDisplayModes Sammlung hinzugefügt, auch wenn der entsprechende Zonentyp, der diesen Anzeigemodus unterstützt, auf der Seite vorhanden ist.
Der Browsermodus und der Entwurfsmodus werden immer unterstützt. Die Anzeigemodi, die variieren können, sind die Bearbeitungs-, Katalog- und Verbindungsmodi. Jeder dieser Anzeigemodi ist einem bestimmten Steuerelementtyp ToolZone zugeordnet. Es ist das Vorhandensein dieser speziell typisierten Zone auf einer Webseite, die bewirkt, dass der Auflistung, auf die von der SupportedDisplayModes -Eigenschaft verwiesen wird, ein bestimmter Anzeigemodus hinzugefügt wird. Wenn eine Webseite beispielsweise eine EditorZone Zone, aber keine CatalogZone Zone enthält, ist der Anzeigemodus zum Bearbeiten einer der unterstützten Modi auf dieser Seite, aber der Kataloganzeigemodus wird nicht unterstützt.
Hinweis
Die SupportedDisplayModes -Eigenschaft unterscheidet sich von der DisplayModes -Eigenschaft, die auf eine Auflistung verweist, die alle Anzeigemodi enthält, die für das aktuelle WebPartManager Steuerelement verfügbar sind, auch solche, die auf einer bestimmten Seite nicht unterstützt werden.
