次の方法で共有


HtmlContainerControl.InnerHtml プロパティ

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

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

構文

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

value = instance.InnerHtml

instance.InnerHtml = value
public virtual string InnerHtml { get; set; }
public:
virtual property String^ InnerHtml {
    String^ get ();
    void set (String^ value);
}
/** @property */
public String get_InnerHtml ()

/** @property */
public void set_InnerHtml (String value)
public function get InnerHtml () : String

public function set InnerHtml (value : String)
適用できません。

プロパティ値

HTML サーバー コントロールの開始タグと終了タグ間の HTML の内容。

例外

例外の種類 条件

HttpException

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

または

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

解説

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

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

たとえば、InnerHtml プロパティが "<b> Hello </b>" に設定されている場合は、< 文字と > 文字はそれぞれ &lt;&gt; には変換されません。表示される出力は <b> Hello </b> のままとなります。ブラウザは <b> タグを検出して、太字フォントで「Hello」と表示します。

注意に関するメモ注意 :

テキストは HTML でエンコードされないため、テキストに HTML タグ内のスクリプトを埋め込むことが可能になります。このプロパティの値がユーザー入力によって動的に設定される場合は、セキュリティ上の危険性を低減するために、必ず値を検証してください。詳細については、「セキュリティとユーザー入力」を参照してください。

自動的に HTML のエンコードとデコードを行うには、InnerText プロパティを使用します。

メモメモ :

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

使用例

InnerHtml プロパティを使用して、テキスト メッセージを動的に設定する方法を次のコード例に示します。

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

プラットフォーム

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 名前空間
InnerText
IsLiteralContent
HasControls
DataBoundLiteralControl