TextBox.TextMode-Eigenschaft
Ruft den Verhaltensmodus (einzeilig, mehrzeilig oder Kennwort) des TextBox-Steuerelements ab oder legt diesen fest.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<ThemeableAttribute(False)> _
Public Overridable Property TextMode As TextBoxMode
'Usage
Dim instance As TextBox
Dim value As TextBoxMode
value = instance.TextMode
instance.TextMode = value
[ThemeableAttribute(false)]
public virtual TextBoxMode TextMode { get; set; }
[ThemeableAttribute(false)]
public:
virtual property TextBoxMode TextMode {
TextBoxMode get ();
void set (TextBoxMode value);
}
/** @property */
public TextBoxMode get_TextMode ()
/** @property */
public void set_TextMode (TextBoxMode value)
public function get TextMode () : TextBoxMode
public function set TextMode (value : TextBoxMode)
Eigenschaftenwert
Einer der TextBoxMode-Enumerationswerte. Der Standardwert ist SingleLine.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
Der angegebene Modus gehört nicht zu den TextBoxMode-Enumerationswerten. |
Hinweise
Mit der TextMode-Eigenschaft können Sie festlegen, ob ein TextBox-Steuerelement als einzeiliges, mehrzeiliges oder als Kennworttextfeld angezeigt wird.
Wenn sich das TextBox-Steuerelement im mehrzeiligen Modus befindet, können Sie durch Festlegen der Rows-Eigenschaft angeben, wie viele Zeilen angezeigt werden. Durch Festlegen der Wrap-Eigenschaft können Sie außerdem angeben, ob der Text umbrochen werden soll.
Wenn sich das TextBox-Steuerelement im Kennwortmodus befindet, werden alle in das Steuerelement eingegebenen Zeichen maskiert.
Diese Eigenschaft kann nicht durch Designs oder Stylesheetdesigns festgelegt werden. Weitere Informationen finden Sie unter ThemeableAttribute und Übersicht über ASP.NET-Designs und ASP.NET-Skins.
| Thema | Position |
|---|---|
| Gewusst wie: Abrufen und Festlegen von Werten in TextBox-Webserversteuerelementen | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Einrichten eines TextBox-Webserversteuerelements für die Kennworteingabe | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Abrufen und Festlegen von Werten in TextBox-Webserversteuerelementen | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Einrichten eines TextBox-Webserversteuerelements für die Kennworteingabe | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Abrufen und Festlegen von Werten in TextBox-Webserversteuerelementen | Erstellen von ASP.NET-Webanwendungen |
| Gewusst wie: Einrichten eines TextBox-Webserversteuerelements für die Kennworteingabe | Erstellen von ASP.NET-Webanwendungen |
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe der TextMode-Eigenschaft ein mehrzeiliges Textfeld angegeben wird.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
Protected Sub SubmitButton_Click(sender As Object, e As EventArgs )
Message.Text = "Thank you for your comment: <br>" + Comment.Text
End Sub
Protected Sub Check_Change(sender As Object, e As EventArgs )
Comment.Wrap = WrapCheckBox.Checked
Comment.ReadOnly = ReadOnlyCheckBox.Checked
End Sub
</script>
</head>
<body>
<form runat="server">
<h3> MultiLine TextBox Example </h3>
Please enter a comment and click the submit button.
<br><br>
<asp:TextBox ID="Comment"
TextMode="MultiLine"
Columns="50"
Rows="5"
runat="server"/>
<br>
<asp:RequiredFieldValidator
ID="Value1RequiredValidator"
ControlToValidate="Comment"
ErrorMessage="Please enter a comment.<br>"
Display="Dynamic"
runat="server"/>
<asp:CheckBox ID="WrapCheckBox"
Text="Wrap Text"
Checked="True"
AutoPostBack="True"
OnCheckedChanged="Check_Change"
runat="server"/>
<asp:CheckBox ID="ReadOnlyCheckBox"
Text="ReadOnly"
Checked="False"
AutoPostBack="True"
OnCheckedChanged="Check_Change"
runat="server"/>
<asp:Button ID="SubmitButton"
Text="Submit"
OnClick="SubmitButton_Click"
runat="server"/>
<hr>
<asp:Label ID="Message"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
<script runat="server">
protected void SubmitButton_Click(Object sender, EventArgs e)
{
Message.Text = "Thank you for your comment: <br>" + Comment.Text;
}
protected void Check_Change(Object sender, EventArgs e)
{
Comment.Wrap = WrapCheckBox.Checked;
Comment.ReadOnly = ReadOnlyCheckBox.Checked;
}
</script>
</head>
<body>
<form runat="server">
<h3> MultiLine TextBox Example </h3>
Please enter a comment and click the submit button.
<br><br>
<asp:TextBox ID="Comment"
TextMode="MultiLine"
Columns="50"
Rows="5"
runat="server"/>
<br>
<asp:RequiredFieldValidator
ID="Value1RequiredValidator"
ControlToValidate="Comment"
ErrorMessage="Please enter a comment.<br>"
Display="Dynamic"
runat="server"/>
<asp:CheckBox ID="WrapCheckBox"
Text="Wrap Text"
Checked="True"
AutoPostBack="True"
OnCheckedChanged="Check_Change"
runat="server"/>
<asp:CheckBox ID="ReadOnlyCheckBox"
Text="ReadOnly"
Checked="False"
AutoPostBack="True"
OnCheckedChanged="Check_Change"
runat="server"/>
<asp:Button ID="SubmitButton"
Text="Submit"
OnClick="SubmitButton_Click"
runat="server"/>
<hr>
<asp:Label ID="Message"
runat="server"/>
</form>
</body>
</html>
Plattformen
Windows 98, Windows 2000 SP4, 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
TextBox-Klasse
TextBox-Member
System.Web.UI.WebControls-Namespace
TextBoxMode
TextBox.Rows-Eigenschaft
Wrap