Lines Property

TextBoxBase.Lines Property


Gets or sets the lines of text in a text box control.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public string[] Lines { get; set; }

Property Value

Type: System.String[]

An array of strings that contains the text in a text box control.

Each element in the array becomes a line of text in the text box control. If the Multiline property of the text box control is set to true and a newline character appears in the text, the text following the newline character is added to a new element in the array and displayed on a separate line.


By default, the collection of lines is a read-only copy of the lines in the TextBox. To get a writable collection of lines, use code similar to the following: textBox1.Lines = new string[] { "abcd" };

The following code example uses TextBox, a derived class, to extract all strings of text from a multiline text box control and displays them using the Debug.WriteLine method. This example requires that a TextBox control has been created, named textBox1, and that it has been filled with lines of text.

public void ViewMyTextBoxContents()
    // Create a string array and store the contents of the Lines property.
    string[] tempArray = textBox1.Lines;

    // Loop through the array and send the contents of the array to debug window.
    for(int counter=0; counter < tempArray.Length;counter++)

.NET Framework
Available since 1.1
Return to top
© 2015 Microsoft