WebPartManager.DisplayModes 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 einem WebPartManager-Steuerelement zugeordnet sind.
public:
property System::Web::UI::WebControls::WebParts::WebPartDisplayModeCollection ^ DisplayModes { System::Web::UI::WebControls::WebParts::WebPartDisplayModeCollection ^ get(); };[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.WebParts.WebPartDisplayModeCollection DisplayModes { get; }[<System.ComponentModel.Browsable(false)>]
member this.DisplayModes : System.Web.UI.WebControls.WebParts.WebPartDisplayModeCollectionPublic ReadOnly Property DisplayModes As WebPartDisplayModeCollectionEigenschaftswert
Eine WebPartDisplayModeCollection, die den Satz der dem WebPartDisplayMode-Steuerelement zugeordneten WebPartManager-Objekte enthält.
- Attribute
Beispiele
Im folgenden Codebeispiel wird die programmgesteuerte Verwendung der DisplayModes -Eigenschaft veranschaulicht. Der Code verwendet diese Eigenschaft, um die Liste mit allen Anzeigemodi aufzufüllen, die im Webparts-Steuerelementsatz verfügbar sind, auch mit denen, die auf der aktuellen Seite nicht unterstützt werden. In diesem Fall werden die Anzeigemodi katalog und connect nicht unterstützt, da sich die entsprechenden erforderlichen Zonen nicht auf der Seite befinden.
Die anderen drei Anzeigemodi – Durchsuchen, Entwerfen und Bearbeiten – werden auf der Seite unterstützt. Der Bearbeitungsmodus wird unterstützt, da die Seite eine EditorZone Zone enthält, während die Browser- und Entwurfsmodi immer unterstützt werden.
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. Beachten Sie, dass bei Auswahl von Katalog oder Verbinden in der Dropdownliste eine Fehlerseite generiert wird.
<%@ 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.DisplayModes)
{
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.DisplayModes[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.DisplayModes
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.DisplayModes(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>
Hinweise
Die DisplayModes -Eigenschaft verweist auf alle zugeordneten Anzeigemodi, im Gegensatz zur SupportedDisplayModes -Eigenschaft, die nur auf die Anzeigemodi verweist, die auf der aktuellen Seite verfügbar (unterstützt) sind.
Zwei der bereitgestellten Anzeigemodi, Durchsuchen und Entwerfen, werden auf einer Seite immer unterstützt. Die anderen drei Anzeigemodi "Bearbeiten", "Katalog" und "Verbindungen" werden nur unterstützt, wenn eine Seite über den entsprechenden Zonentyp verfügt, der für die Funktionsweise eines bestimmten Anzeigemodus erforderlich ist. Wenn Ihre Seite beispielsweise keine Zone enthält EditorZone , würde der Anzeigemodus zum Bearbeiten in der Auflistung angezeigt, auf die von der DisplayModes -Eigenschaft verwiesen wird, aber nicht in der Auflistung, auf die von der SupportedDisplayModes -Eigenschaft verwiesen wird.
