ChtmlTextWriter.OnAttributeRender 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
判斷指定的 cHTML 屬性和其值是否在提出要求的網頁上呈現。 您可以從 OnAttributeRender(String, String, HtmlTextWriterAttribute) 類別衍生的類別中覆寫 ChtmlTextWriter 方法,篩選出不要在支援 cHTML 之裝置上呈現的屬性。
protected:
override bool OnAttributeRender(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterAttribute key);
protected override bool OnAttributeRender (string name, string value, System.Web.UI.HtmlTextWriterAttribute key);
override this.OnAttributeRender : string * string * System.Web.UI.HtmlTextWriterAttribute -> bool
Protected Overrides Function OnAttributeRender (name As String, value As String, key As HtmlTextWriterAttribute) As Boolean
參數
- name
- String
要呈現的 cHTML 屬性。
- value
- String
要指派至 name
的值。
與 HtmlTextWriterAttribute 相關聯的 name
。
傳回
true
表示將屬性及其值寫入 ChtmlTextWriter 輸出資料流,否則為 false
。
範例
下列程式碼範例示範如何使用覆寫 方法的 OnAttributeRender 自訂類別,以防止 bgcolor
屬性寫入 cHTML 輸出資料流程。 然後,它會從 ChtmlTextWriter 類別呼叫基底 OnAttributeRender 方法所提供的功能,以確保也會使用其預設行為。
此程式碼範例是提供給 類別之較大範例的 ChtmlTextWriter 一部分。
// Override the OnAttributeRender method to
// not render the bgcolor attribute, which is
// not supported in CHTML.
protected override bool OnAttributeRender(string name, string value, HtmlTextWriterAttribute key)
{
if (String.Equals("bgcolor", name))
{
return false;
}
// Call the ChtmlTextWriter version of the
// the OnAttributeRender method.
return base.OnAttributeRender(name, value, key);
}
' Override the OnAttributeRender method to
' not render the bgcolor attribute, which is
' not supported in CHTML.
Protected Overrides Function OnAttributeRender(ByVal name As String, ByVal value As String, ByVal key As HtmlTextWriterAttribute) As Boolean
If (String.Equals("bgcolor", name)) Then
Return False
End If
' Call the ChtmlTextWriter version of
' the OnAttributeRender method.
MyBase.OnAttributeRender(name, value, key)
End Function
備註
根據預設, OnAttributeRender 方法會防止全域隱藏的屬性列在 GlobalSuppressedAttributes 屬性和元素特定、隱藏的屬性中,而該屬性中 SuppressedAttributes 所列的屬性無法寫入輸出資料流程。 您可以在衍生自 ChtmlTextWriter 類別的 OnAttributeRender 類別中覆寫 方法的行為。