HtmlTextArea.AddParsedSubObject Method (Object)

 

This API supports the product infrastructure and is not intended to be used directly from your code.

Notifies the HtmlTextArea control that an object was parsed and adds the object to the HtmlTextArea control's ControlCollection object.

Namespace:   System.Web.UI.HtmlControls
Assembly:  System.Web (in System.Web.dll)

Protected Overrides Sub AddParsedSubObject (
	obj As Object
)

Parameters

obj
Type: System.Object

An Object that represents the parsed element.

Exception Condition
HttpException

The object specified by the obj parameter can only be of the type LiteralControl or DataBoundLiteralControl.

The AddParsedSubObject method adds an object to the HtmlTextArea control's ControlCollection if the object is of the type LiteralControl or DataBoundLiteralControl; otherwise, an HttpException is thrown.

The AddParsedSubObject method is primarily used by control developers extending the functionality of the HtmlTextArea control.

The following code example demonstrates how to override the AddParsedSubObject method in a custom HtmlTextArea server control so that it always determines whether the parsed object is of the type LiteralControl or DataBoundLiteralControl.

<%@ 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>
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

.NET Framework
Available since 1.1
Return to top
Show: