WebPart.ExportMode Property
Assembly: System.Web (in system.web.dll)
[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)
Property Value
One of the WebPartExportMode values. The default is None.| Exception type | Condition |
|---|---|
| The value specified is not one of the WebPartExportMode values. | |
| The control is already loaded and the personalization scope of the control is set to the User scope. |
By default, a WebPart control cannot be exported and its ExportMode property is set to None. To enable exporting all properties for the control, set the ExportMode value to All. To export only certain properties while preventing the export of properties that contain sensitive data, you set the property value to NonSensitiveData.
To export property value descriptions for a WebPart control, the properties must also be marked with the Personalizable attribute in the metadata for the property's source code. For details, see PersonalizableAttribute.
Note |
|---|
| To enable the export feature for a Web application that includes Web Parts controls, in the Web.config file for your application, you must add an attribute to the <webParts> element within the <system.web> section, as in the following markup. <webParts enableExport="true"> </webParts> |
This property cannot be set by themes or style sheet themes. For more information, see ThemeableAttribute and ASP.NET Themes and Skins Overview.
The personalization scope of this property is set to Shared and can be modified only by authorized users. For more information, see PersonalizableAttribute and Web Parts Personalization Overview.
| Topic | Location |
|---|---|
| How to: Export Web Parts Control Settings | Building ASP .NET Web Applications |
| How to: Export Web Parts Control Settings | Building ASP .NET Web Applications |
The following code example demonstrates the use of the ExportMode property. Note that for the export code example to work, you must also update your Web.config file by adding the attribute enableExport="true" to the <webParts> element, as indicated in the Remarks section.
The first part of this example contains the code for a control named TextDisplayWebPart. This control is the same as the custom control that is found in the Example section of the WebPart class overview, except that it adds a Personalizable attribute to the TextDisplayWebPart.ContentText property so the property can be exported. Note that the attribute declaration includes a value of true for the isSensitive parameter, meaning that the property is marked as sensitive data for export purposes. For the code example to run, you must compile this source code. You can compile it explicitly and put the resulting assembly in your Web site's Bin folder or the global assembly cache. Alternatively, you can put the source code in your site's App_Code folder, where it will be dynamically compiled at run time. This code example assumes that you compile the source code into an assembly, place it in a Bin subfolder of your Web application, and reference the assembly with a Register directive in your Web page. For a walkthrough that demonstrates both methods of compiling, see Walkthrough: Developing and Using a Custom Server Control.
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
The second part of the example shows how to reference the TextDisplayWebPart control in an ASP.NET Web page. Note that in the declarative markup, the ExportMode property value is set to All, meaning that even properties with sensitive values will be exported.
<%@ 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>
Load the Web page in a browser, and on the verbs menu of the WebPart control, click the export verb and follow the instructions to export a description file containing the control's state and property data.
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
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.
Note