Freigeben über

HtmlContainerControl.InnerHtml Eigenschaft

Definition

Namespace:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

Dient zum Abrufen oder Festlegen des Inhalts zwischen den öffnenden und schließenden Tags des angegebenen HTML-Serversteuerelements.

public:
 virtual property System::String ^ InnerHtml { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Browsable(false)]
public virtual string InnerHtml { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.InnerHtml : string with get, set
Public Overridable Property InnerHtml As String

Eigenschaftswert

String

Der HTML-Inhalt zwischen öffnenden und schließenden Tags eines HTML-Serversteuerelements.

Attribute
BrowsableAttribute

Ausnahmen

HttpException

Es gibt mehrere HTML-Serversteuerelemente.

- oder -

Das HTML-Serversteuerelement ist weder ein LiteralControl noch ein DataBoundLiteralControl.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die InnerHtml Eigenschaft zum dynamischen Festlegen einer Textnachricht verwendet wird.

<%@ 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="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>

Hinweise

Verwenden Sie die InnerHtml Eigenschaft, um den Inhalt zwischen den öffnenden und schließenden Tags eines HTML-Serversteuerelements programmgesteuert zu ändern.

Die InnerHtml Eigenschaft codiert sonderzeichen nicht automatisch in und aus HTML-Entitäten. MIT HTML-Entitäten können Sie Sonderzeichen wie das < Zeichen anzeigen, die ein Browser normalerweise als besondere Bedeutung interpretiert. Das < Zeichen würde als Anfang eines Tags interpretiert und nicht auf der Seite angezeigt. Um das < Zeichen anzuzeigen, müssen Sie die Entität &lt;verwenden.

Wenn die InnerHtml Eigenschaft z. B. auf "<b> Hello </b>"" festgelegt ist , werden die < Zeichen > nicht in bzw&gt;. in diese konvertiert&lt;. Die gerenderte Ausgabe wäre weiterhin: <b> Hello </b>. Der Browser erkennt die <b> Tags und zeigt den Text Hello in einer fett formatierten Schriftart an.

Vorsicht

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

Verwenden Sie die InnerText Eigenschaft, um die automatische HTML-Codierung und -Decodierung bereitzustellen.

Hinweis

Wenn keine untergeordneten Steuerelemente vorhanden sind, enthält die InnerHtml Eigenschaft den Wert String.Empty.

Gilt für:

Weitere Informationen