ControlDesigner.GetErrorDesignTimeHtml(Exception) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
擷取可提供所指定例外狀況之相關資訊的 HTML 標記。
protected:
virtual System::String ^ GetErrorDesignTimeHtml(Exception ^ e);
protected virtual string GetErrorDesignTimeHtml (Exception e);
abstract member GetErrorDesignTimeHtml : Exception -> string
override this.GetErrorDesignTimeHtml : Exception -> string
Protected Overridable Function GetErrorDesignTimeHtml (e As Exception) As String
參數
發生的例外狀況。
傳回
所指定例外狀況的設計階段 HTML 標記。
範例
下列程式代碼範例示範如何在發生錯誤並呼叫 CreatePlaceHolderDesignTimeHtml 方法時,為控件產生設計時間 HTML 標記。
// Generate the design-time markup for the control when an error occurs.
protected override string GetErrorDesignTimeHtml(Exception e)
{
// Write the error message text in red, bold.
string errorRendering =
"<span style=\"font-weight:bold; color:Red; \">" +
e.Message + "</span>";
return CreatePlaceHolderDesignTimeHtml(errorRendering);
} // GetErrorDesignTimeHtml
' Generate the design-time markup for the control when an error occurs.
Protected Overrides Function GetErrorDesignTimeHtml( _
ByVal ex As Exception) As String
' Write the error message text in red, bold.
Dim errorRendering As String = _
"<span style=""font-weight:bold; color:Red; "">" & _
ex.Message & "</span>"
Return CreatePlaceHolderDesignTimeHtml(errorRendering)
End Function ' GetErrorDesignTimeHtml
備註
GetErrorDesignTimeHtml如果 方法中GetDesignTimeHtml擲回例外狀況,通常會呼叫 方法。
給繼承者的注意事項
典型的設計模式是嘗試透過相關聯的控件取得 HTML 標記,然後如果遇到錯誤,請呼叫 GetErrorDesignTimeHtml(Exception) 方法。 如果控件未傳回任何標記,請呼叫 GetEmptyDesignTimeHtml() 方法,如果未覆寫以提供特定標記,則會呼叫 CreatePlaceHolderDesignTimeHtml() 方法,該方法應該包含控件的類型和標識符的相關信息。