WebPartManager.CreateErrorWebPart Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает специальный элемент управления, который вставляется на страницу и отображается для конечных пользователей при завершении со сбоем попытки загрузки или создания динамического элемента управления WebPart по какой-либо причине.
protected:
virtual System::Web::UI::WebControls::WebParts::ErrorWebPart ^ CreateErrorWebPart(System::String ^ originalID, System::String ^ originalTypeName, System::String ^ originalPath, System::String ^ genericWebPartID, System::String ^ errorMessage);protected virtual System.Web.UI.WebControls.WebParts.ErrorWebPart CreateErrorWebPart (string originalID, string originalTypeName, string originalPath, string genericWebPartID, string errorMessage);abstract member CreateErrorWebPart : string * string * string * string * string -> System.Web.UI.WebControls.WebParts.ErrorWebPart
override this.CreateErrorWebPart : string * string * string * string * string -> System.Web.UI.WebControls.WebParts.ErrorWebPartProtected Overridable Function CreateErrorWebPart (originalID As String, originalTypeName As String, originalPath As String, genericWebPartID As String, errorMessage As String) As ErrorWebPartПараметры
- originalID
- String
Строка, которая представляет идентификатор элемента управления со сбоем. Если элемент управления GenericWebPart связан со сбоем, идентификатор является идентификатором его дочернего серверного элемента управления.
- originalTypeName
- String
Строка, содержащая имя Type элемента управления со сбоем. Если элемент управления GenericWebPart связан со сбоем, имя типа — это тип его дочернего серверного элемента управления.
- originalPath
- String
Строка, содержащая путь к пользовательскому элементу управления, если элемент управления GenericWebPart, содержащий дочерний пользовательский элемент управления, связан со сбоем.
- genericWebPartID
- String
Строка, возвращающая идентификатор элемента управления GenericWebPart, если этот тип элемента управления связан со сбоем загрузки или создания элемента управления.
- errorMessage
- String
Строка, содержащая сообщение об ошибке для отображения на странице.
Возвращаемое значение
Объект ErrorWebPart, который вставляется на странице вместо элемента управления, загрузка или создание которого завершилась со сбоем.
Комментарии
Метод CreateErrorWebPart вызывается, когда набор элементов управления веб-части пытается загрузить или создать экземпляр динамического WebPart или серверного элемента управления, и по какой-либо причине он завершается ошибкой. Метод создает ErrorWebPart объект, назначает ему сообщение об ошибке и возвращает его. Элемент ErrorWebPart управления вставляется вместо элемента управления, который завершился сбоем, и его сообщение об ошибке отображается на странице.
Метод нельзя вызывать CreateErrorWebPart непосредственно из кода. Однако можно наследовать от WebPartManager класса и расширить метод. Дополнительные сведения см. в разделе "Заметки для наследутелей".
Конечные пользователи могут работать с элементом ErrorWebPart управления на странице так же, как и обычный WebPart элемент управления. Чтобы удалить сообщение об ошибке, он может закрыть элемент управления, щелкнув команду закрытия, в которой элемент управления будет добавлен в объект, как и любой PageCatalogPart другой закрытый элемент управления. Если пользователь удаляет ErrorWebPart элемент управления, серверный элемент управления, который не удалось загрузить, также будет удален со страницы.
Примечания для тех, кто наследует этот метод
Если вы хотите настроить сведения, возвращаемые в ErrorWebPart элементе управления, можно переопределить CreateErrorWebPart(String, String, String, String, String) метод, вызвать базовый метод, назначить различные значения параметрам, переданным базовому методу, а затем вернуть полученный ErrorWebPart элемент управления. Например, если вы не хотите, чтобы конечные пользователи могли видеть originalPath значение (которое будет отображать путь к виртуальному каталогу пользовательского элемента управления), при вызове базового метода можно передать пустую строку ("") для этого параметра.
Вы также можете настроить поведение ErrorWebPart самого элемента управления, наследуя от него. Например, может потребоваться переопределить его Title или AllowMinimize свойство.