Using Loupe with WinForms - Introduction
In This Topic
Because WinForms is part of the core .NET runtime, all of the general logging, performance monitoring, and metric capture capabilities that make the Loupe Agent work for other .NET applications apply with WinForms and WPF as well. You can log directly into Loupe, use it with Trace or Debug, or connect it up to your favorite log system. In addition, there are a number of unique capabilities that are designed to provide a great, out of the box experience with WinForms applications.
Unique WinForms Capabilities
The Loupe Agent includes additional capabilities that are designed specifically for WinForms applications. These include:
- Error Manager: Provide an outstanding user experience, prevent many crashes, and get the best exception logging for your application. Designed specifically to enhance multithreaded applications.
- Live Log Viewer: View all log messages live, in production with the live log viewer. Available as both a dialog that activates from a configurable hot key in the application or as a control you can add anywhere in your user interface.
- Packager Dialog: When the time comes to get diagnostic data from your customers to you, the built in Packager Dialog provides a simple to integrate, user friendly experience that you can access via hot key or with a simple line of code.
- User Opt In: You can let users opt in or out of your data gathering program the built in User Opt In manager.
Adding the Loupe Agent to your Application
Add the Loupe Agent from NuGet which can update your Visual Studio Project.
For complete information on configuration options with the Loupe Agent see Developer's Guide - Agent Configuration.
If you don't see anything recorded by Loupe after adding the Agent, make sure you have at least one log statement at the start of your application. This ensures the Agent gets initialized in a timely manner. See
Ensuring the Loupe Agent gets Loaded for more information.
Packaging and Sending Loupe Data from your Application
The Loupe Agent provides a comprehensive set of capabilities to gather the session data recorded while your application runs and send it to where you can work with it to fix customer issues, understand feature usage, and drive your product development forward. This capability is automatically configured as part of the Configuration Wizard, but you can provide an enhanced user experience by reviewing
Developer's Guide - Packaging and Sending Data.
See Also
Developer's Guide
WinForms