HtmlTextWriter.WriteLine Method (Char(), Int32, Int32)

 

Writes any pending tab spacing and a subarray of Unicode characters, followed by a line terminator string, to the output stream.

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

Public Overrides Sub WriteLine (
	buffer As Char(),
	index As Integer,
	count As Integer
)

Parameters

buffer
Type: System.Char()

The character array from which to write text to the output stream.

index
Type: System.Int32

The location in the character array where writing begins.

count
Type: System.Int32

The number of characters in the array to write to the output stream.

The default line terminator string is a carriage return followed by a line feed ("\r\n"). The WriteLine base method is used to write the value parameter.

This section contains two code examples. The first one demonstrates how to create a character array. The second one demonstrates how to use the array.

These code examples generate the following markup:

<label>

hello

</label>

The following code example demonstrates how to create an array of characters that spell out hello world. Included in the array is the SpaceChar field, which creates a space between the two words.

Private testChars() As Char = _
    {"h"c, "e"c, "l"c, "l"c, "o"c, _
    HtmlTextWriter.SpaceChar, "w"c, "o"c, "r"c, "l"c, "d"c}

The following code example uses the index and count parameters of the WriteLine method to render the first five characters of the array created in the preceding code example.

' Render a subarray of a character array
' as the contents of a <label> element.
writer.RenderBeginTag(HtmlTextWriterTag.Label)
writer.WriteLine(testChars, 0, 5)
writer.RenderEndTag()

.NET Framework
Available since 1.1
Return to top
Show: