HttpParseException Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Die Ausnahme, die beim Auftreten eines Analysefehlers ausgelöst wird.
public ref class HttpParseException sealed : System::Web::HttpExceptionpublic sealed class HttpParseException : System.Web.HttpException[System.Serializable]
public sealed class HttpParseException : System.Web.HttpExceptiontype HttpParseException = class
inherit HttpException[<System.Serializable>]
type HttpParseException = class
inherit HttpExceptionPublic NotInheritable Class HttpParseException
Inherits HttpException- Vererbung
- Attribute
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie Sie die während der HttpParseException Seitenanalyse generierten Fehler anpassen können. In diesem Beispiel wird ein angepasstes HtmlSelect Steuerelement definiert. Wenn untergeordnete Elemente des benutzerdefinierten Steuerelements nicht von einem angegebenen Typ sind, wird ein HttpParseException Vorgang in der überschriebenen GetChildControlType Methode einer benutzerdefinierten Methode HtmlSelectBuilderausgelöst. Um eine Analyseausnahme zu generieren, ändern Sie das untergeordnete Element literal MyCustomOption in jede andere Zeichenfolge.
<%@ 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
Hinweise
Die HttpParseException Klasse ist eine HTTP-spezifische Ausnahmeklasse, mit der ASP.NET die Ausgabe von Ausnahmeinformationen ermöglicht. Weitere Informationen zum Auslösen und Behandeln von Ausnahmen finden Sie unter "Ausnahmen".
Konstruktoren
| HttpParseException() |
Initialisiert eine neue Instanz der HttpParseException-Klasse. |
| HttpParseException(String) |
Initialisiert eine neue Instanz der HttpParseException-Klasse mit einer angegebenen Fehlermeldung. |
| HttpParseException(String, Exception) |
Initialisiert eine neue Instanz der HttpParseException-Klasse mit einer angegebenen Fehlermeldung und einem Verweis auf die innere Ausnahme. |
| HttpParseException(String, Exception, String, String, Int32) |
Initialisiert eine neue Instanz der HttpParseException-Klasse mit spezifischen Informationen zum Quellcode, der gerade kompiliert wird, und zur Nummer der Zeile, in der die Ausnahme aufgetreten ist. |
Eigenschaften
| Data |
Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zur Ausnahme bereitstellen. (Geerbt von Exception) |
| ErrorCode |
Ruft das |
| FileName |
Ruft den Namen der Datei ab, die beim Auftreten des Fehlers analysiert wurde. |
| HelpLink |
Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest. (Geerbt von Exception) |
| HResult |
Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist. (Geerbt von Exception) |
| InnerException |
Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat. (Geerbt von Exception) |
| Line |
Ruft die Nummer der Zeile ab, die beim Auftreten des Fehlers analysiert wurde. |
| Message |
Ruft eine Meldung ab, mit der die aktuelle Ausnahme beschrieben wird. (Geerbt von Exception) |
| ParserErrors |
Ruft die Parserfehler für die aktuelle Ausnahme ab. |
| Source |
Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest. (Geerbt von Exception) |
| StackTrace |
Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab. (Geerbt von Exception) |
| TargetSite |
Ruft die Methode ab, die die aktuelle Ausnahme auslöst. (Geerbt von Exception) |
| VirtualPath |
Ruft den virtuellen Pfad zur Quelldatei ab, die den Fehler generiert hat. |
| WebEventCode |
Ruft die Ereigniscodes ab, die der HTTP-Ausnahme zugeordnet sind. (Geerbt von HttpException) |
Methoden
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetBaseException() |
Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die Grundursache für eine oder mehrere nachfolgende Ausnahmen ist. (Geerbt von Exception) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetHtmlErrorMessage() |
Ruft die HTML-Fehlermeldung ab, die an den Client zurückgegeben wird. (Geerbt von HttpException) |
| GetHttpCode() |
Ruft den HTTP-Antwortstatuscode ab, der an den Client zurückgegeben wird. (Geerbt von HttpException) |
| GetObjectData(SerializationInfo, StreamingContext) |
Legt beim Überschreiben in einer abgeleiteten Klasse das SerializationInfo-Objekt mit Informationen zur Ausnahme fest. |
| GetObjectData(SerializationInfo, StreamingContext) |
Ruft Informationen zu der Ausnahme ab und fügt sie dem SerializationInfo-Objekt hinzu. (Geerbt von HttpException) |
| GetType() |
Ruft den Laufzeittyp der aktuellen Instanz ab. (Geerbt von Exception) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das HRESULT des Fehlers enthält. (Geerbt von ExternalException) |
Ereignisse
| SerializeObjectState |
Veraltet.
Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt mit serialisierten Daten über die Ausnahme zu erstellen. (Geerbt von Exception) |