TextBoxBase.Paste Method ()


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

Replaces the current selection in the text box with the contents of the Clipboard.

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

[UIPermissionAttribute(SecurityAction.Demand, Clipboard = UIPermissionClipboard.OwnClipboard)]
public void Paste()

The Paste method will only paste text into the control if text is currently stored in the Clipboard.

The following code example uses TextBox, a derived class. It provides Click event handlers for MenuItem objects that perform Cut, Copy, Paste, and Undo operations. This example requires that a TextBox control named textBox1 has been created.

private void Menu_Copy(System.Object sender, System.EventArgs e)
    // Ensure that text is selected in the text box.   
    if(textBox1.SelectionLength > 0)
        // Copy the selected text to the Clipboard.

 private void Menu_Cut(System.Object sender, System.EventArgs e)
     // Ensure that text is currently selected in the text box.   
     if(textBox1.SelectedText != "")
        // Cut the selected text in the control and paste it into the Clipboard.

 private void Menu_Paste(System.Object sender, System.EventArgs e)
    // Determine if there is any text in the Clipboard to paste into the text box.
    if(Clipboard.GetDataObject().GetDataPresent(DataFormats.Text) == true)
        // Determine if any text is selected in the text box.
        if(textBox1.SelectionLength > 0)
          // Ask user if they want to paste over currently selected text.
          if(MessageBox.Show("Do you want to paste over current selection?", "Cut Example", MessageBoxButtons.YesNo) == DialogResult.No)
             // Move selection to the point after the current selection and paste.
             textBox1.SelectionStart = textBox1.SelectionStart + textBox1.SelectionLength;
        // Paste current text in Clipboard into text box.

 private void Menu_Undo(System.Object sender, System.EventArgs e)
    // Determine if last operation can be undone in text box.   
    if(textBox1.CanUndo == true)
       // Undo the last operation.
       // Clear the undo buffer to prevent last action from being redone.


for reading from the Clipboard. Associated enumeration: the AllClipboard value of System.Security.Permissions.UIPermissionClipboard.

.NET Framework
Available since 1.1
Return to top