Formed in 2009, the Archive Team (not to be confused with the archive.org Archive-It Team) is a rogue archivist collective dedicated to saving copies of rapidly dying or deleted websites for the sake of history and digital heritage. The group is 100% composed of volunteers and interested parties, and has expanded into a large amount of related projects for saving online and digital history.
Integration library for WinForms applications
This library will detect all unhandled exceptions in WinForms based applications and report them to your codeRR server.
Built in error page
Example of captured screenshot when an exception was detected
Installation
- Download and install the codeRR server or create an account at coderrapp.com
- Install this client library (using nuget
coderr.client.winforms) - Configure the credentials from your codeRR account in your
Program.cs.
Example configuration
public class Program
{
public static void Main(string[] args)
{
// codeRR configuration
var uri = new Uri("https://report.coderrapp.com/");
Err.Configuration.Credentials(uri,
"yourAppKey",
"yourSharedSecret");
// to catch unhandled exceptions
Err.Configuration.CatchWinFormsExceptions();
// different types of configuration options
Err.Configuration.TakeScreenshotOfActiveFormOnly();
Err.Configuration.TakeScreenshots();
Err.Configuration.UserInteraction.AskUserForDetails = true;
Err.Configuration.UserInteraction.AskUserForPermission = true;
Err.Configuration.UserInteraction.AskForEmailAddress = true;
// The usual stuff
Application.EnableVisualStyles();
Application.SetCompatibleTextRenderingDefault(false);
Application.Run(new MainForm());
}
}Getting started
All unhandled exceptions are reported manually. But sometimes you need to deal with exceptions yourself.
When doing so, simply report the exception like this:
public void OnPostClick()
{
var model = CreatePostDto();
try
{
_somService.Execute(model);
}
catch (Exception ex)
{
this.ReportException(ex, model);
//some custom handling
}
}Context collections
This library includes the following context collections for every reported exceptions:
- All in the core library
- One property collection for each open form.
- Screenshot of the active form (the one that threw an exception)
Requirements
You need to either install codeRR Community Server or use codeRR Live.
Help?
- Questions? http://discuss.coderrapp.com
- Documentation: https://coderrapp.com/documentation/client/libraries/winforms/