TextBox.ReadOnly-Eigenschaft
Ruft einen Wert ab, der angibt, ob der Inhalt des TextBox-Steuerelements geändert werden kann, oder legt diesen Wert fest.
Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<BindableAttribute(True)> _
<ThemeableAttribute(False)> _
Public Overridable Property ReadOnly As Boolean
'Usage
Dim instance As TextBox
Dim value As Boolean
value = instance.ReadOnly
instance.ReadOnly = value
[BindableAttribute(true)]
[ThemeableAttribute(false)]
public virtual bool ReadOnly { get; set; }
[BindableAttribute(true)]
[ThemeableAttribute(false)]
public:
virtual property bool ReadOnly {
bool get ();
void set (bool value);
}
/** @property */
public boolean get_ReadOnly ()
/** @property */
public void set_ReadOnly (boolean value)
public function get ReadOnly () : boolean
public function set ReadOnly (value : boolean)
Eigenschaftenwert
true, wenn der Inhalt des TextBox-Steuerelements nicht geändert werden kann, andernfalls false. Der Standardwert ist false.
Hinweise
Mit der ReadOnly-Eigenschaft können Sie angeben, ob der Inhalt des TextBox-Steuerelements geändert werden kann. Wenn Sie diese Eigenschaft auf true festlegen, können Benutzer keinen Wert eingeben oder den vorhandenen Wert nicht ändern. Beachten Sie, dass der Benutzer des TextBox-Steuerelements diese Eigenschaft nicht ändern kann; dies kann nur der Entwickler.
Wichtig
Der Text-Wert eines TextBox-Steuerelements, dessen ReadOnly-Eigenschaft auf true festgelegt ist, wird an den Server gesendet, wenn ein Postback erfolgt. Der Server verarbeitet jedoch keine schreibgeschützten Textfelder. Dadurch wird verhindert, dass böswillige Benutzer einen Text-Wert ändern, der schreibgeschützt ist. Der Wert der Text-Eigenschaft wird zwischen Postbacks im Ansichtszustand beibehalten, es sei denn, er wird durch serverseitigen Code geändert.
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.
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie Änderungen an dem im TextBox-Steuerelement angezeigten Text mithilfe der ReadOnly-Eigenschaft verhindert werden können.
<%@ 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
TextBox.MaxLength-Eigenschaft