WebPartManager.ImportWebPart(XmlReader, String) Метод

Определение

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

System.Web.UI.WebControls.WebParts

Сборка:

System.Web.dll

Импортирует 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.WebPart

Public Overridable Function ImportWebPart (reader As XmlReader, ByRef errorMessage As String) As WebPart

Параметры

reader

XmlReader

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

errorMessage

String

Строка String, которая отображается для пользователей, если во время импорта возникает ошибка.

Возвращаемое значение

WebPart

Объект WebPart (или серверный элемент управления, оболочкой для которого является GenericWebPart, и поэтому он воспринимается как WebPart), на который имеется ссылка в импортированном XML-файле описания.

Исключения

ArgumentNullException

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

EndOfStreamException

reader не может прочитать файл.

-или-

reader должен был отобразить сообщение об ошибке импорта, однако не нашел такого сообщения в файле.

-или-

reader достиг конца файла и не нашел XML-элемент, содержащий экспортированные данные.

Комментарии

Метод ImportWebPart импортирует XML-файл описания, созданный методом ExportWebPart для серверного элемента управления. Импортируется не фактический серверный элемент управления, а только файл описания, содержащий данные о состоянии и свойстве элемента управления. Элемент управления и сборка, на которые ссылается файл описания, уже должны быть доступны на сервере, где пользователь пытается импортировать файл описания.

Чтобы включить импорт элемента управления, разработчику необходимо добавить CatalogZone элемент управления на страницу, где будет включен импорт. В пределах зоны ImportCatalogPart необходимо добавить элемент управления . Этот элемент управления предоставляет диалоговое окно файла, позволяющее пользователям просматривать и находить файл описания для импорта.

Когда пользователь находит файл описания и начинает импорт, он считывается методом ImportWebPart . Если ошибок нет, а сборка и элемент управления найдены, серверный элемент управления добавляется в каталог в ImportCatalogPart элементе управления, а к элементу управления применяются различные свойства и данные состояния, указанные в файле описания. Затем пользователь может выбрать элемент управления и добавить его на страницу.

Важно!

Как и метод ExportWebPart , ImportWebPart метод имеет некоторые потенциальные риски для безопасности. Так как он включает импорт данных на веб-сайт, злоумышленник может попытаться вставить недопустимые данные или даже код скрипта в импортируемый файл описания. Затем недопустимые данные могут отображаться на странице или в базе данных, а также выполняться вставленный скрипт. Общие сведения о потенциальных рисках, связанных с импортом файлов описания, и способах их предотвращения см. в разделе Защита страниц веб-частей.

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

• ImportCatalogPart
• ExportWebPart(WebPart, XmlWriter)
• Защита страниц веб-частей