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.
Assembly: System.Web (in System.Web.dll)
| 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
Available since 1.1