JavaScript Editor jscript editor     Web designer 

Main Page

The example in this section illustrates how to raise ASP.NET custom health monitoring events. When you add a custom event to your application, you must consider the following points:

The example demonstrates the following features:

Running the example requires the following:

To build the HTTP module

  • Place the source code from Raising Custom ASP.NET Health Monitoring Events Example in your ASP.NET application's App_Code directory in a file named SampleModule.vb or SampleModule.cs.


    If you already have source code in the App_Code directory of your application, you must add the version of the custom event provider that is written in the same language as the existing code in the directory.

    ASP.NET will compile the custom event provider code when a page in your application is requested. For more information, see Shared Code Folders in ASP.NET Web Sites.

    - Or-

  • Compile the custom event provider as a library and place the library in your ASP.NET application's Bin directory, or strongly name the assembly and place it in the global assembly cache (GAC).

    The following command example shows how you can compile the example using the command-line compiler.

    Visual BasicВ CopyCode imageCopy Code
    vbc /out:<example_name>.dll /t:library <example_name>.vb /r:System.Web.dll /r:System.Configuration.dll /r:<required namespace>

    C#В CopyCode imageCopy Code
    csc /out:<example_name>.dll /t:library <example_name>.cs /r:System.Web.dll /r:System.Configuration.dll  /r:<required namespace>

    If you cannot execute the compiler command, you must add the .NET Framework installation path to the Windows PATH variable before running the command. In Windows, right-click My Computer, click Properties, click the Advanced tab, and then click the Environment Variables button. In the System variables list, double-click the Path variable. In the Variable value text box, add a semicolon (;) to the end of the existing values in the text box, and then type the path of your .NET Framework installation. The .NET Framework is usually installed in the Windows installation folder at \Microsoft.NET\Framework\versionNumber.

To configure the ASP.NET application to use the example

  1. If a file named Web.config already exists in the root folder of your ASP.NET application, open it. Otherwise, create a text file named Web.config and copy in the following text:

    В CopyCode imageCopy Code
    <?xml version="1.0"?>
    <configuration xmlns="">
  2. Inside the system.web tags, add the following httpModules element and healthMonitoring Element (ASP.NET Settings Schema) element.

    В CopyCode imageCopy Code
      <add name="Raising Custom Web Events" 
        <add name="SampleWebRequestEvent" 
        <add name="Custom" 
        <clear />
          <add name="Custom Web Request Event" 

    The type attribute can list just the class name as it does in the preceding code example, or it can list a fully qualified type, as in the following example:

    В CopyCode imageCopy Code

    The fully qualified type is required only if the class has been installed in the GAC or in the Bin directory.

To test the custom Web event

  1. Run the Windows Event Viewer on the server where your Web application runs. To do this, click Start, click Run, type eventvwr in the Run dialog box, and then click OK.

  2. In the event log tree of the Event Viewer, click Application.

  3. Refresh the view of the Application log by clicking Action and then clicking Refresh.

    Make note of the date, time, and name of the most recent event. You will use this later to verify that your custom event has been raised.

  4. In your browser, request any page from the Web application.

    To make use of the custom event in your application, you run a page from the application in the browser. You can then examine the results created by the custom event.

  5. Refresh the application log again and verify that the health event information issued by the custom event has been logged.

See Also


Raising Custom ASP.NET Health Monitoring Events Example


healthMonitoring Element (ASP.NET Settings Schema)

Other Resources

ASP.NET Health Monitoring
Extending ASP.NET Processing with HTTP Modules

JavaScript Editor jscript editor     Web designer