HttpException クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

HttpException クラス

HTTP 要求の処理中に発生した例外を説明します。

名前空間: System.Web
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public Class HttpException
    Inherits ExternalException

Visual Basic (使用法)

Dim instance As HttpException

[SerializableAttribute] 
public class HttpException : ExternalException

C++

[SerializableAttribute] 
public ref class HttpException : public
 ExternalException

/** @attribute SerializableAttribute() */ 
public class HttpException extends ExternalException

JScript

SerializableAttribute 
public class HttpException extends
 ExternalException

解説

HttpException クラスは HTTP 固有の例外クラスで、ASP.NET はこれを使用して例外情報を生成できます。例外のスローと処理の詳細については、「例外の処理とスロー」を参照してください。

使用例

HttpException クラスを使用してカスタマイズされた例外を発生させる方法を次のコード例に示します。Button_Click メソッドは、クリックされたボタンを判断し、CheckNumber メソッドまたは CheckBoolean メソッドを呼び出します。ユーザーがテキストボックスに入力した値が必要な型と一致しない場合は、HttpException 例外が作成され、エラーの型に基づいてカスタマイズされたメッセージと共にスローされます。

Visual Basic

<%@ Page language="VB" %>

<script runat="server">

  Sub CheckNumber()
    
    Try

      ' Check whether the value is an integer.
      Dim convertInt As String
 = textbox1.Text
      Convert.ToInt32(convertInt)

    Catch e As Exception

      ' Throw an HttpException with customized message.
      Throw New HttpException("not
 an integer")

    End Try

  End Sub

  Sub CheckBoolean()
    
    Try

      ' Check whether the value is an boolean.
      Dim convertBool As String
 = textbox1.Text
      Convert.ToBoolean(convertBool)

    Catch e As Exception

      ' Throw an HttpException with customized message.
      Throw New HttpException("not
 a boolean")

    End Try

  End Sub


  Sub Button_Click(ByVal sender As
 [Object], ByVal e As EventArgs)
    
    Try

      ' Check to see which button was clicked.
      Dim b As Button = CType(sender, Button)
      If b.ID.StartsWith("button1")
 Then
        CheckNumber()
      ElseIf b.ID.StartsWith("button2")
 Then
        CheckBoolean()
      End If

      label1.Text = "You entered: " + textbox1.Text
      label1.ForeColor = System.Drawing.Color.Black

      ' Catch the HttpException.
    Catch exp As HttpException

      label1.Text = "An HttpException was raised. "
 + "The value entered in the textbox is " + exp.Message.ToString()
      label1.ForeColor = System.Drawing.Color.Red

    End Try

  End Sub

</script>

<html>
   <head>
     <title>HttpException Example</title>
   </head>
   <body>
     <h3>HttpException Example</h3>
      
     <form id="Form1" runat="server">
        <br />
        <b>Enter a value in the text box.</b>
        <br />
        <asp:TextBox ID="textbox1" 
                     Runat="server">
        </asp:TextBox>
        <br />
        <asp:Button ID="button1"
                    Text="Check for integer."  
                    OnClick="Button_Click" 
                    Runat="server">
        </asp:Button>
        <br />
        <asp:Button ID="button2"
                    Text="Check for boolean." 
                    OnClick="Button_Click" 
                    Runat="server">
        </asp:Button>
        <br />
        <asp:Label ID="label1" 
                   Runat="server">
        </asp:Label>
     </form>
   </body>
</html>

<%@ Page language="C#" %>

<script runat="server">
  void CheckNumber()
  {
    try
    {
      // Check whether the value is an integer.
      String convertInt = textbox1.Text;
      Convert.ToInt32(convertInt);
    }
    catch (Exception e)
    {
      // Throw an HttpException with customized message.
      throw new HttpException("not an integer");
    }
  }
  void CheckBoolean()
  {
    try
    {
      // Check whether the value is an boolean.
      String convertBool = textbox1.Text;
      Convert.ToBoolean(convertBool);
    }
    catch (Exception e)
    {
      // Throw an HttpException with customized message.
      throw new HttpException("not a boolean");
    }
  }

  void Button_Click(Object sender, EventArgs e)
  {
    try
    {
      // Check to see which button was clicked.
      Button b = (Button)sender;
      if (b.ID.StartsWith("button1"))
        CheckNumber();
      else if (b.ID.StartsWith("button2"))
        CheckBoolean();
      
      label1.Text = "You entered: " + textbox1.Text;
      label1.ForeColor = System.Drawing.Color.Black;
    }
    // Catch the HttpException.
    catch (HttpException exp)
    {
      label1.Text = "An HttpException was raised. "
         + "The value entered in the textbox is " +
 exp.Message.ToString();
      label1.ForeColor = System.Drawing.Color.Red;
    }
  }

</script>
<html>
   <head>
     <title>HttpException Example</title>
   </head>
   <body>
     <h3>HttpException Example</h3>
      
     <form runat="server">
        <br />
        <b>Enter a value in the text box.</b>
        <br />
        <asp:TextBox ID="textbox1" 
                     Runat="server">
        </asp:TextBox>
        <br />
        <asp:Button ID="button1"
                    Text="Check for integer."  
                    OnClick="Button_Click" 
                    Runat="server">
        </asp:Button>
        <br />
        <asp:Button ID="button2"
                    Text="Check for boolean." 
                    OnClick="Button_Click" 
                    Runat="server">
        </asp:Button>
        <br />
        <asp:Label ID="label1" 
                   Runat="server">
        </asp:Label>
     </form>
   </body>
</html>

.NET Framework のセキュリティ

AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
AspNetHostingPermission (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.Exception
     System.SystemException
       System.Runtime.InteropServices.ExternalException
        System.Web.HttpException
           System.Web.HttpCompileException
           System.Web.HttpParseException
           System.Web.HttpRequestValidationException
           System.Web.HttpUnhandledException

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition