WebPartManager.CatalogDisplayMode フィールド
アセンブリ: System.Web (system.web.dll 内)
構文解説CatalogDisplayMode フィールドは、WebPartManager コントロールによって作成され格納された、カスタム WebPartDisplayMode オブジェクトを参照します。これは静的オブジェクトであるため、このコントロールのインスタンスがなくても、WebPartManager クラスを通じて直接このオブジェクトを参照できます。
ユーザーがコントロールをページに追加するときに、サーバー コントロールのカタログを使用できる場合、ページを CatalogDisplayMode (カタログ モード) に切り替えると、カタログ ユーザー インターフェイス (UI) が表示されます。Web パーツ カタログの UI は、CatalogZoneBase ゾーン コントロールによって提供されます。開発者が、デザイン時にこのゾーンをページに追加し、次に、サーバー コントロールをこのゾーンに追加すると、ユーザーは実行時にこれらのコントロールをそのページに追加できるようになります。開発者がこれらのコントロールを追加すると、必要なコントロールが用意されてカタログ モードが有効になるため、カタログ モードがページ上でサポートされる表示モードになります。
ユーザーがページをカタログ モードに切り替えると、それに追加されたゾーンとすべてのサーバー コントロールが表示されるようになり、ユーザーはカタログからコントロールを選択してページに追加したり、ページからコントロールを削除したりできます。コントロールをページに追加した後、コントロールは通常のブラウズ モードに表示され、ページが更新されます。
使用例プログラムを使用した CatalogDisplayMode フィールドの操作方法を次のコード例に示します。このコードは、ページでサポートされる表示モード (ここでは、ブラウズ モード、デザイン モード、およびカタログ モード) を含むドロップダウン リストを生成します。カタログ モードは、Web ページに <asp:CatalogZone> 要素およびその子要素があるため使用できます。Page_PreRender メソッドで、コードは現在の DisplayMode プロパティが CatalogDisplayMode に設定されているかどうかをチェックします。設定されている場合は Label1 が表示され、設定されていない場合は Label1 が非表示になります。
<%@ Page Language="VB" %> <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 > <head id="Head1" runat="server"> </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="C#" %> <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 > <head runat="server"> </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_PreRender メソッドのコードに従って、ここではラベルが表示されます。カタログのコントロールを選択して、ページ上の 2 つのゾーンのいずれかに追加できます。
プラットフォームWindows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照Weblioに収録されているすべての辞書からWebPartManager.CatalogDisplayMode フィールドを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からWebPartManager.CatalogDisplayMode フィールド
を検索
- WebPartManager.CatalogDisplayMode フィールドのページへのリンク
