HttpParseException Classe

Definição

Namespace:: System.Web

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

A exceção gerada quando ocorre um erro de análise.

public ref class HttpParseException sealed : System::Web::HttpException

public sealed class HttpParseException : System.Web.HttpException

[System.Serializable]
public sealed class HttpParseException : System.Web.HttpException

type HttpParseException = class
    inherit HttpException

[<System.Serializable>]
type HttpParseException = class
    inherit HttpException

Public NotInheritable Class HttpParseException
Inherits HttpException

Herança: Object

Exception

SystemException

ExternalException

HttpException
HttpParseException

Atributos: SerializableAttribute

Exemplos

O exemplo a seguir demonstra como usar a personalização de HttpParseException erros gerados durante a análise de páginas. Neste exemplo, um controle personalizado HtmlSelect é definido. Se os elementos filho do controle personalizado não forem de um tipo especificado, um HttpParseException será lançado no método substituído GetChildControlType de um personalizado HtmlSelectBuilder. Para gerar uma exceção de análise, altere o literal MyCustomOption do elemento filho para qualquer outra cadeia de caracteres.

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

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

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

using System;
using System.Security.Permissions;
using System.Collections;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.HtmlControls;

namespace Samples.AspNet.CS
{
    // Define a child control for the custom HtmlSelect.
    public class MyCustomOption
    {
        string _id;
        string _value;

        public string optionid
        {
            get
            { return _id; }
            set
            { _id = value; }
        }

        public string value
        {
            get
            { return _value; }
            set
            { _value = value; }
        }
    }

    // Define a custom HtmlSelectBuilder.
    public class MyHtmlSelectBuilderWithparseException : HtmlSelectBuilder
    {
        [AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
        public override Type GetChildControlType(string tagName, IDictionary attribs)
        {
            // Distinguish between two possible types of child controls.
            if (tagName.ToLower().EndsWith("mycustomoption"))
            {
                return typeof(MyCustomOption);
            }
            else
            {
                throw new HttpParseException("This custom HtmlSelect control" +                                                  "requires child elements of the form \"MyCustomOption\"");
            }
        }
    }

    [ControlBuilderAttribute(typeof(MyHtmlSelectBuilderWithparseException))]
    public class CustomHtmlSelectWithHttpParseException : HtmlSelect
    {
        // Override the AddParsedSubObject method.
        protected override void AddParsedSubObject(object obj)
        {

            string _outputtext;
            if (obj is MyCustomOption)
            {
                _outputtext = "custom select option : " + ((MyCustomOption)obj).value;
                ListItem li = new ListItem(_outputtext, ((MyCustomOption)obj).value);
                base.Items.Add(li);
            }
        }
    }
}

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

Comentários

A classe HttpParseException é uma classe de exceção específica de HTTP que permite ASP.NET para gerar informações de exceção do analisador. Para obter mais informações sobre como gerar e lidar com exceções, consulte Exceções.

Construtores

Nome	Description
HttpParseException()	Inicializa uma nova instância da classe HttpParseException.
HttpParseException(String, Exception, String, String, Int32)	Inicializa uma nova instância da HttpParseException classe com informações específicas sobre o código-fonte que está sendo compilado e o número de linha no qual a exceção ocorreu.
HttpParseException(String, Exception)	Inicializa uma nova instância da HttpParseException classe com uma mensagem de erro especificada e uma referência ao interior.
HttpParseException(String)	Inicializa uma nova instância da classe HttpParseException com uma mensagem de erro especificada.

Propriedades

Nome	Description
Data	Obtém uma coleção de pares chave/valor que fornecem informações adicionais definidas pelo usuário sobre a exceção. (Herdado de Exception)
ErrorCode	Obtém o `HRESULT` erro. (Herdado de ExternalException)
FileName	Obtém o nome do arquivo que está sendo analisado quando o erro ocorre.
HelpLink	Obtém ou define um link para o arquivo de ajuda associado a essa exceção. (Herdado de Exception)
HResult	Obtém ou define HRESULT, um valor numérico codificado atribuído a uma exceção específica. (Herdado de Exception)
InnerException	Obtém a Exception instância que causou a exceção atual. (Herdado de Exception)
Line	Obtém o número da linha que está sendo analisada quando o erro ocorre.
Message	Obtém uma mensagem que descreve a exceção atual. (Herdado de Exception)
ParserErrors	Obtém os erros do analisador para a exceção atual.
Source	Obtém ou define o nome do aplicativo ou do objeto que causa o erro. (Herdado de Exception)
StackTrace	Obtém uma representação de cadeia de caracteres dos quadros imediatos na pilha de chamadas. (Herdado de Exception)
TargetSite	Obtém o método que gera a exceção atual. (Herdado de Exception)
VirtualPath	Obtém o caminho virtual para o arquivo de origem que gerou o erro.
WebEventCode	Obtém os códigos de evento associados à exceção HTTP. (Herdado de HttpException)

Métodos

Nome	Description
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetBaseException()	Quando substituído em uma classe derivada, retorna a Exception causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception)
GetHashCode()	Serve como a função hash predefinida. (Herdado de Object)
GetHtmlErrorMessage()	Obtém a mensagem de erro HTML para retornar ao cliente. (Herdado de HttpException)
GetHttpCode()	Obtém o código de status de resposta HTTP a ser retornado ao cliente. (Herdado de HttpException)
GetObjectData(SerializationInfo, StreamingContext)	Quando substituído em uma classe derivada, define o SerializationInfo objeto com informações sobre a exceção.
GetType()	Obtém o tipo de runtime da instância atual. (Herdado de Exception)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que contém o HRESULT do erro. (Herdado de ExternalException)

Eventos

Nome	Description
SerializeObjectState	Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção. (Herdado de Exception)

Aplica-se a

Confira também

Comentários

Esta página foi útil?