Freigeben über

HtmlContainerControl.InnerText Eigenschaft

Definition

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

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

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

Eigenschaftswert

String

Der Text zwischen dem Öffnen 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 der über die InnerText Eigenschaft verfügbare HTML-Codierungsdienst veranschaulicht.

<%@ 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 Src, EventArgs E)
  {
    Message.InnerText = "To make text bold, use the <b> tag.";
    
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HtmlContainerControl Example</title>
</head>
  <body>
    <form id="form1" runat="server">
    <div>
    <b><span id="Message" runat="server"></span></b>
    </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 Src As Object, ByVal E As EventArgs)
    
    Message.InnerText = "To make text bold, use the <b> tag."
    
  End Sub

</script>

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

Hinweise

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

Im Gegensatz zu der InnerHtml Eigenschaft codiert die InnerText Eigenschaft automatisch Sonderzeichen 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 InnerText Eigenschaft z. B. auf "<b> Hello </b>""" festgelegt ist, werden die < Symbole > in bzw&gt;. in diese konvertiert&lt;. Die gerenderte Ausgabe wäre: < b > Hello < /b >. Die &lt; Und &gt; Entitäten geben dem Browser an, dass diese Zeichen auf der Seite angezeigt werden sollen. Der Browser erkennt die <b> Tags nicht und zeigt den Text in einer fett formatierten Schriftart an. Der auf der Seite angezeigte Text lautet: <b> Hello </b>.

Verwenden Sie die InnerHtml Eigenschaft, um die automatische HTML-Codierung und -Decodierung zu verhindern.

Hinweis

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

Gilt für:

Weitere Informationen