HtmlContainerControl.InnerText Proprietà
Definizione
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à
Testo contenuto tra i tag di apertura e di chiusura di un controllo server HTML.
- Attributi
Eccezioni
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 "<b> Hello </b>"
, i <
simboli e >
vengono convertiti rispettivamente in <
e >
. L'output di cui è stato eseguito il rendering sarà: < b > Hello < /b >. Le <
entità e >
indicano al browser che questi caratteri devono essere visualizzati nella pagina. Il browser non rileverà i <b>
tag e visualizzerà il testo in grassetto. Il testo visualizzato nella pagina è: <b> Hello </b>.
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.