HtmlContainerControl.InnerText 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 testo fra i tag di apertura e chiusura del controllo server HTML specificato.

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

[System.ComponentModel.Browsable(false)]
public virtual string InnerText { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.InnerText : string with get, set

Public Overridable Property InnerText As String

Valore della proprietà

String

Testo contenuto 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 il servizio di codifica HTML disponibile tramite la InnerText proprietà .

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

Commenti

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

A differenza della InnerHtml proprietà , la InnerText proprietà 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 InnerText proprietà è impostata su " Hello ", i < simboli e > vengono convertiti rispettivamente in < e >. L'output di cui è stato eseguito il rendering sarà: Hello . Le < entità e > indicano al browser che questi caratteri devono essere visualizzati nella pagina. Il browser non rileverà i  tag e visualizzerà il testo in grassetto. Il testo visualizzato nella pagina è: Hello .

Per evitare la codifica HTML automatica e la decodifica, utilizzare la InnerHtml proprietà .

Nota

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

Si applica a

Vedi anche

InnerHtml