HttpParseException Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Eccezione generata quando viene rilevato un errore di analisi.

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

Ereditarietà: Object

Exception

SystemException

ExternalException

HttpException
HttpParseException

Attributi: SerializableAttribute

Esempio

Nell'esempio seguente viene illustrato come usare per personalizzare gli errori generati durante l'analisi HttpParseException delle pagine. In questo esempio viene definito un controllo personalizzato HtmlSelect . Se gli elementi figlio del controllo personalizzato non sono di un tipo specificato, HttpParseException viene generato un metodo sottoposto a override GetChildControlType di un oggetto personalizzato HtmlSelectBuilder. Per generare un'eccezione di analisi, modificare il valore letterale MyCustomOption dell'elemento figlio in qualsiasi altra stringa.

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

Commenti

La HttpParseException classe è una classe di eccezione specifica HTTP che consente ASP.NET di generare informazioni sull'eccezione del parser di output. Per altre informazioni sulla generazione e la gestione delle eccezioni, vedere Eccezioni.

Costruttori

HttpParseException()	Inizializza una nuova istanza della classe HttpParseException.
HttpParseException(String)	Inizializza una nuova istanza della classe HttpParseException con un messaggio di errore specificato.
HttpParseException(String, Exception)	Inizializza una nuova istanza della classe HttpParseException con un messaggio di errore specificato e un riferimento alla parte interna.
HttpParseException(String, Exception, String, String, Int32)	Inizializza una nuova istanza della classe HttpParseException con informazioni specifiche sul codice sorgente in fase di compilazione e il numero della riga sulla quale si è verificata l'eccezione.

Proprietà

Data	Ottiene una raccolta di coppie chiave/valore che forniscono informazioni definite dall'utente aggiuntive sull'eccezione. (Ereditato da Exception)
ErrorCode	Ottiene l'oggetto `HRESULT` dell'errore. (Ereditato da ExternalException)
FileName	Restituisce il nome del file in fase di analisi al momento della generazione dell'errore.
HelpLink	Ottiene o imposta un collegamento al file della Guida associato all'eccezione. (Ereditato da Exception)
HResult	Ottiene o imposta HRESULT, un valore numerico codificato che viene assegnato a un'eccezione specifica. (Ereditato da Exception)
InnerException	Ottiene l'istanza di Exception che ha causato l'eccezione corrente. (Ereditato da Exception)
Line	Restituisce il numero della riga in fase di analisi al momento della generazione dell'errore.
Message	Ottiene un messaggio che descrive l'eccezione corrente. (Ereditato da Exception)
ParserErrors	Ottiene gli errori del parser per l'eccezione corrente.
Source	Ottiene o imposta il nome dell'oggetto o dell'applicazione che ha generato l'errore. (Ereditato da Exception)
StackTrace	Ottiene una rappresentazione di stringa dei frame immediati nello stack di chiamate. (Ereditato da Exception)
TargetSite	Ottiene il metodo che genera l'eccezione corrente. (Ereditato da Exception)
VirtualPath	Ottiene il percorso virtuale del file di origine che ha generato l'errore.
WebEventCode	Ottiene i codici di evento associati all'eccezione HTTP. (Ereditato da HttpException)

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetBaseException()	Quando ne viene eseguito l'override in una classe derivata, restituisce l'Exception che è la causa radice di una o più eccezioni successive. (Ereditato da Exception)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetHtmlErrorMessage()	Ottiene il messaggio di errore HTML da restituire al client. (Ereditato da HttpException)
GetHttpCode()	Ottiene il codice di stato della risposta HTTP da restituire al client. (Ereditato da HttpException)
GetObjectData(SerializationInfo, StreamingContext)	Quando l'override viene eseguito in una classe derivata, imposta l'oggetto SerializationInfo con le informazioni relative all'eccezione.
GetObjectData(SerializationInfo, StreamingContext)	Ottiene informazioni sull'eccezione e le aggiunge all'oggetto SerializationInfo. (Ereditato da HttpException)
GetType()	Ottiene il tipo di runtime dell'istanza corrente. (Ereditato da Exception)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa contenente il valore HRESULT dell'errore. (Ereditato da ExternalException)

Eventi

SerializeObjectState

Obsoleta.

Si verifica quando un'eccezione viene serializzata per creare un oggetto di stato eccezione contenente i dati serializzati relativi all'eccezione.

(Ereditato da Exception)

Si applica a