HtmlTextArea.AddParsedSubObject メソッド

.NET Framework クラス ライブラリ リファレンス

HtmlTextArea.AddParsedSubObject メソッド

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

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

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

Visual Basic (宣言)

Protected Overrides Sub
 AddParsedSubObject ( _
    obj As Object _
)

Visual Basic (使用法)

Dim obj As Object

Me.AddParsedSubObject(obj)

C#

protected override void AddParsedSubObject
 (
    Object obj
)

C++

protected:
virtual void AddParsedSubObject (
    Object^ obj
) override

J#

protected void AddParsedSubObject (
    Object obj
)

JScript

protected override function AddParsedSubObject
 (
    obj : Object
)

パラメータ

obj

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

例外

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

解説

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

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

使用例

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

Visual Basic

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

<script runat="server">

  Sub Page_Load(sender As Object,
 e As EventArgs)

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

  End Sub

</script>

<html>
  <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>

C#

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

<script runat="server">

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

</script>

<html>
  <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>

J#

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.JSl.Controls"
 Assembly="Samples.AspNet.JSL" %>
<%@ Page Language="VJ#" AutoEventWireup="True" %>
<HTML>
    <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>

Visual Basic

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

C#

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() + ".");
      }
    }
  }
}

J#

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 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
HtmlTextArea クラス
HtmlTextArea メンバ
System.Web.UI.HtmlControls 名前空間
Control.AddParsedSubObject
LiteralControl
DataBoundLiteralControl
その他の技術情報
HTML サーバー コントロール