HttpErrorsSection クラス

Web サーバーの HTTP エラー処理を構成します。

構文

class HttpErrorsSection : ConfigurationSectionWithCollection  

メソッド

次の表に、HttpErrorsSection クラスによって公開されるメソッドの一覧を示します。

プロパティ

次の表は、HttpErrorsSection クラスによって公開されるプロパティの一覧です。

サブクラス

このクラスにはサブクラスが含まれていません。

解説

このクラスは、構成ファイルの <httpErrors> セクションの設定を公開します。

HttpErrorsSection クラスによって表されるカスタム エラーは IIS 7 に関連するものであり、System.WebServer.Configuration 名前空間にあります。 これらの各エラーは、HttpErrorElement クラスのインスタンスによって表されます。

CustomErrorsSection クラスによって表されるカスタム エラーは ASP.NET に固有であり、System.Web 名前空間にあります。 これらの各エラーは、CustomError クラスのインスタンスによって表されます。

次の表に、DefaultResponseMode プロパティとして使用できる値の一覧を示します。 既定値は 0 (File) です。

次の表に、ErrorMode プロパティとして使用できる値の一覧を示します。 既定値は 0 (DetailedLocalOnly) です。

次の表に、ExistingResponse プロパティとして使用できる値の一覧を示します。 既定値は 0 (Auto) です。

例

次のコード例では、DefaultPath、ErrorMode、DetailedMoreInformationLink の各プロパティの新しい値を指定します。 ヘルパー関数により、変更の前後に構成セクションの値が表示されます。

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  

' Get the HTTP errors section.  
Set oSection = oWebAdmin.Get( _  
    "HttpErrorsSection.Path='" & _  
    "MACHINE/WEBROOT/APPHOST/',Location=''")  

' Display the class name of the section.  
WScript.Echo "[ " & oSection.Path_.Class & " ]"  

' Display the initial values.  
Call DisplayValues("Initial Values", oSection)

' Specify the path of a default error page.  
oSection.DefaultPath = _  
    "D:\inetpub\custerr\en-US\contoso\DefaultErrorPage.htm"  

' Specify a detailed more information link.  
oSection.DetailedMoreInformationLink = "http://www.contoso.com/MoreInfo.htm"  

'Set the ErrorMode property to Custom.  
oSection.ErrorMode = 1  

' Save the values to configuration.  
oSection.Put_  

' Refresh the oSection object variable with the new values.  
oSection.Refresh_  

' Display the changed values.  
Call DisplayValues("New Values", oSection)  

' ==== DisplayValues helper function. ====  
Function DisplayValues(HeadingText, oSection)  

    ' Display a heading.  
    WScript.Echo  
    WScript.Echo HeadingText  
    WScript.Echo String(Len(HeadingText), "-")  

    ' Display the non-embedded section properties.  
    For Each prop In oSection.Properties_  

        If Left( _  
            Prop.Qualifiers_("CIMTYPE"), 6) _  
            <> "object" then  
            WScript.Echo prop.Name & ": " & prop.Value  
        End If  

    Next
End Function

継承階層

ConfigurationSection

ConfigurationSectionWithCollection

HttpErrorsSection

要件

参照

ConfigurationSection クラス
ConfigurationSectionWithCollection クラス
CustomError クラス
CustomErrorsSection クラス
HttpErrorElement クラス
IHttpResponse::SetStatus メソッド