Поделиться через


WebPartManager.ExportWebPart(WebPart, XmlWriter) Метод

Определение

Создает XML-файл описания, который содержит состояние и данные свойства для серверного элемента управления.

public:
 virtual void ExportWebPart(System::Web::UI::WebControls::WebParts::WebPart ^ webPart, System::Xml::XmlWriter ^ writer);
public virtual void ExportWebPart (System.Web.UI.WebControls.WebParts.WebPart webPart, System.Xml.XmlWriter writer);
abstract member ExportWebPart : System.Web.UI.WebControls.WebParts.WebPart * System.Xml.XmlWriter -> unit
override this.ExportWebPart : System.Web.UI.WebControls.WebParts.WebPart * System.Xml.XmlWriter -> unit
Public Overridable Sub ExportWebPart (webPart As WebPart, writer As XmlWriter)

Параметры

webPart
WebPart

Элемент управления, из которого будут экспортированы данные.

writer
XmlWriter

Средство записи XmlWriter, который записывает экспортированные из webPart данные в XML-файл описания.

Исключения

webPart имеет значение null.

-или-

writer имеет значение null.

webPart не содержится в коллекции элементов управления, на которую ссылается свойство Controls.

-или-

Значение свойства ExportMode, принадлежащее webPart, задано равным None, что означает отключение экспорта для webPart.

Комментарии

Метод ExportWebPart собирает различные данные о состоянии и свойствах в webPart XML-файл. Данные содержат сведения о самом элементе управления, включая его сборку, данные состояния и данные свойств. Пользователь, инициирующий экспорт, может сохранить XML-файл на диске на локальном компьютере или в сети. Затем другие пользователи могут импортировать файл описания на другую страницу или веб-сайт и применить данные состояния и свойства к другому экземпляру webPart. Это обеспечивает быстрый и удобный механизм для совместного использования и повторного использования параметров в серверных элементах управления, а также предоставляет разработчикам средства управления внешним видом и поведением экспортированных и импортированных элементов управления.

Свойства в webPart не экспортируются по умолчанию. Чтобы включить экспорт свойства, необходимо пометить его атрибутом [Personalizable] в исходном коде. При необходимости можно пометить экспортируемое свойство как содержащее конфиденциальные данные, задав isSensitive для параметра атрибута [Personalizable] значение true. По умолчанию isSensitive имеет значение false. Разработчики могут задать параметру значение , true чтобы указать, что данные являются конфиденциальными.

Чтобы включить webPart экспорт, разработчик задает значение All свойства ExportMode (включая все персонализированные и конфиденциальные свойства) или NonSensitiveDataзначение , которое экспортирует все, кроме конфиденциальных свойств.

Важно!

Разрешение пользователям экспортировать данные из элементов управления и импортировать данные в другие элементы управления влечет за собой некоторые риски для безопасности. Разработчики должны использовать описанный выше подход для защиты конфиденциальных данных, и если они хотят избежать риска предоставления данных в целом, они не должны включать экспорт webPart . Дополнительные сведения о проблемах безопасности веб-частей см. в разделе Защита страниц веб-частей.

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

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