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 -> unitPublic Overridable Sub ExportWebPart (webPart As WebPart, writer As XmlWriter)Параметры
- webPart
- WebPart
Элемент управления, из которого будут экспортированы данные.
- writer
- XmlWriter
Средство записи XmlWriter, который записывает экспортированные из webPart данные в XML-файл описания.
Исключения
webPart не содержится в коллекции элементов управления, на которую ссылается свойство Controls.
-или-
Значение свойства ExportMode, принадлежащее webPart, задано равным None, что означает отключение экспорта для webPart.
Комментарии
Метод ExportWebPart собирает различные данные о состоянии и свойствах в webPart XML-файл. Данные содержат сведения о самом элементе управления, включая его сборку, данные состояния и данные свойств. Пользователь, инициирующий экспорт, может сохранить XML-файл на диске на локальном компьютере или в сети. Затем другие пользователи могут импортировать файл описания на другую страницу или веб-сайт и применить данные состояния и свойства к другому экземпляру webPart. Это обеспечивает быстрый и удобный механизм для совместного использования и повторного использования параметров в серверных элементах управления, а также предоставляет разработчикам средства управления внешним видом и поведением экспортированных и импортированных элементов управления.
Свойства в webPart не экспортируются по умолчанию. Чтобы включить экспорт свойства, необходимо пометить его атрибутом [Personalizable] в исходном коде. При необходимости можно пометить экспортируемое свойство как содержащее конфиденциальные данные, задав isSensitive для параметра атрибута [Personalizable] значение true. По умолчанию isSensitive имеет значение false. Разработчики могут задать параметру значение , true чтобы указать, что данные являются конфиденциальными.
Чтобы включить webPart экспорт, разработчик задает значение All свойства ExportMode (включая все персонализированные и конфиденциальные свойства) или NonSensitiveDataзначение , которое экспортирует все, кроме конфиденциальных свойств.
Важно!
Разрешение пользователям экспортировать данные из элементов управления и импортировать данные в другие элементы управления влечет за собой некоторые риски для безопасности. Разработчики должны использовать описанный выше подход для защиты конфиденциальных данных, и если они хотят избежать риска предоставления данных в целом, они не должны включать экспорт webPart . Дополнительные сведения о проблемах безопасности веб-частей см. в разделе Защита страниц веб-частей.
