Skip to content

exception-message-box-programming.md

Latest commit

 

History

History
38 lines (29 loc) · 2.71 KB

exception-message-box-programming.md

File metadata and controls

38 lines (29 loc) · 2.71 KB
title Exception Message Box Programming | Microsoft Docs
ms.custom
ms.date 06/13/2017
ms.prod sql-server-2014
ms.reviewer
ms.technology database-engine
ms.topic reference
helpviewer_keywords
ExceptionMessageBox class, about ExceptionMessageBox class
exception message box [SQL Server], about exception message box
exception message box [SQL Server]
interfaces [SQL Server]
exceptions [SQL Server]
messages [SQL Server], exception message box
ms.assetid 0b1ba514-6959-4e69-bfd2-3cf3c1ac4b9c
author mashamsft
ms.author mathoma
manager craigg

Exception Message Box Programming

The exception message box is a programmatic interface that is installed with and used by [!INCLUDEmsCoName] [!INCLUDEssNoVersion] graphical components. The exception message box is a supported managed assembly that you can use in your applications to provide significantly more control over the messaging experience and to give your users the options to save error message content for later reference and to get help on messages. Because the exception message box is installed by all editions of [!INCLUDEssNoVersion] except [!INCLUDEssEW], you can use it with no additional configuration on any computer on which [!INCLUDEssNoVersion] client components have been installed.

The xref:Microsoft.SqlServer.MessageBox.ExceptionMessageBox class in the xref:Microsoft.SqlServer.MessageBox namespace has all the functionality of the xref:System.Windows.Forms.MessageBox class and more. Ideal for any tasks for which xref:System.Windows.Forms.MessageBox may be used, xref:Microsoft.SqlServer.MessageBox.ExceptionMessageBox is designed to elegantly handle managed code exceptions. The exception message box allows you to do the following:

  • Provide customized button text for up to five buttons. Buttons and the dialog box resize automatically for different text lengths.

  • Allow users to easily copy the message title, text, button text, and help links (if any) to the Clipboard or send this information in an e-mail message.

  • Display all underlying exceptions and errors in a hierarchical relationship tree when users click Additional Information.

  • Allow users to decide whether to display the message when the same exception occurs again.

  • Access an online help system by using a help link associated with the exception.

For more information, see Program Exception Message Box.