WebPartManager.ImportWebPart(XmlReader, String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Импортирует XML-файл описания, который содержит данные состояния и свойств для элемента управления WebPart и применяет эти данные к элементу управления.
public:
virtual System::Web::UI::WebControls::WebParts::WebPart ^ ImportWebPart(System::Xml::XmlReader ^ reader, [Runtime::InteropServices::Out] System::String ^ % errorMessage);public virtual System.Web.UI.WebControls.WebParts.WebPart ImportWebPart (System.Xml.XmlReader reader, out string errorMessage);abstract member ImportWebPart : System.Xml.XmlReader * string -> System.Web.UI.WebControls.WebParts.WebPart
override this.ImportWebPart : System.Xml.XmlReader * string -> System.Web.UI.WebControls.WebParts.WebPartPublic Overridable Function ImportWebPart (reader As XmlReader, ByRef errorMessage As String) As WebPartПараметры
- reader
- XmlReader
Средство чтения XmlReader, которое считывает данные состояния и свойств из импортируемого XML-файла описания.
- errorMessage
- String
Строка String, которая отображается для пользователей, если во время импорта возникает ошибка.
Возвращаемое значение
Объект WebPart (или серверный элемент управления, оболочкой для которого является GenericWebPart, и поэтому он воспринимается как WebPart), на который имеется ссылка в импортированном XML-файле описания.
Исключения
reader имеет значение null.
reader не может прочитать файл.
-или-
reader должен был отобразить сообщение об ошибке импорта, однако не нашел такого сообщения в файле.
-или-
reader достиг конца файла и не нашел XML-элемент, содержащий экспортированные данные.
Комментарии
Метод ImportWebPart импортирует XML-файл описания, созданный методом ExportWebPart для серверного элемента управления. Импортируется не фактический серверный элемент управления, а только файл описания, содержащий данные о состоянии и свойстве элемента управления. Элемент управления и сборка, на которые ссылается файл описания, уже должны быть доступны на сервере, где пользователь пытается импортировать файл описания.
Чтобы включить импорт элемента управления, разработчику необходимо добавить CatalogZone элемент управления на страницу, где будет включен импорт. В пределах зоны ImportCatalogPart необходимо добавить элемент управления . Этот элемент управления предоставляет диалоговое окно файла, позволяющее пользователям просматривать и находить файл описания для импорта.
Когда пользователь находит файл описания и начинает импорт, он считывается методом ImportWebPart . Если ошибок нет, а сборка и элемент управления найдены, серверный элемент управления добавляется в каталог в ImportCatalogPart элементе управления, а к элементу управления применяются различные свойства и данные состояния, указанные в файле описания. Затем пользователь может выбрать элемент управления и добавить его на страницу.
Важно!
Как и метод ExportWebPart , ImportWebPart метод имеет некоторые потенциальные риски для безопасности. Так как он включает импорт данных на веб-сайт, злоумышленник может попытаться вставить недопустимые данные или даже код скрипта в импортируемый файл описания. Затем недопустимые данные могут отображаться на странице или в базе данных, а также выполняться вставленный скрипт. Общие сведения о потенциальных рисках, связанных с импортом файлов описания, и способах их предотвращения см. в разделе Защита страниц веб-частей.
