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 部件控件