WebPartManager.CreateErrorWebPart 方法

定义

命名空间:

System.Web.UI.WebControls.WebParts

程序集:

System.Web.dll

当加载或创建动态 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.ErrorWebPart

Protected Overridable Function CreateErrorWebPart (originalID As String, originalTypeName As String, originalPath As String, genericWebPartID As String, errorMessage As String) As ErrorWebPart

参数

originalID

String

作为失败控件 ID 的字符串。 如果失败涉及 GenericWebPart，则该 ID 为其子服务器控件的 ID。

originalTypeName

String

字符串，失败控件的 Type 名称。 如果失败涉及 GenericWebPart，则该类型名称是其子服务器控件的类型。

originalPath

String

包含用户控件路径的字符串（如果失败涉及包含子用户控件的 GenericWebPart）。

genericWebPartID

String

返回 GenericWebPart ID 的字符串（如果加载或创建控件的失败涉及该类型的控件）。

errorMessage

String

包含要在页中显示的错误消息的字符串。

返回

ErrorWebPart

插入页中以替代未能加载或创建的控件的 ErrorWebPart。

注解

CreateErrorWebPart当 Web 部件控件集尝试加载或创建动态WebPart或服务器控件的实例时，将调用 方法，但由于某种原因而失败。 方法创建对象 ErrorWebPart ，向其分配错误消息，并返回它。 插入 ErrorWebPart 控件以代替失败的控件，其错误消息显示在页面上。

不能直接从代码调用 CreateErrorWebPart 方法。 但是，可以从 类继承 WebPartManager 并扩展 方法。 有关详细信息，请参阅继承器说明部分。

最终用户可以在页面中使用 ErrorWebPart 控件，就像使用普通 WebPart 控件一样。 若要删除错误消息，他们可以通过单击关闭谓词关闭控件，此时控件将添加到 对象，就像任何其他已关闭的控件一 PageCatalogPart 样。 如果最终用户删除控件 ErrorWebPart ，则加载失败的服务器控件也将从页面中删除。

继承者说明

如果要自定义控件中 ErrorWebPart 返回的信息，可以重写 CreateErrorWebPart(String, String, String, String, String) 方法，调用基方法，为传递给基方法的参数分配不同的值，然后返回生成的 ErrorWebPart 控件。 例如，如果不希望最终用户看到 originalPath 值 (该值将显示用户控件) 的虚拟目录路径，则调用基方法时，可以传递该参数的空字符串 (“”) 。

还可以通过从控件继承来自定义控件本身的行为 ErrorWebPart 。 例如，你可能想要重写其 Title 或 AllowMinimize 属性。

另请参阅

• ErrorWebPart
• ASP.NET Web 部件控件