Export (0) Print
Expand All

CustomErrorCollection.Remove Method

Removes a CustomError object from the collection.

Namespace:  System.Web.Configuration
Assembly:  System.Web (in System.Web.dll)

public void Remove(
	string statusCode
)

Parameters

statusCode
Type: System.String

The HTTP status code associated with the custom error.

The Remove method inserts a remove element into the customErrors section of the configuration file at the current hierarchy level. This removes the reference to the add element defined in the parent configuration files at higher levels in the hierarchy.

NoteNote

The add elements are not deleted from the parent configuration files. The remove element merely deactivates them. However, the Remove method does actually delete them at the current hierarchy level.

The following code example shows how to remove the CustomError object with the specified status code. Refer to the code example in the CustomErrorCollection class topic to learn how to get the collection.

            // Using the Remove method. 
            if (!customErrorsSection.SectionInformation.IsLocked)
            {
                // Remove the error with statuscode 404.
                customErrorsCollection.Remove("404");
                configuration.Save();
            }

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft