HtmlTextWriter.InnerWriter Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets or sets the text writer that writes the inner content of the markup element.

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

public TextWriter InnerWriter { get; set; }

Property Value

Type: System.IO.TextWriter

A TextWriter that writes the inner markup content.

Inner markup content is the text found between the opening and closing tags of a markup language element.

If the InnerWriter property is set to a TextWriter object that is an instance of the HttpWriter class, this fact is noted and a separate reference is saved.

The following code example shows how to use a custom Web server control, derived from the WebControl class, that overrides the Render method. It uses the HtmlTextWriter class to write a <font> element. After it writes the opening tag of the element, it uses the InnerWriter property to write the string "<br> The time on the server:" and concatenates this string with the value of the DateTime.Now property.

    // Write the opening tag of a Font element.
    // Write a Color style attribute to the opening tag
    // of the Font element and set its value to red.
    writer.WriteAttribute("color", "red");
    // Write the closing character for the opening tag of
    // the Font element.

    // Use the InnerWriter property to create a TextWriter
    // object that will write the content found between
    // the opening and closing tags of the Font element.
    // Message is a string property of the control that 
    // overrides the Render method.
    TextWriter innerTextWriter = writer.InnerWriter;
    innerTextWriter.Write(Message + "<br> The time on the server :" + System.DateTime.Now.ToLongTimeString());

    // Write the closing tag of the Font element.

.NET Framework
Available since 1.1
Return to top