WebPartManager.DisplayMode プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文Public Overridable Property DisplayMode As WebPartDisplayMode
Dim instance As WebPartManager Dim value As WebPartDisplayMode value = instance.DisplayMode instance.DisplayMode = value
public: virtual property WebPartDisplayMode^ DisplayMode { WebPartDisplayMode^ get (); void set (WebPartDisplayMode^ value); }
/** @property */ public WebPartDisplayMode get_DisplayMode () /** @property */ public void set_DisplayMode (WebPartDisplayMode value)
public function get DisplayMode () : WebPartDisplayMode public function set DisplayMode (value : WebPartDisplayMode)
ページの表示モードを決定する WebPartDisplayMode。
例外解説Web パーツ コントロールが含まれたページは、必ずいくつかの使用可能な表示モードの 1 つで表示されます。表示モードの詳細については、「Web パーツ ページの表示モード」を参照してください。
WebPartManager クラスは、Web ページの表示モードを作成します。WebPartManager コントロールは、WebPartDisplayMode 基本クラスを使用して、Web パーツ コントロールが含まれたページ上で使用できるいくつかの標準表示モード オブジェクトを作成します。これらの標準表示モードについては、WebPartDisplayMode クラスの概要を参照してください。
また、WebPartManager コントロールは、Web パーツ コントロールを使用するページの表示モードを管理します。WebPartManager コントロールは、DisplayMode プロパティを使用してページ上の現在の表示モードへの参照を保持します。また、DisplayMode プロパティを使用して、ページを別の表示モードに切り替えることもできます。Web パーツ コントロールを使用するページで表示モードを変更する方法の例については、「チュートリアル : Web パーツ ページでの表示モードの変更」を参照してください。
WebPartManager コントロールは、表示モードの管理の一部として、OnDisplayModeChanged メソッドや OnDisplayModeChanging メソッドなど、表示モードに関連するイベントおよびイベント ハンドラも提供します。これらのメソッドには、ページの動作をカスタマイズするしくみ、およびカスタム表示モードを追加するしくみも用意されています。
使用例DisplayMode プロパティのプログラムでの使用方法を示すコード例を次に示します。ブラウザにページを読み込んだ後、ページの末尾付近にあるボタンを使用して表示モードを切り替えることができます。既定では、読み込まれたページはブラウズ モードになります。デザイン モードに切り替えると、1 つのゾーンから別のゾーンにサーバー コントロールをドラッグしたり、1 つのゾーン内の 2 つのコントロールの配置を変更したりできます。編集モードに切り替えると、いずれかのサーバー コントロールのヘッダーにある動詞メニューをクリックし、[編集] を選択して、用意された編集ユーザー インターフェイス (UI) でコントロールを編集できます。
.gif) メモ |
|---|
| Web パーツ アプリケーションでは表示モードの切り替えを頻繁に行います。したがって、Web パーツ コントロールを含むすべてのページで表示モードの切り替えを行うことができるようにするために、一貫性があり再利用可能な方法を提供できます。表示モードを変更し、多くのページで再利用できるユーザー コントロールの例については、「チュートリアル : Web パーツ ページでの表示モードの変更」を参照してください。 |
<%@ Page Language="VB" %> <script runat="server"> Protected Sub Button1_Click(ByVal sender As Object, _ ByVal e As EventArgs) mgr.DisplayMode = WebPartManager.BrowseDisplayMode End Sub Protected Sub Button2_Click(ByVal sender As Object, _ ByVal e As EventArgs) mgr.DisplayMode = WebPartManager.DesignDisplayMode End Sub Protected Sub Button3_Click(ByVal sender As Object, _ ByVal e As EventArgs) mgr.DisplayMode = WebPartManager.EditDisplayMode End Sub </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: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:Button ID="Button1" runat="server" Text="Browse Mode" OnClick="Button1_Click" /> <br /> <asp:Button ID="Button2" runat="server" Text="Design Mode" OnClick="Button2_Click"/> <br /> <asp:Button ID="Button3" runat="server" Text="Edit Mode" OnClick="Button3_Click"/> </div> </form> </body> </html>
<%@ Page Language="C#" %> <script runat="server"> protected void Button1_Click(object sender, EventArgs e) { mgr.DisplayMode = WebPartManager.BrowseDisplayMode; } protected void Button2_Click(object sender, EventArgs e) { mgr.DisplayMode = WebPartManager.DesignDisplayMode; } protected void Button3_Click(object sender, EventArgs e) { mgr.DisplayMode = WebPartManager.EditDisplayMode; } </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: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:Button ID="Button1" runat="server" Text="Browse Mode" OnClick="Button1_Click" /> <br /> <asp:Button ID="Button2" runat="server" Text="Design Mode" OnClick="Button2_Click"/> <br /> <asp:Button ID="Button3" runat="server" Text="Edit Mode" OnClick="Button3_Click"/> </div> </form> </body> </html>
プラットフォーム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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照WebPartManager クラス
WebPartManager メンバ
System.Web.UI.WebControls.WebParts 名前空間
DisplayModes
CreateDisplayModes
その他の技術情報
ASP.NET Web パーツ ページ
Web パーツ ページの表示モード
チュートリアル : Web パーツ ページでの表示モードの変更
- WebPartManager.DisplayMode プロパティのページへのリンク
