Übersicht über das TextBox-Webserversteuerelement

Artikel
10/22/2014

Aktualisiert: November 2007

Mithilfe des TextBox-Webserver-Steuerelements können Informationen auf einer ASP.NET-Webseite eingegeben werden, z. B. Text, Zahlen und Datumsangaben.

Dieses Thema enthält folgende Abschnitte:

Background
Codebeispiele
Klassenreferenz

Background

Das TextBox-Serversteuerelement ist ein Eingabesteuerelement, in das der Benutzer Text eingeben kann. Standardmäßig ist die TextMode-Eigenschaft des Steuerelements auf TextBoxMode.SingleLine festgelegt, sodass ein einzeiliges Textfeld angezeigt wird. Sie können die TextMode-Eigenschaft jedoch auf TextBoxMode.MultiLine festlegen, um ein mehrzeiliges Textfeld anzuzeigen (das als textarea-Element gerendert wird). Sie können die TextMode-Eigenschaft auch zu TextBoxMode.Password ändern, um ein Textfeld anzuzeigen, das die Benutzereingabe maskiert. Der im TextBox-Steuerelement angezeigte Text wird mithilfe der Text-Eigenschaft verfügbar.

Sicherheitshinweis:
Durch Festlegen der TextMode-Eigenschaft auf TextBoxMode.Password können Sie sicherstellen, dass andere Benutzer ein Kennwort beim Eingeben nicht sehen können. Da der in das Textfeld eingegebene Text jedoch in keiner Weise verschlüsselt ist, sollten Sie diesen, wie alle anderen vertraulichen Daten auch, schützen. Zur Erhöhung der Sicherheit beim Übermitteln einer Seite, die ein Kennwort enthält, können Sie Secure Sockets Layer (SSL) und Verschlüsselung verwenden.

Durch Festlegen der TextMode-Eigenschaft auf TextBoxMode.Password können Sie sicherstellen, dass andere Benutzer ein Kennwort beim Eingeben nicht sehen können. Da der in das Textfeld eingegebene Text jedoch in keiner Weise verschlüsselt ist, sollten Sie diesen, wie alle anderen vertraulichen Daten auch, schützen. Zur Erhöhung der Sicherheit beim Übermitteln einer Seite, die ein Kennwort enthält, können Sie Secure Sockets Layer (SSL) und Verschlüsselung verwenden.

Sicherheitshinweis:
Benutzereingaben auf einer ASP.NET-Webseite können möglicherweise schädliche Clientskripts enthalten. Standardmäßig wird durch die ASP.NET-Webseite sichergestellt, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.

TextBox-Ereignisse

Wenn der Benutzer das Steuerelement verlässt, löst das TextBox-Steuerelement ein TextChanged-Ereignis aus. Standardmäßig wird das Ereignis nicht direkt ausgelöst, sondern erst auf dem Server, wenn die Seite gesendet wurde. Sie können jedoch festlegen, dass die Seite sofort nach Verlassen des Felds vom TextBox-Steuerelement an den Server übermittelt wird.

Das TextBox-Webserversteuerelement löst nicht bei jedem Tastendruck des Benutzers ein Ereignis aus, sondern erst, wenn der Benutzer das Steuerelement verlässt. Sie können das TextBox-Steuerelement so konfigurieren, dass Ereignisse clientseitig ausgelöst werden. Diese können mittels Clientskripts behandelt werden, was für die individuelle Behandlung bestimmter Tasten sinnvoll ist. Weitere Informationen finden Sie unter Clientskript in ASP.NET-Webseiten.

TextBox-Beschriftungen

Sie können Label-Steuerelemente verwenden, um Beschriftungen für TextBox-Steuerelemente zu erstellen. Die Beschriftung kann eine Zugriffstaste bestimmen, welche der Benutzer drücken kann, um zu dem TextBox-Steuerelement zu navigieren. Ausführliche Informationen finden Sie unter Gewusst wie: Verwenden von Label-Webserversteuerelementen als Beschriftungen.

Automatische Vervollständigung in Textfeldern

Viele Browser unterstützen ein Feature zur automatischen Vervollständigung, die Benutzern auf der Grundlage von Werten, die sie früher bereits eingegeben haben, hilft, Informationen in Textfelder einzugeben. Das genaue Verhalten der automatischen Vervollständigung hängt vom Browser ab. Im Allgemeinen speichern Browser die Werte basierend auf dem name-Attribut des Textfelds. Jedes Textfeld dieses Namens bietet dem Benutzer dieselben Werte an, auch auf unterschiedlichen Seiten. Einige Browser unterstützen auch ein vCard-Schema, das dem Benutzer die Möglichkeit bietet, im Browser ein Profil mit vordefinierten Werten für Vorname, Nachname, Telefon, E-Mail-Adresse usw. zu erstellen.

Das TextBox-Steuerelement unterstützt eine AutoCompleteType-Eigenschaft, die zur Steuerung des Browserverhaltens hinsichtlich der automatischen Vervollständigung die folgenden Optionen bereitstellt:

Automatische Vervollständigung deaktivieren. Wenn Sie für ein Textfeld keine automatische Vervollständigung wünschen, können Sie diese deaktivieren.
Geben Sie einen vCard-Wert an, der als Wert für die automatische Vervollständigung dient. Der Browser muss das vCard-Schema unterstützen.