HtmlContainerControl.InnerText-Eigenschaft

Artikel
08/20/2007

Ruft den Text zwischen den öffnenden und schließenden Tags 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 InnerText As String
'Usage
Dim instance As HtmlContainerControl
Dim value As String

value = instance.InnerText

instance.InnerText = value

public virtual string InnerText { get; set; }

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

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

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

public function get InnerText () : String

public function set InnerText (value : String)

Eigenschaftenwert

Der Text zwischen den öffnenden und schließenden Tags 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 InnerText-Eigenschaft können Sie den Text zwischen den Start- und Endtags eines HTML-Serversteuerelements programmgesteuert ändern.

Im Gegensatz zur InnerHtml-Eigenschaft codiert die InnerText-Eigenschaft Sonderzeichen 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 InnerText-Eigenschaft z. B. auf " Hello " festgelegt ist, werden das <-Symbol und das >-Symbol in < bzw. in > konvertiert. Die Ausgabe lautet dann: Hello . Die <-Entität und die >-Entität zeigen dem Browser an, dass diese Zeichen auf der Seite angezeigt werden müssen. Der Browser erkennt die -Tags nicht und zeigt den Text nicht fett formatiert an. Der auf der Seite angezeigte Text ist: Hello .

Mit der InnerHtml-Eigenschaft können Sie die automatische HTML-Codierung und -Decodierung deaktivieren.

Hinweis

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

Beispiel

Im folgenden Codebeispiel wird der über die InnerText-Eigenschaft verfügbare HTML-Codierungsdienst veranschaulicht.

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

<%@ 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="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.InnerText = "To make text bold, use the <b> tag."
  }

</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>
    <b><span id="Message" runat=server></span></b>
    </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
HtmlContainerControl.InnerHtml-Eigenschaft

Freigeben über