WebPartManager.CatalogDisplayMode Pole
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.
Reprezentuje tryb wyświetlania używany do dodawania kontrolek serwera z wykazu kontrolek do strony sieci Web. To pole jest tylko do odczytu.
public: static initonly System::Web::UI::WebControls::WebParts::WebPartDisplayMode ^ CatalogDisplayMode;public static readonly System.Web.UI.WebControls.WebParts.WebPartDisplayMode CatalogDisplayMode; staticval mutable CatalogDisplayMode : System.Web.UI.WebControls.WebParts.WebPartDisplayModePublic Shared ReadOnly CatalogDisplayMode As WebPartDisplayMode Wartość pola
Przykłady
Poniższy przykład kodu pokazuje, jak programowo pracować z polem CatalogDisplayMode . Kod wypełnia listę rozwijaną z obsługiwanymi trybami wyświetlania dla strony, które w tym przypadku są przeglądania, projektowania i wykazu. Tryb wykazu jest dostępny ze względu na <asp:CatalogZone> element i jego elementy podrzędne na stronie sieci Web. Zwróć uwagę, że w metodzie Page_PreRender kod sprawdza, czy bieżąca DisplayMode właściwość ma wartość CatalogDisplayMode. Jeśli tak, Label1 będzie widoczna, a jeśli nie, Label1 będzie ukryta.
<%@ 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;
}
protected void Page_PreRender(object sender, EventArgs e)
{
if (mgr.DisplayMode == WebPartManager.CatalogDisplayMode)
Label1.Visible = true;
else
Label1.Visible = false;
}
</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: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:WebPartZone ID="WebPartZone2" runat="server" />
<asp:CatalogZone ID="CatalogZone1" runat="server">
<ZoneTemplate>
<asp:DeclarativeCatalogPart
ID="DeclarativeCatalogPart1"
runat="server">
<WebPartsTemplate>
<asp:Calendar ID="Calendar1" runat="server"
Title="My Calendar" />
</WebPartsTemplate>
</asp:DeclarativeCatalogPart>
</ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:Label ID="Label1" runat="server"
Text="Currently in Catalog Mode"
Font-Bold="true"
Font-Size="125%" />
<br />
<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
Protected Sub Page_PreRender(ByVal sender As Object, _
ByVal e As System.EventArgs)
If mgr.DisplayMode.Equals(WebPartManager.CatalogDisplayMode) Then
Label1.Visible = True
Else
Label1.Visible = False
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" 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: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:WebPartZone ID="WebPartZone2" runat="server" />
<asp:CatalogZone ID="CatalogZone1" runat="server">
<ZoneTemplate>
<asp:DeclarativeCatalogPart
ID="DeclarativeCatalogPart1"
runat="server">
<WebPartsTemplate>
<asp:Calendar ID="Calendar1" runat="server"
Title="My Calendar" />
</WebPartsTemplate>
</asp:DeclarativeCatalogPart>
</ZoneTemplate>
</asp:CatalogZone>
<hr />
<asp:Label ID="Label1" runat="server"
Text="Currently in Catalog Mode"
Font-Bold="true"
Font-Size="125%" />
<br />
<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 domyślnie jesteś w trybie przeglądania. Zwróć uwagę, że etykieta na stronie jest ukryta. Użyj kontrolki listy rozwijanej, aby przełączyć stronę do trybu wykazu. Zwróć uwagę, że ze względu na kod w metodzie Page_PreRender etykieta jest teraz widoczna. Możesz wybrać kontrolkę w katalogu i dodać ją do jednej z dwóch stref na stronie.
Uwagi
Pole CatalogDisplayMode odwołuje się do obiektu niestandardowego WebPartDisplayMode , który jest tworzony i zawarty przez kontrolkę WebPartManager . Ponieważ jest to obiekt statyczny, można odwoływać się do niego bezpośrednio za pośrednictwem WebPartManager klasy bez konieczności używania wystąpienia kontrolki.
Gdy użytkownicy chcą dodać kontrolki do strony, jeśli jest dostępny wykaz kontrolek serwera, mogą przełączyć stronę na CatalogDisplayMode (tryb wykazu), a interfejs użytkownika wykazu zostanie wyświetlony. Interfejs użytkownika wykazu składników Web Part jest dostarczany przez kontrolkę CatalogZoneBase strefy. Deweloperzy dodają tę strefę do strony w czasie projektowania, a następnie dodają kontrolki serwera do strefy, aby użytkownicy mogli dodawać te kontrolki do swoich stron w czasie wykonywania. Po dodaniu tych kontrolek przez dewelopera tryb wykazu staje się obsługiwanym trybem wyświetlania na stronie, ponieważ niezbędne kontrolki są dostępne do włączenia trybu wykazu.
Gdy użytkownik przełącza stronę do trybu wykazu, strefa i wszystkie dodane do niego kontrolki serwera stają się widoczne, a użytkownik może wybrać kontrolki z wykazu, aby dodać do strony lub usunąć kontrolki ze strony. Po dodaniu kontrolek do strony są one wyświetlane w normalnym trybie przeglądania i aktualizowaniu strony.
