HtmlTextWriter.RenderAfterContent Method

Reference

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Writes any text or spacing that occurs after the content and before the closing tag of the markup element to the markup output stream.

protected:
 virtual System::String ^ RenderAfterContent();

protected virtual string RenderAfterContent ();

abstract member RenderAfterContent : unit -> string
override this.RenderAfterContent : unit -> string

Protected Overridable Function RenderAfterContent () As String

Returns

String

A string that contains the spacing or text to write after the content of the element.

Examples

The following code example shows how to override the RenderAfterContent method in a class derived from the HtmlTextWriter class to determine whether a <label> element is being rendered. If so, the RenderAfterContent override inserts the closing tag of a <font> element immediately before the closing tag of the <label> element. If an element other than <label> is being rendered, the RenderAfterContent base method is used.

// Override the RenderAfterContent method to render
// the closing tag of a font element if the
// rendered tag is a label element.

virtual String^ RenderAfterContent() override
{
   
   // Check to determine whether the element being rendered
   // is a label element. If so, render the closing tag
   // of the font element; otherwise, call the base method.
   if ( TagKey == HtmlTextWriterTag::Label )
   {
      return "</font>";
   }
   else
   {
      return __super::RenderAfterContent();
   }
}

// Override the RenderAfterContent method to render
// the closing tag of a font element if the 
// rendered tag is a label element.
protected override string RenderAfterContent()
{
    // Check to determine whether the element being rendered
    // is a label element. If so, render the closing tag
    // of the font element; otherwise, call the base method.
    if (TagKey == HtmlTextWriterTag.Label)
    {
        return "</font>";
    }
    else
    {
        return base.RenderAfterContent();
    }
}

' Override the RenderAfterContent method to render
' the closing tag of a font element if the 
' rendered tag is a label element.
Protected Overrides Function RenderAfterContent() As String
    ' Check to determine whether the element being rendered
    ' is a label element. If so, render the closing tag
    ' of the font element; otherwise, call the base method.
    If TagKey = HtmlTextWriterTag.Label Then
        Return "</font>"
    Else
        Return MyBase.RenderAfterContent()
    End If
End Function 'RenderAfterContent

Remarks

The RenderAfterContent method can be useful if you want to insert child elements into the current markup element.

Notes to Inheritors

The HtmlTextWriter class implementation of the RenderAfterContent() method returns null. Override RenderAfterContent() if you want to write text or spacing after the element content but before the closing tag.

Applies to

Jaa