This documentation is archived and is not being maintained.

HtmlTextWriter.Write Method (Char[], Int32, Int32)

Writes the text representation of a subarray of Unicode characters to the output stream, along with any pending tab spacing.

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

public override void Write (
	char[] buffer,
	int index,
	int count
)
public void Write (
	char[] buffer, 
	int index, 
	int count
)
public override function Write (
	buffer : char[], 
	index : int, 
	count : int
)
Not applicable.

Parameters

buffer

The array of characters from which to write text to the output stream.

index

The index location in the array where writing begins.

count

The number of characters to write to the output stream.

The Write method generates any tabs that are pending, and then calls the Write base method.

This section provides 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 shows 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 char[] testChars = {'h', 'e', 'l', 'l', 'o',
    HtmlTextWriter.SpaceChar ,'w', 'o', 'r', 'l', 'd'};

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

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

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0
Show: