Sdílet prostřednictvím

HtmlContainerControl.InnerHtml Vlastnost

Definice

Obor názvů:
System.Web.UI.HtmlControls
Sestavení:
System.Web.dll

Získá nebo nastaví obsah nalezený mezi levou a pravou značkou zadaného ovládacího prvku serveru HTML.

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

Hodnota vlastnosti

String

Obsah HTML mezi otevřením a zavřením značek ovládacího prvku serveru HTML.

Atributy
BrowsableAttribute

Výjimky

HttpException

Existuje více než jeden ovládací prvek serveru HTML.

nebo

Ovládací prvek serveru HTML není nebo LiteralControlDataBoundLiteralControl.

Příklady

Následující příklad kódu ukazuje, jak použít InnerHtml vlastnost dynamicky nastavit textovou zprávu.

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

Poznámky

InnerHtml Vlastnost slouží k programové úpravě obsahu mezi levou a pravou značkou ovládacího prvku serveru HTML.

Vlastnost InnerHtml automaticky nekóduje speciální znaky do a z entit HTML. Entity HTML umožňují zobrazit speciální znaky, například < znak, který by prohlížeč obvykle interpretoval jako zvláštní význam. Znak < by byl interpretován jako začátek značky a není zobrazen na stránce. K zobrazení znaku < byste museli použít entitu &lt;.

Pokud InnerHtml je například vlastnost nastavena na "<b> Hello </b>", < a > znaky nejsou převedeny na &lt; a &gt;, v uvedeném pořadí. Vykreslený výstup by stále byl: <b> Hello </b>. Prohlížeč rozpozná <b> značky a zobrazí text Hello ve tučném písmu.

Upozornění

Vzhledem k tomu, že text není kódovaný html, je možné vložit skript do značek HTML do textu. Pokud je tato vlastnost nastavena dynamicky pomocí uživatelského vstupu, nezapomeňte ověřit hodnotu, která snižuje ohrožení zabezpečení. Další informace naleznete v tématu Zabezpečení a uživatelský vstup.

Chcete-li poskytnout automatické kódování HTML a dekódování, použijte InnerText vlastnost.

Poznámka:

Pokud neexistují žádné podřízené ovládací prvky, InnerHtml vlastnost obsahuje hodnotu String.Empty.

Platí pro

Viz také