Visual Basic .NET を使用して ASP.NET でカスタムエラー報告ページを作成する

[アーティクル]
07/17/2023

この記事では、Microsoft Visual Basic .NET コードを使用して、ASP.NET で発生したエラーをトラップして対応する方法について説明します。

元の製品バージョン: Visual Basic .NET、ASP.NET
元の KB 番号: 308132

まとめ

ASP.NET により、従来の Active Server Pages (ASP) からのエラー処理オプションが改善されました。 ASP.NET では、アプリケーション内のいくつかの異なるレベルでエラーを処理できます。

ASP.NET の新機能

ASP.NET では、エラーを処理して対応する方法についていくつかの進歩が提供されています。従来の ASP では、 On Error Resume Next (または JScript の try-catch ブロック) でエラーを処理します。または、インターネットインフォメーションサービス (IIS) を実行している場合は、ASPError オブジェクトを使用してカスタムエラー報告ページを作成します。ただし、これらのアプローチには制限があります。

ASP.NET には、ASP.NET アプリケーションの実行時に発生する可能性があるエラーを処理して対応できるいくつかのレベルが用意されています。 ASP.NET には、エラーが発生したときにトラップして応答できる 3 つの主要な方法 ( Page_Error イベント、 Application_Error イベント、アプリケーション構成ファイル (Web.config) が用意されています。

この記事では、ASP.NET アプリケーションでこれらの新機能を使用する方法について説明します。この記事では、カスタムエラーページと、ASP.NET に直接関連する一般的なエラー報告を提供する方法について説明しますが、この記事では、 try-catch-finally ブロックや共通言語ランタイム (CLR) 例外システムなどの他のエラー処理方法については説明しません。

Page_Error イベントを使用する

Page_Error イベントは、ページレベルで発生したエラーをトラップする方法を提供します。 (従うサンプルコードのように) エラー情報を表示したり、イベントをログに記録したり、他のアクションを実行したりできます。

Note

次の使用例は、デモンストレーション目的でのみ、ブラウザーに詳細なエラー情報を表示します。アプリケーションのエンドユーザーに詳細情報を表示する場合は、特にアプリケーションがインターネット上で実行されている場合は注意が必要です。より適切なアクションは、エラーが発生したことをユーザーに通知するメッセージを表示し、実際にイベントログに特定のエラーの詳細を記録することです。

この例では null 例外をスローします。これにより、 Page_Load イベントでエラーが強制的に発生します。 Page_Error イベントをテストする初期ページを作成するには、次の手順に従います。

PageEvent.aspxという名前の新しいファイルをプロジェクトに追加するには、次の手順に従います。
1. Visual Studio .NET を開きます。
2. ソリューションエクスプローラーで、プロジェクトノードを右クリックし、Add をポイントして、[Web フォームの追加] をクリック。
3. Name テキストボックスに「PageEvent.aspx」と入力し、[開く] をクリック。

次のコードを PageEvent.aspxに追加します。

<%@ Page Language="vb"%>
<script runat=server>
    Sub Page_Load(Sender as object, e as EventArgs)
       throw(new System.ArgumentNullException())
    End Sub
    Sub Page_Error(Sender as object, e as EventArgs)
       Dim objErr as Exception = Server.GetLastError().GetBaseException()
       Dim err as String = "<b>Error Caught in Page_Error event</b><hr><br>" & _
                           "<br><b>Error in: </b>" & Request.Url.ToString() & _
                           "<br><b>Error Message: </b>" & objErr.Message.ToString() & _
                           "<br><b>Stack Trace:</b><br>" & _objErr.StackTrace.ToString()
       Response.Write(err.ToString())
       Server.ClearError()
    End Sub
</script>

File メニューの Save PageEvent.aspx をクリックします。
ページを右クリックし、ブラウザーで View をクリックしてページを実行します。エラーがスローされ、コードの仕様に従って報告されていることに注意してください。

Note

コードが Server.ClearErrorの呼び出しを発行していることに気付く場合があります。これにより、エラーが処理される Application_Error イベントに進むのを防ぐことができます。

Application_Error イベントを使用する

Page_Error イベントと同様に、Application_Error イベントを使用して、アプリケーションで発生するエラーをトラップできます。イベントのアプリケーション全体のスコープにより、アプリケーションエラー情報をログに記録したり、発生する可能性のある他のアプリケーションレベルのエラーを処理したりできます。

次のサンプルは、上記の Page_Error イベントコードサンプルに基づいており、 Page_Load イベントのエラーが Page_Error イベントにトラップされなかった場合に発生します。 Application_Error イベントは、アプリケーションの Global.asax ファイルで指定されます。わかりやすくするために、このセクションの手順では、例外をスローする新しいページを作成し、Global.asax ファイルのApplication_Error イベントでエラーをトラップし、エラーをイベントログに書き込みます。次の手順では、 Application_Error イベントの使用方法を示します。

AppEvent.aspxという名前の新しいファイルをプロジェクトに追加します。

次のコードを AppEvent.aspxに追加します。

<script language=vb runat="server">
     Sub Page_Load(Sender as object, e as EventArgs)
         throw(new ArgumentNullException())
     End Sub
</script>

File メニューの Save AppEvent.aspx をクリックします。

Application_Error イベントを Global.asax ファイルに追加して、AppEvent.aspx ページのPage_Load イベントでスローしたエラーをトラップします。イベントログを使用するには、System.Diagnostics名前空間のImports ステートメントを Global.asax に追加する必要があることに注意してください。

Global.asax ファイルに次のコードを追加します。

Imports System.Diagnostics
Sub Application_Error(ByVal sender As Object, ByVal e As EventArgs)
    Dim objErr As Exception = Server.GetLastError().GetBaseException()
    Dim err As String = "Error Caught in Application_Error event" & _
                            System.Environment.NewLine & _
                            "Error in: " & Request.Url.ToString() & _
                            System.Environment.NewLine & _
                            "Error Message: " & objErr.Message.ToString() & _
                            System.Environment.NewLine & _
                            "Stack Trace:" & objErr.StackTrace.ToString()
    EventLog.WriteEntry("Sample_WebApp", err, EventLogEntryType.Error)
    Server.ClearError()
    additional actions...
End Sub

Global.asax ファイルを保存します。
Visual Studio .NET の Build メニューの [ Build をクリックします。
ページを右クリックし、ブラウザーで View をクリックします。この場合、ページは空白になりますが、イベントログに新しいエントリが追加されていることがわかります。このサンプルでは、イベントビューアーからアクセスできるアプリケーションログにエントリを作成します。エラーをログに記録した後、ユーザーを別のわかりやすいエラーページにリダイレクトしたり、必要に応じて追加のアクションを実行したりできます。

Web.config ファイルを使用する

Server.ClearErrorを呼び出したり、Page_ErrorまたはApplication_Errorイベントのエラーをトラップしたりしない場合、エラーは Web.config ファイルの <customErrors> セクションの設定に基づいて処理されます。 <customErrors>セクションでは、リダイレクトページを既定のエラーページ (defaultRedirect) として指定したり、発生するハイパーテキスト転送プロトコル (HTTP) エラーコードに基づいて特定のページに指定したりできます。このメソッドを使用すると、ユーザーが受け取るエラーメッセージをカスタマイズできます。

アプリケーションの前のレベルでトラップされていないエラーが発生した場合、このカスタムページが表示されます。このセクションでは、Server.ClearErrorが呼び出されないように Global.asax ファイルを変更する方法について説明します。その結果、エラーをトラップする最後のポイントとして、 Web.config ファイルでエラーが処理されます。

前の例の Global.asax ファイルを開きます。
Server.ClearError行をコメントアウトして、エラーが Web.config ファイルに確実に表示されるようにします。

変更を Global.asax に保存します。これで、コードは次のように表示されます。

 Sub Application_Error(ByVal sender As Object, ByVal e As EventArgs)
     Dim objErr As Exception = Server.GetLastError().GetBaseException()
     Dim err As String = "Error Caught in Application_Error event" & _
                         System.Environment.NewLine & _
                         "Error in: " & Request.Url.ToString() & _
                         System.Environment.NewLine & _
                         "Error Message: " & objErr.Message.ToString() & _
                         System.Environment.NewLine & _
                         "Stack Trace:" & objErr.StackTrace.ToString()
     EventLog.WriteEntry("Sample_WebApp", err, EventLogEntryType.Error)
     Server.ClearError()
     additional actions...
 End Sub

次のコードを <customErrors> セクションに追加して、ユーザーをカスタムページにリダイレクトします。
```
<customErrors defaultRedirect="http://hostName/applicationName/errorStatus.htm" mode="On">
</customErrors>
```
Note

関連する Web サーバーとアプリケーション名を参照するように、 defaultRedirect 属性のファイルパスを変更する必要があります。
このレベルでトラップされたエラーは既定のエラーページに送信されるため、 ErrorStatus.htmという名前のエラーページを作成する必要があります。この例では、エラーページに .htm ページを使用するため、このメソッドを使用してユーザーに表示される内容を制御していることを覚えておいてください。次のコードを ErrorStatus.htmに追加します。
```
<HTML>
    <HEAD>
        <TITLE></TITLE>
        <META NAME="GENERATOR" Content="Microsoft Visual Studio 7.0">
    </HEAD>
    <BODY>
         <b>Custom Error page!</b>
         <br>
         You have been redirected here from the <customErrors> section of the
         Web.config file.
    </BODY>
</HTML>
```
コードをテストするには、ファイルを保存し、プロジェクトをビルドして、ブラウザーで AppEvent.aspx を表示します。エラーがスローされると、 ErrorStatus.htm ページにリダイレクトされます。 <customErrors> セクションの defaultRedirect 属性の値で既定のエラーページを参照できますが、発生する HTTP エラーコードに基づいてリダイレクトする特定のページを指定することもできます。 <error>子要素では、このオプションを使用できます。例えば次が挙げられます。
```
<customErrors defaultRedirect="http://hostName/applicationName/errorStatus.htm" mode="On">
    <error statusCode="404" redirect="filenotfound.htm"/>
</customErrors>
```

Note

<customErrors> セクションのdefaultRedirectで指定されているページは、.htm ファイルです。 .aspx ページでGetLastErrorを使用する場合 (Page_ErrorとApplication_Errorのサンプルで行います)、リダイレクトが行われる前に、セッション変数またはその他の方法に例外を格納する必要があります。

<customErrors> セクションには、On に設定されたmode属性が含まれていることに注意してください。 mode属性は、エラーリダイレクトの実行方法を制御するために使用されます。たとえば、アプリケーションを開発している場合、実際の ASP.NET エラーメッセージを表示し、よりわかりやすいエラーページにリダイレクトしたくない場合が最も多くなります。 mode属性には、次の設定が含まれています。

On: ハンドルされない例外は、指定された defaultRedirect ページにユーザーをリダイレクトします。この mode は、主に運用環境で使用されます。
Off: ユーザーは例外情報を受け取り、 defaultRedirect ページにリダイレクトされません。この mode は主に開発に使用されます。
RemoteOnly: (localhost を使用して) ローカルコンピューター上のサイトにアクセスするユーザーのみが例外情報を受け取ります。他のすべてのユーザーは、 defaultRedirect ページにリダイレクトされます。このモードは、主にデバッグに使用されます。

トラブルシューティング

Windows での既定のインストールでは、ASP.NET はワーカープロセスで Web アプリケーションコードを実行します。このプロセスの ID は、既定では、 ASPNET アカウントと呼ばれる特権のないローカルアカウントになります。 ASP.NET のベータリリースでは、プロセス ID は System でした。これは、マシンに対する多くの特権を持つ強力な管理アカウントでした。

Windows Server (IIS) での既定のインストールでは、ASP.NET はワーカープロセスで Web アプリケーションコードを実行します。このプロセスの ID は、既定で NetworkService という制限付きアカウントに設定されます。

この変更の詳細と、この記事のコードの実行に及ぼす影響、および追加のアクセス権が必要になる可能性があるその他のコードについては、パターンとプラクティスに関する記事を参照してください。

次の方法で共有

Visual Basic .NET を使用して ASP.NET でカスタムエラー報告ページを作成する

まとめ

ASP.NET の新機能

Page_Error イベントを使用する

Application_Error イベントを使用する

Web.config ファイルを使用する

トラブルシューティング

関連情報

フィードバック

その他のリソース

次の方法で共有

Visual Basic .NET を使用して ASP.NET でカスタム エラー報告ページを作成する

まとめ

ASP.NET の新機能

Page_Error イベントを使用する

Application_Error イベントを使用する

Web.config ファイルを使用する

トラブルシューティング

関連情報

フィードバック

その他のリソース

Visual Basic .NET を使用して ASP.NET でカスタムエラー報告ページを作成する