WebPartManager.SupportedDisplayModes Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera kolekcję tylko do odczytu wszystkich trybów wyświetlania, które są dostępne na określonej stronie sieci Web.
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 WebPartDisplayModeCollectionWartość właściwości
Element WebPartDisplayModeCollection zawierający zestaw WebPartDisplayMode obiektów dostępnych na określonej stronie sieci Web.
- Atrybuty
Przykłady
Poniższy przykład kodu przedstawia programowe użycie SupportedDisplayModes właściwości. Kod używa tej właściwości do wypełnienia listy tylko trybami wyświetlania dostępnymi na bieżącej stronie sieci Web.
Na tej stronie są dostępne trzy obsługiwane tryby wyświetlania: przeglądanie, projektowanie i edytowanie. Pierwsze dwa są zawsze dostępne, a tryb edycji jest dostępny w tym przykładzie kodu, ponieważ strona zawiera kontrolkę EditorZone . Tryby wyświetlania wykazu i łączenia nie są wyświetlane, ponieważ ich odpowiednie strefy nie znajdują się na tej stronie.
<%@ 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 załadowaniu strony w przeglądarce możesz użyć kontrolki listy rozwijanej, aby przełączyć stronę z trybu przeglądania na tryb projektowania, a następnie edytować tryb. W trybie edycji możesz kliknąć menu zleceń rozwijanych w nagłówku jednej z kontrolek serwera, a następnie wybrać pozycję Edytuj , aby edytować kontrolkę.
Uwagi
Właściwość SupportedDisplayModes zawiera tylko tryby wyświetlania, które są rzeczywiście dostępne na stronie, biorąc pod uwagę rodzaje kontrolek stref znajdujących się na stronie.
Uwaga
Tryby wyświetlania można wyłączyć, a gdy tryb wyświetlania jest wyłączony, nie jest dodawany do SupportedDisplayModes kolekcji, nawet jeśli odpowiedni typ strefy obsługującej ten tryb wyświetlania jest obecny na stronie.
Tryb przeglądania i tryb projektowania są zawsze obsługiwane. Tryby wyświetlania, które mogą się różnić, to tryby edycji, katalogu i łączenia. Każdy z tych trybów wyświetlania jest skojarzony z określonym typem kontrolki ToolZone . Jest to obecność tej specjalnie typizowanej strefy na stronie sieci Web, która powoduje dodanie określonego trybu wyświetlania do kolekcji przywoływanych przez SupportedDisplayModes właściwość. Jeśli na przykład strona sieci Web zawiera strefę EditorZone , ale nie strefę CatalogZone , tryb wyświetlania edycji jest jednym z obsługiwanych trybów na tej stronie, ale tryb wyświetlania wykazu nie jest obsługiwany.
Uwaga
Właściwość SupportedDisplayModes różni się od DisplayModes właściwości, która odwołuje się do kolekcji zawierającej wszystkie tryby wyświetlania dostępne dla bieżącej WebPartManager kontrolki, nawet te, które nie są obsługiwane na określonej stronie.
