HtmlContainerControl.InnerHtml Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.HtmlControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví obsah nalezený mezi otevírací a uzavírací značky zadaného html server ovládacího prvku.

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íráním značek ovládacího prvku serveru HTML.

Atributy: BrowsableAttribute

Výjimky

HttpException

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

-nebo-

Serverový ovládací prvek HTML není LiteralControl nebo DataBoundLiteralControl.

Příklady

Následující příklad kódu ukazuje, jak použít InnerHtml vlastnost k dynamickému nastavení textové zprávy.

<%@ 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 Pomocí vlastnosti můžete programově upravovat obsah mezi otevírací a zavírací značkou serverového ovládacího prvku HTML.

Vlastnost InnerHtml automaticky nezakó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 se interpretoval jako začátek značky a na stránce se nezobrazuje. K zobrazení znaku < byste museli použít entitu <.

Pokud InnerHtml je například vlastnost nastavena na " Hello "hodnotu , < znaky a > se nepřevedou na < a >. Vykreslený výstup by stále byl: Hello . Prohlížeč rozpozná značky  a zobrazí text, Hello, tučným písmem.

Upozornění

Vzhledem k tomu, že text není zakódovaný ve formátu HTML, je možné do textu vložit skript do značek HTML. Pokud je tato vlastnost nastavena dynamicky pomocí vstupu uživatele, nezapomeňte ověřit hodnotu, aby se snížila ohrožení zabezpečení. Další informace najdete v tématu Zabezpečení a vstup uživatele.

Pokud chcete zajistit automatické kódování a dekódování HTML, použijte InnerText vlastnost .

Poznámka

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

Platí pro

Share via