HtmlTextArea-Klasse
Ermöglicht den programmgesteuerten Zugriff auf das <textarea>-HTML-Element auf dem Server.
Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
<ValidationPropertyAttribute("Value")> _
Public Class HtmlTextArea
Inherits HtmlContainerControl
Implements IPostBackDataHandler
'Usage
Dim instance As HtmlTextArea
[ValidationPropertyAttribute("Value")]
public class HtmlTextArea : HtmlContainerControl, IPostBackDataHandler
[ValidationPropertyAttribute(L"Value")]
public ref class HtmlTextArea : public HtmlContainerControl, IPostBackDataHandler
/** @attribute ValidationPropertyAttribute("Value") */
public class HtmlTextArea extends HtmlContainerControl implements IPostBackDataHandler
ValidationPropertyAttribute("Value")
public class HtmlTextArea extends HtmlContainerControl implements IPostBackDataHandler
Hinweise
Das HtmlTextArea-Steuerelement entspricht dem <textarea>-HTML-Element, mit dem Sie ein mehrzeiliges Textfeld auf einer Webseite erstellen können. Verwenden Sie dieses Steuerelement zum programmgesteuerten Bearbeiten eines <textarea>-HTML-Elements.
Mit dieser Klasse können Sie die Höhe und Breite eines mehrzeiligen Textfelds steuern, indem Sie die Rows-Eigenschaft bzw. die Cols-Eigenschaft festlegen. Sie können dem Steuerelement auch einen Namen zuweisen, indem Sie die Name-Eigenschaft festlegen. Mithilfe der Value-Eigenschaft können Sie den im Textfeld enthaltenen Text ermitteln oder festlegen.
Die HtmlTextArea-Klasse stellt ein ServerChange-Ereignis bereit, mit dem Sie immer dann eine Reihe von benutzerdefinierten Anweisungen ausführen können, wenn der Wert des Textfelds zwischen Bereitstellungen auf dem Server geändert wird. Dieses Ereignis wird i. d. R. zur Datenvalidierung verwendet.
Hinweis
Wenn Sie ein einzeiliges Textfeld erstellen möchten, verwenden Sie das HtmlInputText-Steuerelement.
Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz von HtmlTextArea finden Sie unter HtmlTextArea-Konstruktor.
Warnung
Dieses Steuerelement kann zum Anzeigen von Benutzereingaben verwendet werden, die möglicherweise böswillige Clientskripts enthalten. Überprüfen Sie alle von einem Client gesendeten Informationen auf ausführbare Skripts, SQL-Anweisungen oder anderen Code, bevor Sie sie in der Anwendung anzeigen. ASP.NET stellt ein Validierungsfeature für Eingabeanforderungen bereit, um Skripts und HTML in Benutzereingaben zu blockieren. Validierungs-Serversteuerelemente werden ebenfalls bereitgestellt, um Benutzereingaben zu bewerten. Weitere Informationen finden Sie unter Syntax von Validierungs-Serversteuerelementen.
| Thema | Position |
|---|---|
| Gewusst wie: Hinzufügen von HTML-Serversteuerelementen zu einer Webseite mithilfe von ASP.NET-Syntax | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Hinzufügen von HTML-Serversteuerelementen zu einer Webseite mithilfe von ASP.NET-Syntax | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Hinzufügen von HTML-Serversteuerelementen zu einer Webseite mithilfe von ASP.NET-Syntax | Erstellen von ASP.NET-Webanwendungen |
| Gewusst wie: Programmgesteuertes Festlegen der Eigenschaften von HTML-Serversteuerelementen | Erstellen von ASP.NET-Webanwendungen |
Beispiel
Im folgenden Codebeispiel wird veranschaulicht, wie mit dem HtmlTextArea-Steuerelement ein mehrzeiliges Textfeld erstellt wird.
<%@ Page Language="VB" AutoEventWireup="True" %>
<script runat="server">
Sub SubmitBtn_Click(ByVal sender As Object, ByVal e As EventArgs)
Span1.InnerHtml = "You wrote: <br>" + TextArea1.Value
End Sub
</script>
<html>
<head>
<title>HtmlTextArea Example</title>
</head>
<body>
<form runat="server">
<h3>HtmlTextArea Example</h3>
Enter your comments: <br>
<textarea id="TextArea1"
runat="server"/>
<br>
<input type="submit"
value="Submit"
onserverclick="SubmitBtn_Click"
runat="server"/>
<p>
<span id="Span1"
runat="server" />
</form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>
<script runat="server">
void SubmitBtn_Click(Object sender, EventArgs e)
{
Span1.InnerHtml = "You wrote: <br>" + TextArea1.Value;
}
</script>
<html>
<head>
<title>HtmlTextArea Example</title>
</head>
<body>
<form runat=server>
<h3>HtmlTextArea Example</h3>
Enter your comments: <br>
<textarea id="TextArea1"
runat="server"/>
<br>
<input type="submit"
value="Submit"
onserverclick="SubmitBtn_Click"
runat="server"/>
<p>
<span id="Span1"
runat="server" />
</form>
</body>
</html>
.NET Framework-Sicherheit
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: LinkDemand, Berechtigungswert: Minimal
- AspNetHostingPermission für den Betrieb in einer Hostumgebung. Anforderungswert: InheritanceDemand, Berechtigungswert: Minimal
Vererbungshierarchie
System.Object
System.Web.UI.Control
System.Web.UI.HtmlControls.HtmlControl
System.Web.UI.HtmlControls.HtmlContainerControl
System.Web.UI.HtmlControls.HtmlTextArea
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
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
HtmlTextArea-Member
System.Web.UI.HtmlControls-Namespace
Rows
Cols
Value
Name
ServerChange
HtmlInputText-Klasse