HtmlContainerControl.InnerHtml Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

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 den Start- und Endtags eines HTML-Serversteuerelements.

Attribute: BrowsableAttribute

Ausnahmen

HttpException

Es sind mehrere HTML-Serversteuerelemente vorhanden.

- oder -

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die InnerHtml -Eigenschaft verwendet wird, um eine Textnachricht dynamisch festzulegen.

<%@ 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 Nicht automatisch Sonderzeichen in und aus HTML-Entitäten. HTML-Entitäten ermöglichen ihnen die Anzeige von Sonderzeichen, z. B. das < Zeichen, die normalerweise von einem Browser als besondere Bedeutung interpretiert werden. Das < Zeichen wird als Anfang eines Tags interpretiert und nicht auf der Seite angezeigt. Zum Anzeigen des < Zeichens müssen Sie die Entität <verwenden.

Z. B. wenn die InnerHtml -Eigenschaftensatz auf " Hello ", < und > Zeichen werden nicht konvertiert, um < und >bzw. Die gerenderte Ausgabe lautet weiterhin: Hallo . Der Browser erkennt die  Tags und zeigt den Text Hello in einer fett formatierten Schriftart an.

Achtung

Da der Text nicht HTML-codiert ist, ist es möglich, Skripts in HTML-Tags in den Text einzubetten. Wenn diese Eigenschaft dynamisch mithilfe von Benutzereingaben festgelegt wird, müssen Sie den Wert überprüfen, um Sicherheitsrisiken zu verringern. Weitere Informationen finden Sie unter Sicherheit und Benutzereingabe.

Verwenden Sie die -Eigenschaft, um die InnerText 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:

Freigeben über