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 всех. Дополнительные сведения о проблемах безопасности веб-частей см. в разделе "Защита страниц веб-частей".
