WebPart.ExportMode プロパティ
アセンブリ: System.Web (system.web.dll 内)
構文Dim instance As WebPart Dim value As WebPartExportMode value = instance.ExportMode instance.ExportMode = value
[ThemeableAttribute(false)] public: virtual property WebPartExportMode ExportMode { WebPartExportMode get (); void set (WebPartExportMode value); }
/** @property */ public WebPartExportMode get_ExportMode () /** @property */ public void set_ExportMode (WebPartExportMode value)
public function get ExportMode () : WebPartExportMode public function set ExportMode (value : WebPartExportMode)
WebPartExportMode 値の 1 つ。既定値は None です。
例外解説既定では、WebPart コントロールをエクスポートすることはできません。また、その ExportMode プロパティは None に設定されています。コントロールのすべてのプロパティのエクスポートを有効にするには、ExportMode 値を All に設定します。重要情報を含むプロパティをエクスポートできないようにし、一方で特定のプロパティだけをエクスポートするには、プロパティ値を NonSensitiveData に設定します。
WebPart コントロールのプロパティ値の記述をエクスポートするには、プロパティのソース コードのメタデータで、プロパティが Personalizable 属性でマークされている必要があります。詳細については、「PersonalizableAttribute」を参照してください。
.gif) メモ |
|---|
| Web パーツ コントロールを含む Web アプリケーションでエクスポート機能を有効にするには、各自のアプリケーションの Web.config ファイルで、次のマークアップのように、<system.web> セクション内の <webParts> 要素に属性を追加する必要があります。 <webParts enableExport="true"> </webParts> |
このプロパティを、テーマまたはスタイル シート テーマを使用して設定することはできません。詳細については、ThemeableAttribute、ASP.NET のテーマとスキンの概要 の各トピックを参照してください。
このプロパティのパーソナル化スコープは Shared に設定され、承認されたユーザーだけが変更できます。詳細については、PersonalizableAttribute、Web パーツのパーソナル化の概要 の各トピックを参照してください。
使用例ExportMode プロパティの使用方法を示すコード例を次に示します。エクスポートのコード例が正常に処理されるためには、「解説」セクションに示されているように、<webParts> 要素に属性 enableExport="true" を追加して Web.config ファイルを更新することも必要です。
この例の最初の部分には、TextDisplayWebPart という名前のコントロールのコードが含まれています。このコントロールは、Personalizable 属性を TextDisplayWebPart.ContentText プロパティに追加してそのプロパティをエクスポートできるようにしていることを除いて、WebPart クラスの概要の「使用例」にあるカスタム コントロールと同じです。属性宣言には、isSensitive パラメータの値 true が含まれます。これは、そのプロパティがエクスポートにおいて重要情報としてマークされていることを意味します。コード例を実行するためには、このソース コードをコンパイルする必要があります。それを明示的にコンパイルし、コンパイル済みのアセンブリを Web サイトの Bin フォルダまたはグローバル アセンブリ キャッシュに配置できます。サイトの App_Code フォルダにソース コードを配置し、実行時に動的にコンパイルすることもできます。このコード例は、ソース コードをアセンブリにコンパイルし、それを各自の Web アプリケーションの Bin サブフォルダに配置し、アセンブリを各自の Web ページの Register ディレクティブで参照することを前提にしています。両方のコンパイル方法を示すチュートリアルについては、「チュートリアル : カスタム サーバー コントロールの開発と使用」を参照してください。
Imports System Imports System.Security.Permissions Imports System.Web Imports System.Web.UI.WebControls Imports System.Web.UI.WebControls.WebParts Namespace Samples.AspNet.VB.Controls <AspNetHostingPermission(SecurityAction.Demand, _ Level := AspNetHostingPermissionLevel.Minimal)> _ <AspNetHostingPermission(SecurityAction.InheritanceDemand, _ Level := AspNetHostingPermissionLevel.Minimal)> _ Public Class TextDisplayWebPart Inherits WebPart Private _contentText As String = Nothing Private input As TextBox Private DisplayContent As Label Private Const _subTitle as String = "Contoso, Ltd" Public Sub New() Me.AllowClose = False End Sub <Personalizable(PersonalizationScope.User, True), _ WebBrowsable()> _ Public Property ContentText() As String Get Return _contentText End Get Set _contentText = value End Set End Property Protected Overrides Sub CreateChildControls() Controls.Clear() DisplayContent = New Label() DisplayContent.Text = Me.ContentText DisplayContent.BackColor = _ System.Drawing.Color.LightBlue Me.Controls.Add(DisplayContent) input = New TextBox() Me.Controls.Add(input) Dim update As New Button() update.Text = "Set Label Content" AddHandler update.Click, AddressOf Me.submit_Click Me.Controls.Add(update) ChildControlsCreated = True End Sub Private Sub submit_Click(ByVal sender As Object, _ ByVal e As EventArgs) ' Update the label string. If input.Text <> String.Empty Then _contentText = input.Text & "<br />" input.Text = String.Empty DisplayContent.Text = Me.ContentText End If End Sub End Class End Namespace
using System; using System.Security.Permissions; using System.Web; using System.Web.UI.WebControls; using System.Web.UI.WebControls.WebParts; namespace Samples.AspNet.CS.Controls { [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)] [AspNetHostingPermission(SecurityAction.InheritanceDemand, Level=AspNetHostingPermissionLevel.Minimal)] public class TextDisplayWebPart : WebPart { private String _contentText = null; TextBox input; Label DisplayContent; const string _subTitle = "Contoso, Ltd"; public TextDisplayWebPart() { this.AllowClose = false; } [ Personalizable(PersonalizationScope.User, true), WebBrowsable() ] public String ContentText { get { return _contentText; } set { _contentText = value; } } protected override void CreateChildControls() { Controls.Clear(); DisplayContent = new Label(); DisplayContent.BackColor = System.Drawing.Color.LightBlue; DisplayContent.Text = this.ContentText; this.Controls.Add(DisplayContent); input = new TextBox(); this.Controls.Add(input); Button update = new Button(); update.Text = "Set Label Content"; update.Click += new EventHandler(this.submit_Click); this.Controls.Add(update); ChildControlsCreated = true; } private void submit_Click(object sender, EventArgs e) { // Update the label string. if (input.Text != String.Empty) { _contentText = input.Text + @"<br />"; input.Text = String.Empty; DisplayContent.Text = this.ContentText; } } } }
package Samples.AspNet.JSL.Controls; import System.*; import System.Security.Permissions.*; import System.Web.*; import System.Web.UI.WebControls.*; import System.Web.UI.WebControls.WebParts.*; /** @attribute AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal) */ /** @attribute AspNetHostingPermission(SecurityAction.InheritanceDemand, Level = AspNetHostingPermissionLevel.Minimal) */ public class TextDisplayWebPart extends WebPart { private String _contentText = null; private TextBox input; private Label displayContent; private String _subTitle = "Contoso, Ltd"; public TextDisplayWebPart() { this.set_AllowClose(false); } //TextDisplayWebPart /** @attribute Personalizable(PersonalizationScope.User, true) @attribute WebBrowsable() */ /** @property */ public String get_ContentText() { return _contentText; } //get_ContentText /** @property */ public void set_ContentText(String value) { _contentText = value; } //set_ContentText protected void CreateChildControls() { get_Controls().Clear(); displayContent = new Label(); displayContent.set_BackColor(System.Drawing.Color.get_LightBlue()); displayContent.set_Text(this.get_ContentText()); this.get_Controls().Add(displayContent); input = new TextBox(); this.get_Controls().Add(input); Button update = new Button(); update.set_Text("Set Label Content"); update.add_Click(new EventHandler(this.Submit_Click)); this.get_Controls().Add(update); set_ChildControlsCreated(true); } //CreateChildControls private void Submit_Click(Object sender, EventArgs e) { // Update the label string. if (!(input.get_Text().Equals(""))) { _contentText = input.get_Text() + "<br />"; input.set_Text(""); displayContent.set_Text(this.get_ContentText()); } } //Submit_Click } //TextDisplayWebPart
この例の 2 番目の部分は、ASP.NET Web ページで TextDisplayWebPart コントロールを参照する方法を示しています。宣言マークアップで、ExportMode プロパティ値が All に設定されます。つまり、機密の値を持つプロパティであってもエクスポートされます。
<%@ page language="VB" %> <%@ register tagprefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="TextDisplayWebPartVB"%> <html> <head id="Head1" runat="server"> </head> <body> <form id="Form1" runat="server"> <asp:webpartmanager id="WebPartManager1" runat="server" /> <asp:webpartzone id="WebPartZone1" runat="server" title="Zone 1" PartChromeType="TitleAndBorder"> <parttitlestyle font-bold="true" ForeColor="#3300cc" /> <partstyle borderwidth="1px" borderstyle="Solid" bordercolor="#81AAF2" /> <zonetemplate> <aspSample:TextDisplayWebPart runat="server" id="textwebpart" title = "Text WebPart" ExportMode="All" /> </zonetemplate> </asp:webpartzone> <br /> </form> </body> </html>
<%@ page language="C#" %> <%@ register tagprefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="TextDisplayWebPartCS"%> <html> <head id="Head1" runat="server"> </head> <body> <form id="Form1" runat="server"> <asp:webpartmanager id="WebPartManager1" runat="server" /> <asp:webpartzone id="WebPartZone1" runat="server" title="Zone 1" PartChromeType="TitleAndBorder"> <parttitlestyle font-bold="true" ForeColor="#3300cc" /> <partstyle borderwidth="1px" borderstyle="Solid" bordercolor="#81AAF2" /> <zonetemplate> <aspSample:TextDisplayWebPart runat="server" id="textwebpart" title = "Text WebPart" ExportMode="All" /> </zonetemplate> </asp:webpartzone> <br /> </form> </body> </html>
<%@ page language="VJ#" %> <%@ register tagprefix="aspSample" Namespace="Samples.AspNet.JSL.Controls" Assembly="TextDisplayWebPartJSL"%> <html> <head id="Head1" runat="server"> </head> <body> <form id="Form1" runat="server"> <asp:webpartmanager id="WebPartManager1" runat="server" /> <asp:webpartzone id="WebPartZone1" runat="server" title="Zone 1" PartChromeType="TitleAndBorder"> <parttitlestyle font-bold="true" ForeColor="#3300cc" /> <partstyle borderwidth="1px" borderstyle="Solid" bordercolor="#81AAF2" /> <zonetemplate> <aspSample:TextDisplayWebPart runat="server" id="textwebpart" title = "Text WebPart" ExportMode="All" /> </zonetemplate> </asp:webpartzone> <br /> </form> </body> </html>
ブラウザに Web ページを読み込み、WebPart コントロールの動詞メニューで、export 動詞をクリックし、指示に従ってコントロールの状態およびプロパティ データを含む記述ファイルをエクスポートします。
プラットフォーム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に収録されているすべての辞書からWebPart.ExportMode プロパティを検索する場合は、下記のリンクをクリックしてください。
全ての辞書からWebPart.ExportMode プロパティ
を検索
- WebPart.ExportMode プロパティのページへのリンク
