CustomErrorCollection.Add(CustomError) Method

Reference

Definition

Namespace:: System.Web.Configuration

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Adds a CustomError object to the collection.

public:
 void Add(System::Web::Configuration::CustomError ^ customError);

public void Add (System.Web.Configuration.CustomError customError);

member this.Add : System.Web.Configuration.CustomError -> unit

Public Sub Add (customError As CustomError)

Parameters

customError: CustomError

The CustomError object to add already exists in the collection or the collection is read only.

Examples

The following code example adds a CustomError object to the CustomErrorCollection collection.

Refer to the code example in the CustomErrorCollection class topic to learn how to get the collection.

// Using the Add method.
CustomError newCustomError2 =
new CustomError(404, "customerror404.htm");

// Update the configuration file.
if (!customErrorsSection.SectionInformation.IsLocked)
{
    // Add the new custom error to the collection.
    customErrorsCollection.Add(newCustomError2);
    configuration.Save();
}

' Using the Add method.
  Dim newCustomError2 _
  As New CustomError(404, "customerror404.htm")

' Update the configuration file.
If Not customErrorsSection.SectionInformation.IsLocked Then
   ' Add the new custom error to the collection.
   customErrorsCollection.Add(newCustomError2)
   configuration.Save()
End If

Remarks

Before adding a custom error to the collection, you must create a CustomError error object and initialize the Redirect and StatusCode properties.

Applies to

Del via