TextBoxBase.AppendText(String) Método

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Acrescenta texto ao texto atual de uma caixa de texto.

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)

Parâmetros

text: String

O texto a ser acrescentado ao conteúdo atual da caixa de texto.

Exemplos

O exemplo de código a seguir demonstra como usar o AppendText método e a TextLength propriedade para copiar texto de um TextBox para outro. Este exemplo requer que dois TextBox controles chamados, textBox1 e textBox2, tenham sido adicionados a um formulário e que textBox1 tenha texto atribuído à sua Text propriedade.

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

Comentários

Você pode usar esse método para adicionar texto ao texto existente no controle em vez de usar o operador de concatenação (+) para concatenar o texto na Text propriedade .

Aplica-se a

Partilhar via