Exception Handling with Logging QuickStart

The Exception Handling with Logging QuickStart demonstrates the following scenarios:

• Walkthrough: Logging an Exception. This walkthrough demonstrates how you can format and log exception information.
• Walkthrough: Notifying the User. This walkthrough demonstrates how you can use a friendly message to notify the user of an exception and still allow support staff to identify the original exception.

System Requirements

To build and run this QuickStart, you need the following:

• Microsoft Windows 2000, Windows XP Professional, or Windows Server 2003 operating system
• Microsoft .NET Framework, version 2.0
• Microsoft Visual Studio 2005 development system

The QuickStart does not require you to perform any setup procedures prior to building and running the application.

Building and Running the QuickStart

The QuickStart ships as source code, which means that you must compile it before running it. You use Visual Studio to build the QuickStart.

To build the Exception with Logging QuickStart

1. On the taskbar, click Start, point to All Programs, point to Microsoft patterns and practices, point to Enterprise Library, point to QuickStart Applications, point to Exception Handling Application Block, and then click either CS Exception Handling With Logging QuickStart, or VB Exception Handling With Logging QuickStart.
2. Visual Studio opens, displaying the solution file. Click Build.
3. Click Rebuild Solution. By default, this is a debug build.
4. Press F5 to run the QuickStart.

QuickStart Configuration

The walkthroughs in the Exception Handling with Logging QuickStart are shipped with a defined configuration, which is included in the App.config file. This file is located in the same folder as the QuickStart project file.

To change or view these settings, use the Enterprise Library Configuration Console to open the App.config file in the directory that contains the QuickStart project file. The App.config file contains the configuration data.

Each time you build the code, Visual Studio copies the App.config file to the output directory for the project (the same directory where the QuickStart executable is created), and renames it to ExceptionHandlingWithLoggingQuickStart.exe.config.

This means that if you want to use the configuration console to change any of the configuration settings, such as the exception message, and you are planning to rebuild the solution, you must change the settings by opening the App.config file located in the QuickStart source directory. You can change the application configuration by opening the ExceptionHandlingWithLoggingQuickStart.exe.config file with the Enterprise Library Configuration Console. However, these changes will be overwritten during the next successful build.