HtmlContainerControl.InnerHtml Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.HtmlControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia zawartość znalezioną między znacznikami otwierania i zamykania określonej kontrolki serwera 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

Wartość właściwości

String

Zawartość HTML między otwieraniem i zamykaniem tagów kontrolki serwera HTML.

Atrybuty: BrowsableAttribute

Wyjątki

HttpException

Istnieje więcej niż jedna kontrolka serwera HTML.

-lub-

Kontrolka serwera HTML nie jest elementem LiteralControl lub .DataBoundLiteralControl

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą InnerHtml właściwości dynamicznie ustawić komunikat tekstowy.

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

Uwagi

InnerHtml Użyj właściwości , aby programowo zmodyfikować zawartość między tagami otwierania i zamykania kontrolki serwera HTML.

Właściwość InnerHtml nie koduje automatycznie znaków specjalnych do i z jednostek HTML. Jednostki HTML umożliwiają wyświetlanie znaków specjalnych, takich jak < znak, które przeglądarka zwykle interpretuje jako specjalne znaczenie. Znak < będzie interpretowany jako początek tagu i nie jest wyświetlany na stronie. Aby wyświetlić < znak, należy użyć jednostki <.

Jeśli na przykład InnerHtml właściwość jest ustawiona na " Hello ", < znaki i > nie są odpowiednio konwertowane na < i >. Renderowane dane wyjściowe nadal będą: Hello . Przeglądarka wykryje  tagi i wyświetli tekst Witaj, w pogrubionej czcionki.

Przestroga

Ponieważ tekst nie jest zakodowany w formacie HTML, można osadzić skrypt w tagach HTML w tekście. Jeśli ta właściwość jest ustawiana dynamicznie przy użyciu danych wejściowych użytkownika, sprawdź poprawność wartości w celu zmniejszenia luk w zabezpieczeniach. Aby uzyskać więcej informacji, zobacz Zabezpieczenia i dane wejściowe użytkownika.

Aby zapewnić automatyczne kodowanie i dekodowanie HTML, użyj InnerText właściwości .

Uwaga

Jeśli nie ma kontrolek podrzędnych, InnerHtml właściwość zawiera wartość String.Empty.

Dotyczy

Udostępnij za pośrednictwem