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

Определение

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

System.Web.UI.WebControls.WebParts

Сборка:

System.Web.dll

Создает 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-файл описания.

Исключения

ArgumentNullException

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

-или-

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

ArgumentException

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

-или-

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

Комментарии

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

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

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

Важно!

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

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

• ExportMode
• ImportWebPart(XmlReader, String)
• Защита страниц веб-частей