ChtmlTextWriter.OnAttributeRender 方法

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

判斷指定的 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 的值。

key

HtmlTextWriterAttribute

與 HtmlTextWriterAttribute 相關聯的 name。

傳回

Boolean

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 類別中覆寫 方法的行為。

另請參閱

• OnStyleAttributeRender(String, String, HtmlTextWriterStyle)