TextBoxBase.Clear-Methode

Löscht den gesamten Text aus dem Textfeld-Steuerelement.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Sub Clear
'Usage
Dim instance As TextBoxBase

instance.Clear

public void Clear ()

public:
void Clear ()

public void Clear ()

public function Clear ()

Hinweise

Sie können mit dieser Methode den Inhalt des Steuerelements löschen, ohne der Text-Eigenschaft eine leere Zeichenfolge zuzuweisen.

Beispiel

Im folgenden Codebeispiel wird mithilfe der abgeleiteten Klasse TextBox ein Ereignishandler für das TextChanged-Ereignis erstellt. Der Code des Ereignishandlers beschränkt die Daten auf Zahlen. Nachdem in das Steuerelement Text eingegeben wurde, wird durch den Code bestimmt, ob es sich bei diesem um eine Zahl handelt. Wenn es sich bei dem Text nicht um eine Zahl handelt, löscht der Code den Text aus dem Steuerelement und zeigt eine MessageBox an, in der der Benutzer informiert wird, dass nur Zahlen eingegeben werden dürfen. Bei diesem Beispiel ist es erforderlich, dass die Boolean-Variable flag und das TextBox-Steuerelement textBox1 nicht in dieser Methode definiert werden. Im folgenden Beispiel wird veranschaulicht, wie mit einer Flagvariablen eine Ereigniskette im TextChanged-Ereignis vermieden wird.

Private flag As Boolean    

Private Sub MyTextChangedHandler(sender As System.Object, e As System.EventArgs)
    ' Check the flag to prevent code re-entry. 
    If flag = False Then
        ' Set the flag to True to prevent re-entry of the code below.
        flag = True
        ' Determine if the text of the control is a number.
        If IsNumeric(textBox1.Text) = False Then
            ' Display a message box and clear the contents if not a number.
            MessageBox.Show("The text is not a valid number. Please re-enter")
            ' Clear the contents of the text box to allow re-entry.
            textBox1.Clear()
        End If
        ' Reset the flag so other TextChanged events are processed correctly.
        flag = False
    End If
End Sub

private bool flag;

private void MyTextChangedHandler(System.Object sender, System.EventArgs e)
{
    long val;    
    // Check the flag to prevent code re-entry. 
    if(flag == false)
    {
       // Set the flag to True to prevent re-entry of the code below.
       flag = true;
       // Determine if the text of the control is a number.
       try {
          // Attempt to convert to long
          val = System.Convert.ToInt64(textBox1.Text);
       }
       catch {
          // Display a message box and clear the contents if not a number.
          MessageBox.Show("The text is not a valid number. Please re-enter");
          // Clear the contents of the text box to allow re-entry.
          textBox1.Clear();
       }
       // Reset the flag so other TextChanged events are processed correctly.
       flag = false;
    }        
 }
 

private:
   bool flag;

private:
   void MyTextChangedHandler( System::Object^ sender, System::EventArgs^ e )
   {
      Int64 val;
      // Check the flag to prevent code re-entry. 
      if ( flag == false )
      {
         // Set the flag to True to prevent re-entry of the code below.
         flag = true;
         // Determine if the text of the control is a number.
         try
         {
            // Attempt to convert to long
            val = System::Convert::ToInt64( textBox1->Text );
         }
         catch ( Exception^ ) 
         {
            // Display a message box and clear the contents if not a number.
            MessageBox::Show( "The text is not a valid number. Please re-enter" );
            // Clear the contents of the text box to allow re-entry.
            textBox1->Clear();
         }
         // Reset the flag so other TextChanged events are processed correctly.
         flag = false;
      }
   }

private boolean flag;
private void MyTextChangedHandler(Object sender, System.EventArgs e)
{
    long val;
    // Check the flag to prevent code re-entry. 
    if (flag == false) {
        // Set the flag to True to prevent re-entry of the code below.
        flag = true;
        // Determine if the text of the control is a number.
        try {
            // Attempt to convert to long
            val = System.Convert.ToInt64(textBox1.get_Text());
        }
        catch (System.Exception exp) {
            // Display a message box and clear the contents if not a number.
            MessageBox.Show("The text is not a valid number."
                + "Please re-enter");
            // Clear the contents of the text box to allow re-entry.
            textBox1.Clear();
        }
        //Reset the flag so other TextChanged events are processed correctly.
        flag = false;
    }
} //MyTextChangedHandler

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

TextBoxBase-Klasse
TextBoxBase-Member
System.Windows.Forms-Namespace
Cut
Copy
Paste
CanUndo
ClearUndo