HtmlContainerControl.InnerHtml Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.HtmlControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta il contenuto presente fra i tag di apertura e chiusura del controllo server HTML specificato.

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

Valore della proprietà

String

Il contenuto HTML tra i tag di apertura e di chiusura di un controllo server HTML.

Attributi: BrowsableAttribute

Eccezioni

HttpException

Esistono più controlli server HTML.

-oppure-

Il controllo server HTML non è un LiteralControl o un DataBoundLiteralControl .

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare la InnerHtml proprietà per impostare dinamicamente un messaggio di testo.

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

Commenti

Utilizzare la InnerHtml proprietà per modificare a livello di codice il contenuto tra i tag di apertura e chiusura di un controllo server HTML.

La InnerHtml proprietà non codifica automaticamente caratteri speciali da e verso entità HTML. Le entità HTML consentono di visualizzare caratteri speciali, ad esempio il < carattere, che un browser interpreta normalmente come un significato speciale. Il < carattere viene interpretato come l'inizio di un tag e non viene visualizzato nella pagina. Per visualizzare il < carattere, è necessario usare l'entità <.

Ad esempio, se la InnerHtml proprietà è impostata su " Hello ", i < caratteri e > non vengono convertiti rispettivamente in < e >. L'output di cui è stato eseguito il rendering sarà ancora: Hello . Il browser rileverà i  tag e visualizzerà il testo Hello in grassetto.

Attenzione

Poiché il testo non è codificato in HTML, è possibile incorporare lo script all'interno di tag HTML nel testo. Se questa proprietà viene impostata in modo dinamico usando l'input dell'utente, assicurarsi di convalidare il valore per ridurre le vulnerabilità di sicurezza. Per altre informazioni, vedere Sicurezza e input utente.

Per fornire la codifica HTML e la decodifica automatica, utilizzare la InnerText proprietà .

Nota

Se non sono presenti controlli figlio, la InnerHtml proprietà contiene il valore String.Empty.

Si applica a

Share via