HttpParseException Class
The exception that is thrown when a parse error occurs.
Assembly: System.Web (in System.Web.dll)
System.Exception
System.SystemException
System.Runtime.InteropServices.ExternalException
System.Web.HttpException
System.Web.HttpParseException
| Name | Description | |
|---|---|---|
![]() | HttpParseException() | Initializes a new instance of the HttpParseException class. |
![]() | HttpParseException(String) | Initializes a new instance of the HttpParseException class with a specified error message. |
![]() | HttpParseException(String, Exception) | Initializes a new instance of the HttpParseException class with a specified error message and a reference to the inner. |
![]() | HttpParseException(String, Exception, String, String, Int32) | Initializes a new instance of the HttpParseException class with specific information about the source code being compiled and the line number on which the exception occurred. |
| Name | Description | |
|---|---|---|
![]() | Data | Gets a collection of key/value pairs that provide additional user-defined information about the exception.(Inherited from Exception.) |
![]() | ErrorCode | Gets the HRESULT of the error.(Inherited from ExternalException.) |
![]() | FileName | Gets the name of the file being parsed when the error occurs. |
![]() | HelpLink | Gets or sets a link to the help file associated with this exception.(Inherited from Exception.) |
![]() | HResult | Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.(Inherited from Exception.) |
![]() | InnerException | |
![]() | Line | Gets the number of the line being parsed when the error occurs. |
![]() | Message | Gets a message that describes the current exception.(Inherited from Exception.) |
![]() | ParserErrors | Gets the parser errors for the current exception. |
![]() | Source | Gets or sets the name of the application or the object that causes the error.(Inherited from Exception.) |
![]() | StackTrace | Gets a string representation of the immediate frames on the call stack.(Inherited from Exception.) |
![]() | TargetSite | Gets the method that throws the current exception.(Inherited from Exception.) |
![]() | VirtualPath | Gets the virtual path to source file that generated the error. |
![]() | WebEventCode | Gets the event codes that are associated with the HTTP exception.(Inherited from HttpException.) |
| Name | Description | |
|---|---|---|
![]() | Equals(Object) | Determines whether the specified object is equal to the current object.(Inherited from Object.) |
![]() | GetBaseException() | |
![]() | GetHashCode() | Serves as the default hash function. (Inherited from Object.) |
![]() | GetHtmlErrorMessage() | Gets the HTML error message to return to the client.(Inherited from HttpException.) |
![]() | GetHttpCode() | Gets the HTTP response status code to return to the client. (Inherited from HttpException.) |
![]() | GetObjectData(SerializationInfo, StreamingContext) | When overridden in a derived class, sets the SerializationInfo object with information about the exception.(Overrides HttpException.GetObjectData(SerializationInfo, StreamingContext).) |
![]() | GetType() | Gets the runtime type of the current instance.(Inherited from Exception.) |
![]() | ToString() | Returns a string that contains the HRESULT of the error.(Inherited from ExternalException.) |
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
Available since 1.1
Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
.jpeg?cs-save-lang=1&cs-lang=vb)
.jpeg?cs-save-lang=1&cs-lang=vb)