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 網頁元件控制件