HtmlContainerControl.InnerHtml-Eigenschaft

Artikel
08/20/2007

Ruft den Inhalt zwischen den Start- und Endtags des angegebenen HTML-Serversteuerelements ab oder legt diesen fest.

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

Syntax

'Declaration
Public Overridable Property InnerHtml As String
'Usage
Dim instance As HtmlContainerControl
Dim value As String

value = instance.InnerHtml

instance.InnerHtml = value

public virtual string InnerHtml { get; set; }

public:
virtual property String^ InnerHtml {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_InnerHtml ()

/** @property */
public void set_InnerHtml (String value)

public function get InnerHtml () : String

public function set InnerHtml (value : String)

Eigenschaftenwert

Der HTML-Inhalt zwischen den Start- und Endtags eines HTML-Serversteuerelements.

Ausnahmen

Ausnahmetyp	Bedingung
HttpException	Es sind mehrere HTML-Serversteuerelemente vorhanden. - oder - Das HTML-Serversteuerelement ist weder ein System.Web.UI.LiteralControl noch ein System.Web.UI.DataBoundLiteralControl.

HttpException

Es sind mehrere HTML-Serversteuerelemente vorhanden.

- oder -

Das HTML-Serversteuerelement ist weder ein System.Web.UI.LiteralControl noch ein System.Web.UI.DataBoundLiteralControl.

Hinweise

Mit der InnerHtml-Eigenschaft können Sie den Inhalt zwischen den Start- und Endtags eines HTML-Serversteuerelements programmgesteuert ändern.

Die InnerHtml-Eigenschaft codiert Sonderzeichen nicht automatisch in oder aus HTML-Entitäten. HTML-Entitäten ermöglichen die Anzeige von Sonderzeichen, denen der Browser normalerweise eine Sonderbedeutung zuordnet, z. B. das <-Zeichen. Das <-Zeichen wird üblicherweise als Anfang eines Tags interpretiert und auf der Seite nicht angezeigt. Um das <-Zeichen anzuzeigen, müssen Sie die Entität < verwenden.

Wenn die InnerHtml-Eigenschaft z. B. auf " Hello " festgelegt ist, werden das <-Zeichen und das >-Zeichen nicht in < bzw. in > konvertiert. Die Ausgabe lautet weiterhin: Hello . Der Browser erkennt die -Tags und zeigt den Text "Hello" fett formatiert an.

Warnung

Da der Text nicht HTML-codiert ist, können Skripts in HTML-Tags in Text eingebettet werden. Wenn diese Eigenschaft mithilfe von Benutzereingaben dynamisch festgelegt wird, müssen Sie den Wert zur Reduzierung von Sicherheitsrisiken überprüfen. Weitere Informationen finden Sie unter Sicherheit und Benutzereingaben.

Die automatische HTML-Codierung und -Decodierung stellen Sie über die InnerText-Eigenschaft bereit.

Hinweis

Wenn es keine untergeordneten Steuerelemente gibt, enthält die InnerHtml-Eigenschaft den Wert String.Empty.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mit der InnerHtml-Eigenschaft eine Textmeldung dynamisch festgelegt 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>

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-Klasse
HtmlContainerControl-Member
System.Web.UI.HtmlControls-Namespace
InnerText
IsLiteralContent
HasControls
DataBoundLiteralControl

Freigeben über