CustomError クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
CustomError セクションを構成して ASP.NET エラー コードをカスタム ページに割り当てます。 このクラスは継承できません。
public ref class CustomError sealed : System::Configuration::ConfigurationElement
public sealed class CustomError : System.Configuration.ConfigurationElement
type CustomError = class
inherit ConfigurationElement
Public NotInheritable Class CustomError
Inherits ConfigurationElement
- 継承
例
この例では、セクションのいくつかの属性に対して宣言的に値を指定する方法を customErrors
示します。これは、 クラスの CustomError メンバーとしてアクセスすることもできます。
次の構成ファイルの例は、 セクションの値を宣言的に指定する方法を customErrors
示しています。
<customErrors mode="RemoteOnly"
defaultRedirect="customerror.htm">
<error statusCode="404" redirect="customerror404.htm"/>
</customErrors>
次のコード例では、 クラスの使用方法 CustomError を示します。
// Get the Web application configuration.
Configuration configuration =
WebConfigurationManager.OpenWebConfiguration(
"/aspnetTest");
// Get the section.
CustomErrorsSection customErrors =
(CustomErrorsSection)configuration.GetSection(
"system.web/customErrors");
// Get the collection.
CustomErrorCollection customErrorsCollection =
customErrors.Errors;
' Get the Web application configuration.
Dim configuration _
As System.Configuration.Configuration = _
WebConfigurationManager.OpenWebConfiguration( _
"/aspnetTest")
' Get the section.
Dim customErrors As CustomErrorsSection = _
CType(configuration.GetSection( _
"system.web/customErrors"), CustomErrorsSection)
' Get the collection.
Dim customErrorsCollection _
As CustomErrorCollection = _
customErrors.Errors
注釈
CustomError クラスを使用すると、構成ファイルの error
セクションにプログラムからアクセスして変更できます。 この型は、、CustomErrorsMode、および を含むグループのCustomErrorCollection一部ですCustomErrorsSection。
注意
カスタム エラーを定義すると、ASP.NET は、基になるサービス (IIS など) によって通常発行される標準エラーを割り当てます。 たとえば、状態コード 404 のカスタム エラーを定義すると、既存の .aspx ページを参照するたびに、ASP.NET によって発行されます。 カスタム エラーは、ASP.NET によって処理された要素に対してのみ発行されます。 たとえば、既存の.htmページを参照している場合、IIS は標準の 404 エラーを発行します。
コンストラクター
CustomError(Int32, String) |
CustomError クラスの新しいインスタンスを初期化します。 |
プロパティ
メソッド
適用対象
こちらもご覧ください
.NET