次の方法で共有

HtmlTextArea.AddParsedSubObject メソッド

  • [アーティクル]

このメソッドは,.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

オブジェクトが解析されたことを HtmlTextArea コントロールに通知し、そのオブジェクトを HtmlTextArea コントロールの ControlCollection オブジェクトに追加します。

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

構文

'宣言
Protected Overrides Sub AddParsedSubObject ( _
    obj As Object _
)
'使用
Dim obj As Object

Me.AddParsedSubObject(obj)

protected override void AddParsedSubObject (
    Object obj
)

protected:
virtual void AddParsedSubObject (
    Object^ obj
) override

protected void AddParsedSubObject (
    Object obj
)

protected override function AddParsedSubObject (
    obj : Object
)

適用できません。

パラメータ

  • obj
    解析された要素を表す Object。

例外

例外の種類 条件

HttpException

obj パラメータによって指定されるオブジェクトが使用できる型は、LiteralControl または DataBoundLiteralControl のみです。

解説

AddParsedSubObject メソッドは、オブジェクトの型が LiteralControl または DataBoundLiteralControl である場合、HtmlTextArea コントロールの ControlCollection にそのオブジェクトを追加します。それ以外の場合は、HttpException がスローされます。

AddParsedSubObject メソッドは、主に、コントロール開発者が HtmlTextArea コントロールの機能を拡張する際に使用します。

使用例

解析されたオブジェクトの型が LiteralControl と DataBoundLiteralControl のどちらであるかを常に確認できるように、カスタムの HtmlTextArea サーバー コントロールの AddParsedSubObject メソッドをオーバーライドする方法を次のコード例に示します。

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>
<%@ Page Language="VB" AutoEventWireup="True" %>

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

  Sub Page_Load(sender As Object, e As EventArgs)

    HtmlTextArea1.Value = "Hello Html Text Area World."

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>Custom HtmlTextArea AddParsedSubObject Example</title>
  </head>

  <body>
    <form id="Form1" 
          method="post" 
          runat="server">

      <h3>Custom HtmlTextArea AddParsedSubObject Example</h3>

      <aspSample:CustomHtmlTextAreaAddParsedSubObject 
        id="HtmlTextArea1" 
        name="HtmlTextArea1" 
        runat="server" 
        rows="4" 
        cols="50" />
        
    </form>
  </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>
<%@ Page Language="C#" AutoEventWireup="True" %>

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

  void Page_Load(Object sender, EventArgs e)
  {
    HtmlTextArea1.Value = "Hello Html Text Area World.";
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>Custom HtmlTextArea AddParsedSubObject Example</title>
  </head>

  <body>
    <form id="Form1" 
          method="post" 
          runat="server">

      <h3>Custom HtmlTextArea AddParsedSubObject Example</h3>

      <aspSample:CustomHtmlTextAreaAddParsedSubObject 
        id="HtmlTextArea1" 
        name="HtmlTextArea1" 
        runat="server" 
        rows="4" 
        cols="50"/>
        
    </form>
  </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSl.Controls" Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
    <head>
        <title>Custom HtmlTextArea - AddParsedSubObject - VJ# Example</title>
    <script runat="server">
    void Page_Load(Object sender, EventArgs e) 
    {
        HtmlTextArea1.set_Value("Hello Html Text Area World.");
    } //Page_Load
    </script>
    </head>
    <body>
        <form id="Form1" method="post" runat="server">
            <h3>Custom HtmlTextArea - AddParsedSubObject - VJ# Example</h3>

      <aspSample:CustomHtmlTextAreaAddParsedSubObject 
        id="HtmlTextArea1" 
        name="HtmlTextArea1" 
        runat="server" 
        rows="4" 
        cols="50" />
        
        </form>
    </body>
</html>

Imports System.Web
Imports System.Security.Permissions

Namespace Samples.AspNet.VB.Controls

Public NotInheritable Class CustomHtmlTextAreaAddParsedSubObject
   Inherits System.Web.UI.HtmlControls.HtmlTextArea

        <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
        Protected Overrides Sub AddParsedSubObject(ByVal obj As Object)

            ' If the object is a LiteralControl or a DataBoundLiteralControl control, 
            ' then pass the object to the base class's AddParsedSubObject method.
            If TypeOf obj Is System.Web.UI.LiteralControl OrElse TypeOf obj Is System.Web.UI.DataBoundLiteralControl Then
                MyBase.AddParsedSubObject(obj)
            Else
                Throw New System.Web.HttpException("You cannot have a child control of type " _ 
                  & obj.GetType().Name.ToString() & ".")
            End If
        End Sub

End Class
End Namespace

using System.Web;
using System.Security.Permissions;

namespace Samples.AspNet.CS.Controls
{

  [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
  public sealed class CustomHtmlTextAreaAddParsedSubObject : System.Web.UI.HtmlControls.HtmlTextArea
  {
    protected override void AddParsedSubObject(object obj)
    {
      // If the object is a LiteralControl or a DataBoundLiteralControl control, 
      // then pass the object to the base class's AddParsedSubObject method.
      if (obj is System.Web.UI.LiteralControl || 
          obj is System.Web.UI.DataBoundLiteralControl)
      {
        base.AddParsedSubObject(obj);
      }
      else
      {
        throw new System.Web.HttpException("You cannot have a child control of type " 
         + obj.GetType().Name.ToString() + ".");
      }
    }
  }
}

package Samples.AspNet.JSL.Controls;

public class CustomHtmlTextAreaAddParsedSubObject
   extends System.Web.UI.HtmlControls.HtmlTextArea
{
    protected void AddParsedSubObject(Object obj)
        throws System.Web.HttpException
    {
        // If the object is a LiteralControl or a DataBoundLiteralControl  
        // control, then pass the object to the base's AddParsedSubObject method.
        if (obj instanceof System.Web.UI.LiteralControl 
            || obj instanceof System.Web.UI.DataBoundLiteralControl) {
            super.AddParsedSubObject(obj);
        }
        else {
            throw new System.Web.
                HttpException("You cannot have a child control of type " 
                + obj.GetType().get_Name().ToString());
        }
    } //AddParsedSubObject
} //CustomHtmlTextAreaAddParsedSubObject

プラットフォーム

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

参照

関連項目

HtmlTextArea クラス
HtmlTextArea メンバ
System.Web.UI.HtmlControls 名前空間
Control.AddParsedSubObject
LiteralControl
DataBoundLiteralControl

その他の技術情報

HTML サーバー コントロール