TextBoxBase.TextLength Propriedade

public:
 virtual property int TextLength { int get(); };

[System.ComponentModel.Browsable(false)]
public virtual int TextLength { get; }

[<System.ComponentModel.Browsable(false)>]
member this.TextLength : int

Public Overridable ReadOnly Property TextLength As Integer

Valor de Propriedade

O número de caracteres contidos no texto do controlo.

Atributos

BrowsableAttribute

Exemplos

O exemplo de código seguinte demonstra como usar o AppendText método e a TextLength propriedade para copiar texto de um TextBox para outro. Este exemplo exige que dois TextBox controlos textBox1 nomeados 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

Observações

Pode usar esta propriedade para determinar o número de caracteres numa cadeia para tarefas como procurar cadeias específicas de texto dentro do texto do controlo, onde é necessário conhecer o número total de caracteres.

Ver também

• Text