Freigeben über

TextBoxBase.AppendText(String) Methode

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Quelle:
TextBoxBase.cs
Quelle:
TextBoxBase.cs
Quelle:
TextBoxBase.cs
Quelle:
TextBoxBase.cs
Quelle:
TextBoxBase.cs

Fügt Text an den aktuellen Text eines Textfelds an.

public:
 void AppendText(System::String ^ text);
public void AppendText(string text);
public void AppendText(string? text);
member this.AppendText : string -> unit
Public Sub AppendText (text As String)

Parameter

text
String

Der Text, der an den aktuellen Inhalt des Textfelds angefügt werden soll.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der AppendText Methode und der TextLength Eigenschaft zum Kopieren von Text von einem in einen TextBox anderen veranschaulicht. In diesem Beispiel müssen zwei TextBox Benannte Steuerelemente textBox1 hinzugefügt werden, die textBox2einem Formular hinzugefügt wurden und textBox1 deren Eigenschaft Text zugewiesen Text ist.

void AppendTextBox1Text()
{
   // Determine if text is selected in textBox1.
   if ( textBox1->SelectionLength == 0 )

   // No selection made, return.
   return;

   // Determine if the text being appended to textBox2 exceeds the MaxLength property.
   if ( (textBox1->SelectedText->Length + textBox2->TextLength) > textBox2->MaxLength )
         MessageBox::Show( "The text to paste in is larger than the maximum number of characters allowed" ); // Append the text from textBox1 into textBox2.
   else
         textBox2->AppendText( textBox1->SelectedText );
}

private void AppendTextBox1Text()
{
   // Determine if text is selected in textBox1.
   if(textBox1.SelectionLength == 0)
      // No selection made, return.
      return;
   
   // Determine if the text being appended to textBox2 exceeds the MaxLength property.
   if((textBox1.SelectedText.Length + textBox2.TextLength) > textBox2.MaxLength)
      MessageBox.Show("The text to paste in is larger than the maximum number of characters allowed");
   else
      // Append the text from textBox1 into textBox2.
      textBox2.AppendText(textBox1.SelectedText);
}

Private Sub AppendTextBox1Text()
   ' Determine if text is selected in textBox1.
   If textBox1.SelectionLength = 0 Then
      ' No selection made, return.
      Return
   End If
   ' Determine if the text being appended to textBox2 exceeds the MaxLength property.
   If textBox1.SelectedText.Length + textBox2.TextLength > textBox2.MaxLength Then
      MessageBox.Show("The text to paste in is larger than the maximum number of characters allowed")
      ' Append the text from textBox1 into textBox2.
   Else
      textBox2.AppendText(textBox1.SelectedText)
   End If
End Sub

Hinweise

Mit dieser Methode können Sie dem vorhandenen Text im Steuerelement Text hinzufügen, anstatt den Verkettungsoperator (+) zu verwenden, um Text mit der Text Eigenschaft zu verketten.

Gilt für:

Weitere Informationen