WebPartExportMode Перечисление

Определение

Пространство имен:

System.Web.UI.WebControls.WebParts

Сборка:

System.Web.dll

Указывает, сколько свойств элемента управления WebPart можно экспортировать — все, только некоторые или ни одного.

C#

public enum WebPartExportMode

Наследование

Object

ValueType

Enum

WebPartExportMode

Поля

Имя	Значение	Описание
All	1	Можно экспортировать все свойства элемента управления веб-частей.
None	0	Никакие свойства элемента управления веб-частей не могут быть экспортированы.
NonSensitiveData	2	Можно экспортировать только те свойства элемента управления веб-частей, которые были заданы как неконфиденциальные.

Примеры

В следующем примере показано использование WebPart.ExportMode свойства . Обратите внимание, что для работы примера кода экспорта необходимо также обновить файл Web.config, как указано в разделе Примечания .

Первая часть этого примера содержит код для элемента управления с именем TextDisplayWebPart. Этот элемент управления совпадает с пользовательским элементом управления, который находится в разделе WebPartПримеры класса, за исключением того, что он добавляет PersonalizableAttribute в TextDisplayWebPart.ContentText свойство , чтобы свойство можно было экспортировать. Обратите внимание, что объявление атрибута true содержит значение для isSensitive параметра , то есть свойство помечается как конфиденциальные данные в целях экспорта. Чтобы выполнить пример кода, необходимо скомпилировать этот исходный код. Вы можете скомпилировать его явным образом и поместить полученную сборку в папку Bin веб-сайта или глобальный кэш сборок. Кроме того, исходный код можно поместить в папку App_Code сайта, где он будет динамически компилироваться во время выполнения. В этом примере кода предполагается, что исходный код компилируется в сборку, помещаете его во вложенную папку Bin веб-приложения и ссылаетесь на сборку Register с помощью директивы на веб-странице. Пошаговое руководство, демонстрирующее оба метода компиляции, см. в разделе Пошаговое руководство. Разработка и использование пользовательского серверного веб-элемента управления.

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 , чтобы указать, какие свойства из элемента управления веб-частей можно экспортировать. По умолчанию свойства WebPart элемента управления не могут быть экспортированы, а свойству элемента управления ExportMode присваивается значение None. Чтобы включить экспорт всех свойств элемента управления, задайте ExportMode значение All. Чтобы экспортировать только определенные свойства и запретить экспорт свойств, содержащих конфиденциальные данные, задайте для свойства значение NonSensitiveData.

Свойство можно пометить как конфиденциальное с помощью атрибута PersonalizableAttribute .

Примечание

Чтобы включить функцию экспорта для веб-приложения, включающего элементы управления веб-частей, в файл Web.config приложения необходимо добавить атрибут <webParts> в элемент в <system.web> разделе, как показано в следующей разметке:

XML

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

Применяется к

См. также раздел

• PersonalizableAttribute
• ImportCatalogPart
• элементы управления веб-частей ASP.NET