HttpParseException 類別

定義

命名空間:: System.Web

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

當發生解析錯誤時拋出的例外。

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

繼承: Object

Exception

SystemException

ExternalException

HttpException
HttpParseException

屬性: SerializableAttribute

範例

以下範例示範如何使用來 HttpParseException 自訂頁面解析過程中產生的錯誤。在此範例中，定義了一個自訂 HtmlSelect 控制。若自訂控制項的子元素非指定型別，則會拋出 a HttpParseException 於自訂的覆寫 GetChildControlType 方法 HtmlSelectBuilder中。要產生解析例外，請將子元素的字面 MyCustomOption 值更改為任意其他字串。

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

備註

HttpParseException 類別是一個 HTTP 專用的例外類別，使 ASP.NET 能夠輸出解析器例外資訊。關於拋出及處理例外的更多資訊，請參見例外。

建構函式

名稱	Description
HttpParseException()	初始化 HttpParseException 類別的新執行個體。
HttpParseException(String, Exception, String, String, Int32)	初始化類別的新實例 HttpParseException ，並提供被編譯的原始碼及異常發生的行號等特定資訊。
HttpParseException(String, Exception)	初始化類別的新實例 HttpParseException ，並以指定錯誤訊息及內部參考。
HttpParseException(String)	使用指定的錯誤訊息，初始化 HttpParseException 類別的新實例。

屬性

名稱	Description
Data	取得一組鍵值對，提供關於例外的額外使用者定義資訊。 (繼承來源 Exception)
ErrorCode	明白 `HRESULT` 了錯誤。 (繼承來源 ExternalException)
FileName	錯誤發生時會取得被解析的檔案名稱。
HelpLink	取得或設定與此例外相關的說明檔案連結。 (繼承來源 Exception)
HResult	取得或設定 HRESULT，一個編碼的數值，指派給特定例外。 (繼承來源 Exception)
InnerException	會取得 Exception 造成目前例外的實例。 (繼承來源 Exception)
Line	當錯誤發生時，會取得被解析的行號。
Message	取得描述目前例外狀況的訊息。 (繼承來源 Exception)
ParserErrors	會收到目前例外的解析器錯誤。
Source	取得或設定造成錯誤之應用程式或物件的名稱。 (繼承來源 Exception)
StackTrace	會取得呼叫堆疊上即時框架的字串表示。 (繼承來源 Exception)
TargetSite	會取得拋出當前例外的方法。 (繼承來源 Exception)
VirtualPath	取得產生錯誤的來源檔案的虛擬路徑。
WebEventCode	取得與 HTTP 例外相關的事件碼。 (繼承來源 HttpException)

方法

名稱	Description
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetBaseException()	當在派生類別中被覆寫時，回傳 Exception 是一個或多個後續例外的根因。 (繼承來源 Exception)
GetHashCode()	做為預設哈希函式。 (繼承來源 Object)
GetHtmlErrorMessage()	會收到 HTML 錯誤訊息，要回傳給客戶端。 (繼承來源 HttpException)
GetHttpCode()	取得 HTTP 回應狀態碼，回傳給用戶端。 (繼承來源 HttpException)
GetObjectData(SerializationInfo, StreamingContext)	當在衍生類別中被覆寫時，會設定 SerializationInfo 物件並包含該例外的資訊。
GetType()	取得目前實例的執行時型態。 (繼承來源 Exception)
MemberwiseClone()	建立目前 Object的淺層複本。 (繼承來源 Object)
ToString()	回傳包含錯誤 HRESULT 的字串。 (繼承來源 ExternalException)

事件

名稱	Description
SerializeObjectState	已淘汰. 當例外被序列化以建立包含該例外序列化資料的例外狀態物件時，會發生這種情況。 (繼承來源 Exception)

適用於

另請參閱

意見反應

此頁面對您有幫助嗎？