閱讀英文

共用方式為

WebPartExportMode 列舉

  • 參考

定義

命名空間:
System.Web.UI.WebControls.WebParts
組件:
System.Web.dll

指定匯出 WebPart 控制項的全部、一些屬性，或全部都不匯出。

C# 
public enum WebPartExportMode
繼承
Object
ValueType
Enum
WebPartExportMode

欄位

名稱 值 Description
All 1

Web 組件控制項的所有屬性都可以匯出。
None 0

Web 組件控制項的任何屬性都不可匯出。
NonSensitiveData 2

只有定義為非敏感性之 Web 組件控制項的屬性才能匯出。

範例

下列範例示範 如何使用 WebPart.ExportMode 屬性。 Note that for the export code example to work, you must also update your Web.config file, as indicated in the Remarks section.

此範例的第一個部分包含名為 TextDisplayWebPart之控件的程序代碼。 這個控件與類別的 Examples 區段中 找到的 WebPart 自定義控件相同，不同之處在於它會將 加入 PersonalizableAttribute 至 TextDisplayWebPart.ContentText 屬性，以便匯出屬性。 請注意，屬性宣告包含 參數的值trueisSensitive，這表示屬性標示為敏感數據以供匯出之用。 若要執行程式碼範例，您必須編譯此原始程式碼。 您可以明確地編譯它，並將產生的元件放在網站的 Bin 資料夾或全域程式集緩存中。 或者，您可以將原始程式碼放在月臺的 App_Code資料夾中，其將在運行時間動態編譯。 此程式代碼範例假設您將原始程式碼編譯成元件、將它放在 Web 應用程式的 Bin 子資料夾中，並在網頁中使用 指示詞參考元件 Register 。 如需示範這兩種編譯方法的逐步解說，請參閱逐步解說 ：開發和使用自定義 Web 伺服器控制件。

C# 
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 (!string.IsNullOrEmpty(input.Text))
      {
        _contentText = input.Text + @"<br />";
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }
  }
}

範例的第二個部分示範如何參考 TextDisplayWebPart ASP.NET 網頁中的 控件。 請注意，在宣告式標記中 ExportMode ，屬性值會設定為All，這表示會匯出具有敏感性值的偶數屬性。

ASP.NET (C#) 
<%@ page language="C#" %>
<%@ register tagprefix="aspSample" 
             Namespace="Samples.AspNet.CS.Controls" 
             Assembly="TextDisplayWebPartCS"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<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">
    <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>

在瀏覽器中載入網頁，然後在控件的 ExportMode 動詞功能表上，單擊匯出動詞，並遵循指示導出包含控制項狀態和屬性數據的描述檔。

備註

列舉中的值 WebPartExportMode 可以套用至 屬性， WebPart.ExportMode 以指定可從 Web 元件控制件匯出哪些屬性。 根據預設，控制項的屬性 WebPart 無法匯出，而且控制件的 ExportMode 屬性會設定為 None。 若要啟用匯出控制項的所有屬性，將ExportMode值All。 若要在防止匯出包含敏感資料的屬性時只匯出特定屬性，請將 屬性值設定為 NonSensitiveData。

屬性可以透過 PersonalizableAttribute 屬性標示為敏感性。

注意

若要為包含 Web 元件控制元件的 Web 應用程式啟用匯出功能，請在應用程式的 Web.config 檔案中，將屬性新增至 <webParts> 區段中的 元素 <system.web> ，如下列標記所示：

XML 
<webParts enableExport="true">
</webParts>

適用於

產品 版本
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

另請參閱