HttpParseException Class
.NET Framework 3.0
The exception that is thrown when a parse error occurs.
Namespace: System.Web
Assembly: System.Web (in system.web.dll)
Assembly: System.Web (in system.web.dll)
'Declaration <SerializableAttribute> _ Public NotInheritable Class HttpParseException Inherits HttpException 'Usage Dim instance As HttpParseException
/** @attribute SerializableAttribute() */ public final class HttpParseException extends HttpException
SerializableAttribute public final class HttpParseException extends HttpException
Not applicable.
The HttpParseException class is an HTTP-specific exception class that enables ASP.NET to output parser exception information. For more information on throwing and handling exceptions, see Handling and Throwing Exceptions.
The following example demonstrates how to use the HttpParseException to customize errors generated during page parsing. In this example, a customized HtmlSelect control is defined. If child elements of the custom control are not of a specified type then an HttpParseException is thrown in the overridden GetChildControlType method of a custom HtmlSelectBuilder. To generate a parse exception, change the child element literal MyCustomOption to any other string.
<%@ Page Language="VB"%> <%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="Samples.AspNet.VB" %> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>HttpParseException Example</title> </head> <body> <form id="Form1" runat="server"> <h3>HttpParseException Example</h3> <aspSample:CustomHtmlSelectWithHttpParseException id="customhtmlselect1" runat="server"> <aspSample:MyCustomOption optionid="option1" value="1"/> <aspSample:MyCustomOption optionid="option2" value="2"/> <aspSample:MyCustomOption optionid="option3" value="3"/> </aspSample:CustomHtmlSelectWithHttpParseException> </form> </body> </html>
Imports System Imports System.Security.Permissions Imports System.Collections Imports System.Web Imports System.Web.UI Imports System.Web.UI.WebControls Imports System.Web.UI.HtmlControls Namespace Samples.AspNet.VB ' Define a child control for the custom HtmlSelect. Public Class MyCustomOption Private _id As String Private _value As String Public Property optionid() As String Get Return _id End Get Set(ByVal value As String) _id = value End Set End Property Public Property value() As String Get Return _value End Get Set(ByVal value As String) _value = value End Set End Property End Class ' Define a custom HtmlSelectBuilder. Public Class MyHtmlSelectBuilderWithparseException Inherits HtmlSelectBuilder <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _ Public Overrides Function GetChildControlType(ByVal tagName As String, ByVal attribs As IDictionary) As Type ' Distinguish between two possible types of child controls. If tagName.ToLower().EndsWith("mycustomoption") Then Return GetType(MyCustomOption) Else Throw New HttpParseException("This custom HtmlSelect control" & _ "requires child elements of the form ""MyCustomOption""") End If End Function End Class <ControlBuilderAttribute(GetType(MyHtmlSelectBuilderWithparseException))> _ Public Class CustomHtmlSelectWithHttpParseException Inherits HtmlSelect ' Override the AddParsedSubObject method. Protected Overrides Sub AddParsedSubObject(ByVal obj As Object) Dim _outputtext As String If TypeOf obj Is MyCustomOption Then _outputtext = "custom select option : " + CType(obj, MyCustomOption).value Dim li As New ListItem(_outputtext, CType(obj, MyCustomOption).value) MyBase.Items.Add(li) End If End Sub End Class End Namespace
- AspNetHostingPermission for operating in a hosted environment. Demand value: LinkDemand; Permission value: Minimal.
System.Object
System.Exception
System.SystemException
System.Runtime.InteropServices.ExternalException
System.Web.HttpException
System.Web.HttpParseException
System.Exception
System.SystemException
System.Runtime.InteropServices.ExternalException
System.Web.HttpException
System.Web.HttpParseException
Community Additions
ADD
Show: