HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) HtmlTextWriter.OnTagRender(String, HtmlTextWriterTag) Method

定義

指定したマークアップ要素を要求側のページにレンダリングするかどうかを決定します。Determines whether the specified markup element will be rendered to the requesting page.

protected:
 virtual bool OnTagRender(System::String ^ name, System::Web::UI::HtmlTextWriterTag key);
protected virtual bool OnTagRender (string name, System.Web.UI.HtmlTextWriterTag key);
abstract member OnTagRender : string * System.Web.UI.HtmlTextWriterTag -> bool
override this.OnTagRender : string * System.Web.UI.HtmlTextWriterTag -> bool
Protected Overridable Function OnTagRender (name As String, key As HtmlTextWriterTag) As Boolean

パラメーター

name
String String String String

レンダリングする要素の名前を格納している文字列。A string containing the name of the element to render.

key
HtmlTextWriterTag HtmlTextWriterTag HtmlTextWriterTag HtmlTextWriterTag

要素に関連付けられている HtmlTextWriterTagThe HtmlTextWriterTag associated with the element.

戻り値

常に trueAlways true.

次のコード例は、オーバーライドする方法を示します、OnTagRenderメソッド。The following code example shows how to override the OnTagRender method. 場合、 Font 、要素が表示される、OnTagRenderオーバーライドは、IsAttributeDefined判断するメソッドかどうかをSize属性が表示されます。If a Font element is being rendered, the OnTagRender override uses the IsAttributeDefined method to determine whether a Size attribute is being rendered. そうでないを使用する場合、AddAttributeを作成する方法、Size属性し、その値に設定20ptします。If not, it uses the AddAttribute method to create a Size attribute and set its value to 20pt.

// If a <font> element is to be rendered, check whether it contains
// a size attribute. If it does not, add one and set its value to
// 20 points, then return true.
protected override bool OnTagRender(string name, HtmlTextWriterTag key)
{

    if (key == HtmlTextWriterTag.Font)
    {
        if (!(IsAttributeDefined(HtmlTextWriterAttribute.Size)))
        {
            AddAttribute(HtmlTextWriterAttribute.Size, "20pt");
            return true;
        }
    }

    // If the element is not a <font> element, use
    // the base functionality of the OnTagRenderMethod.
    return base.OnTagRender(name, key);
}
' If a <font> element is to be rendered, check whether it contains
' a size attribute. If it does not, add one and set its value to
' 20 points, then return true.
Protected Overrides Function OnTagRender( _
    name As String, _
    key As HtmlTextWriterTag) _
As Boolean

    If (key = HtmlTextWriterTag.Font) Then
        If Not (IsAttributeDefined(HtmlTextWriterAttribute.Size)) Then
            AddAttribute(HtmlTextWriterAttribute.Size, "20pt")
            Return True
        End If
    End If

    ' If the element is not a <font> element, use
    ' the base functionality of the OnTagRenderMethod.
    Return MyBase.OnTagRender(name, key)
End Function

注釈

HtmlTextWriterのクラスの実装、OnTagRenderメソッドは常に返しますtrueします。The HtmlTextWriter class implementation of the OnTagRender method always returns true. OnTagRender上書きが要素をページに表示するかどうかを判断することができます。The OnTagRender overrides can determine whether an element will be rendered to the page.

注意 (継承者)

継承する場合、HtmlTextWriterオーバーライドするクラス、OnTagRender(String, HtmlTextWriterTag)を返すメソッドをfalseマークアップ要素がまったく、または特定のマークアップ言語用に表示されないようにします。If you inherit from the HtmlTextWriter class, you can override the OnTagRender(String, HtmlTextWriterTag) method to return false to prevent a markup element from being rendered at all or for a particular markup language. 派生したオブジェクトしたくない場合などHtmlTextWriter表示するために、<font>要素をオーバーライドできます、OnTagRender(String, HtmlTextWriterTag)メソッドを返すfalseを含むページが要求された場合、<font>要素。For example, if you do not want the object that is derived from HtmlTextWriter to render the <font> element, you can override the OnTagRender(String, HtmlTextWriterTag) method to return false when a page is requested that contains a <font> element.

適用対象

こちらもご覧ください