Freigeben über

HtmlContainerControl-Klasse

  • Artikel

Fungiert als die abstrakte Basisklasse für HTML-Serversteuerelemente, die HTML-Elementen zugeordnet sind, für die ein Start- und ein Endtag erforderlich ist.

Namespace: System.Web.UI.HtmlControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public MustInherit Class HtmlContainerControl
    Inherits HtmlControl
'Usage
Dim instance As HtmlContainerControl

public abstract class HtmlContainerControl : HtmlControl

public ref class HtmlContainerControl abstract : public HtmlControl

public abstract class HtmlContainerControl extends HtmlControl

public abstract class HtmlContainerControl extends HtmlControl

Hinweise

Die am häufigsten verwendeten Steuerelemente mit einem Endtag sind das <form>-Element, das <table>-Element, das <tr>-Element, das <td>-Element, das <a>-Element und das <span>-Element.

Die InnerText-Eigenschaft und die InnerHtml-Eigenschaft ermöglichen das Bearbeiten des Inhalts zwischen den Start- und Endtags in von HtmlContainerControl abgeleiteten Steuerelementen.

Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz von HtmlContainerControl finden Sie unter HtmlContainerControl-Konstruktor.

Eine neue Instanz dieser Klasse wird nicht direkt erstellt.

Warnung

Wenn Sie die InnerHtml-Eigenschaft verwenden, um den Text zwischen den öffnenden und schließenden Tags eines HTML-Serversteuerelements anzugeben, ist der Text nicht HTML-codiert. Auf diese Weise können Skripts in HTML-Tags im Text eingebettet werden. Wenn Sie die InnerHtml-Eigenschaft verwenden, müssen Sie den Wert zur Reduzierung von Sicherheitsrisiken validieren. Andernfalls können Sie stattdessen auch die InnerText-Eigenschaft verwenden.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe der InnerHtml-Eigenschaft dieser Klasse eine Meldung auf einer Webseite dynamisch generiert wird.

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

    Message.InnerHtml = Server.HtmlEncode("Welcome! You accessed this page at: " & DateTime.Now)

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>HtmlContainerControl Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <span id="Message" runat=server></span>    
    </div>
    </form>
</body>
</html>    

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  protected void Page_Load(object sender, EventArgs e)
  {
    Message.InnerHtml = Server.HtmlEncode("Welcome! You accessed this page at: " + DateTime.Now);
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HtmlContainerControl Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <span id="Message" runat=server></span>    
    </div>
    </form>
</body>
</html>    

<%@ Page Language="JScript" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  function Page_Load(Src: Object, E: EventArgs)
  {
    Message.InnerHtml = Server.HtmlEncode("Welcome! You accessed this page at: " + DateTime.Now)
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HtmlContainerControl Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <span id="Message" runat=server></span>    
    </div>
    </form>
</body>
</html>

.NET Framework-Sicherheit

Vererbungshierarchie

System.Object
   System.Web.UI.Control
     System.Web.UI.HtmlControls.HtmlControl
      System.Web.UI.HtmlControls.HtmlContainerControl
         Abgeleitete Klassen

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

HtmlContainerControl-Member
System.Web.UI.HtmlControls-Namespace
HtmlControl