次の方法で共有

HtmlContainerControl.InnerText プロパティ

  • [アーティクル]

指定された HTML サーバー コントロールの開始タグと終了タグ間のテキストを取得または設定します。

名前空間: System.Web.UI.HtmlControls
アセンブリ: System.Web (system.web.dll 内)

構文

'宣言
Public Overridable Property InnerText As String
'使用
Dim instance As HtmlContainerControl
Dim value As String

value = instance.InnerText

instance.InnerText = value

public virtual string InnerText { get; set; }

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

/** @property */
public String get_InnerText ()

/** @property */
public void set_InnerText (String value)

public function get InnerText () : String

public function set InnerText (value : String)

適用できません。

プロパティ値

HTML サーバー コントロールの開始タグと終了タグ間のテキスト。

例外

例外の種類 条件

HttpException

複数の HTML サーバー コントロールがあります。

または

HTML サーバー コントロールが System.Web.UI.LiteralControl や System.Web.UI.DataBoundLiteralControl ではありません。

解説

InnerText プロパティを使用して、HTML サーバー コントロールの開始タグと終了タグ内のテキストをプログラムによって変更します。

InnerHtml プロパティとは異なり、InnerText プロパティは HTML エンティティへの特殊文字のエンコードや、その逆のエンコードを自動的に行います。HTML エンティティを使用すると、ブラウザが通常は特殊な意味をもつ文字として解釈する < 文字などの特殊文字を表示できます。< 文字はタグの開始として解釈され、ページには表示されません。< 文字を表示するには、エンティティ &lt; を使用する必要があります。

たとえば、InnerText プロパティが "<b> Hello </b>" に設定されている場合、< 記号と > 記号はそれぞれ &lt; と &gt; に変換されます。出力は &lt; b &gt; Hello &lt; /b &gt; となります。&lt; エンティティと &gt; エンティティは、ブラウザに対してこれらの文字をページに表示するよう指示します。ブラウザは <b> タグを検出せず、テキストを太字フォントで表示します。ページに表示されるテキストは <b> Hello </b> となります。

自動的に HTML のエンコーディングとデコードを行わないようにするは、InnerHtml プロパティを使用します。

メモメモ :

子コントロールがない場合、InnerHtml プロパティは String.Empty 値を格納します。

使用例

InnerText プロパティによって利用できる 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>      

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

  function Page_Load(Src: Object, E: EventArgs)
  {
    Message.InnerText = "To make text bold, use the <b> tag."
  }

</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>
    <b><span id="Message" runat="server"></span></b>
    </div>
    </form>
  </body>
</html>

プラットフォーム

Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

バージョン情報

.NET Framework

サポート対象 : 3.0,2.0,1.1,1.0

参照

関連項目

HtmlContainerControl クラス
HtmlContainerControl メンバ
System.Web.UI.HtmlControls 名前空間
HtmlContainerControl.InnerHtml プロパティ