TextBox-Klasse

Mit dem TextBox-Steuerelement kann der Benutzer Text in einer Anwendung eingeben. Dieses Steuerelement bietet eine Funktionalität, die über das Standard-Textfeld-Steuerelement von Windows hinausgeht. Dazu gehören Mehrzeilenbearbeitung und Zeichenmaskierung für Kennwörter.

Normalerweise wird ein TextBox-Steuerelement für die Anzeige oder Eingabe einer einzelnen Textzeile verwendet. Über die Multiline-Eigenschaft und die ScrollBars-Eigenschaft kann die Anzeige bzw. Eingabe mehrerer Textzeilen aktiviert werden. Legen Sie die AcceptsTab-Eigenschaft und die AcceptsReturn-Eigenschaft auf true fest, um die umfangreichere Textbearbeitung in einem mehrzeiligen TextBox-Steuerelement zu ermöglichen.

Die in einem TextBox-Steuerelement eingegebene Textmenge kann begrenzt werden, indem die MaxLength-Eigenschaft auf eine bestimmte Anzahl von Zeichen festgelegt wird. Mit TextBox-Steuerelementen können auch Kennwörter und andere vertrauliche Informationen abgefragt werden. Die PasswordChar-Eigenschaft kann verwendet werden, um die in einer einzeiligen Version des Steuerelements eingegebenen Zeichen zu maskieren. Mit der CharacterCasing-Eigenschaft können Sie Benutzern die ausschließliche Eingabe von Großbuchstaben, von Kleinbuchstaben oder einer Kombination von Groß- und Kleinbuchstaben im TextBox-Steuerelement ermöglichen.

Um die Texteingabe für ein TextBox-Steuerelement zu beschränken, können Sie für das KeyDown-Ereignis einen Ereignishandler erstellen, damit jedes im Steuerelement eingegebene Zeichen validiert wird. Außerdem können Sie alle Dateneingaben in einem TextBox-Steuerelement beschränken, indem Sie die ReadOnly-Eigenschaft auf true festlegen.

Hinweis
Die Funktionalität des TextBox-Steuerelements wird größtenteils von der TextBoxBase-Klasse vererbt.

Hinweis
Die Verwendung des TextBox-Steuerelements bei gleichzeitig aktivierten visuellen Stilen verursacht eine fehlerhafte Behandlung von Ersatzschriftarten.

Hinweis zu Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows CE: In Pocket PC-Anwendungen werden Registerkarten in einem einzeiligen Textfeld als Klammern angezeigt. Sie werden jedoch normal angezeigt, wenn Multiline auf true festgelegt ist.

Im folgenden Codebeispiel wird ein mehrzeiliges TextBox-Steuerelement mit vertikalen Bildlaufleisten erstellt. In diesem Beispiel werden die Eigenschaften AcceptsTab, AcceptsReturn und WordWrap verwendet, um das mehrzeilige Textfeld-Steuerelement zum Erstellen von Textdokumenten verwenden zu können.

private void CreateMyMultilineTextBox()
 {
    // Create an instance of a TextBox control.
    TextBox textBox1 = new TextBox();
    
    // Set the Multiline property to true.
    textBox1.Multiline = true;
    // Add vertical scroll bars to the TextBox control.
    textBox1.ScrollBars = ScrollBars.Vertical;
    // Allow the RETURN key to be entered in the TextBox control.
    textBox1.AcceptsReturn = true;
    // Allow the TAB key to be entered in the TextBox control.
    textBox1.AcceptsTab = true;
    // Set WordWrap to True to allow text to wrap to the next line.
    textBox1.WordWrap = true;
    // Set the default text of the control.
    textBox1.Text = "Welcome!";
 }
 

private void CreateMyMultilineTextBox()
{
    // Create an instance of a TextBox control.
    TextBox textBox1 = new TextBox();
    // Set the Multiline property to true.
    textBox1.set_Multiline(true);
    // Add vertical scroll bars to the TextBox control.
    textBox1.set_ScrollBars(ScrollBars.Vertical);
    // Allow the RETURN key to be entered in the TextBox control.
    textBox1.set_AcceptsReturn(true);
    // Allow the TAB key to be entered in the TextBox control.
    textBox1.set_AcceptsTab(true);
    // Set WordWrap to True to allow text to wrap to the next line.
    textBox1.set_WordWrap(true);
    // Set the default text of the control.
    textBox1.set_Text("Welcome!");
} //CreateMyMultilineTextBox

private function CreateMyMultilineTextBox()
 {
    // Create an instance of a TextBox control
    textBox1 = new TextBox();
    
    // Set the Multiline property to true.
    textBox1.Multiline = true;
    // Add vertical scroll bars to the TextBox control.
    textBox1.ScrollBars = ScrollBars.Vertical;
    // Allow the RETURN key to be entered in the TextBox control.
    textBox1.AcceptsReturn = true;
    // Allow the TAB key to be entered in the TextBox control.
    textBox1.AcceptsTab = true;
    // Set WordWrap to True to allow text to wrap to the next line.
    textBox1.WordWrap = true;
    // Set the default text of the control.
    textBox1.Text = "Welcome!";
 }
 

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.

.NET Framework

.NET Compact Framework