ExceptionMessageBox Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Exibe uma caixa de mensagem que pode ser personalizada com texto, botões e símbolos para melhorar a experiência do cliente com um aplicativo baseado em .NET Framework do Microsoft Windows.
public ref class ExceptionMessageBox
[System.Runtime.InteropServices.ComVisible(false)]
public class ExceptionMessageBox
[<System.Runtime.InteropServices.ComVisible(false)>]
type ExceptionMessageBox = class
Public Class ExceptionMessageBox
- Herança
-
ExceptionMessageBox
- Atributos
Exemplos
Este exemplo exibe a caixa de mensagem com um botão OK .
try
{
// Do something that may generate an exception.
throw new ApplicationException("An error has occured");
}
catch (ApplicationException ex)
{
// Define a new top-level error message.
string str = "The action failed.";
// Add the new top-level message to the handled exception.
ApplicationException exTop = new ApplicationException(str, ex);
exTop.Source = this.Text;
// Show an exception message box with an OK button (the default).
ExceptionMessageBox box = new ExceptionMessageBox(exTop);
box.Show(this);
}
Try
' Do something that may generate an exception.
Throw New ApplicationException("An error has occured")
Catch ex As ApplicationException
' Define a new top-level error message.
Dim str As String = "The action failed."
' Add the new top-level message to the handled exception.
Dim exTop As ApplicationException = New ApplicationException(str, ex)
exTop.Source = Me.Text
' Show an exception message box with an OK button (the default).
Dim box As ExceptionMessageBox = New ExceptionMessageBox(exTop)
box.Show(Me)
End Try
Este exemplo usa a caixa de mensagem de exceção para mostrar informações adicionais úteis ao solucionar problemas ou depurar.
try
{
// Do something that you don't expect to generate an exception.
throw new ApplicationException("Failed to connect to the server.");
}
catch (ApplicationException ex)
{
string str = "An unexpected error occurred. Please call Helpdesk.";
ApplicationException exTop = new ApplicationException(str, ex);
exTop.Source = this.Text;
// Information in the Data property of an exception that has a name
// beginning with "HelpLink.Advanced" is shown when the user
// clicks the Advanced Information button of the exception message
// box dialog box.
exTop.Data.Add("AdvancedInformation.FileName", "application.dll");
exTop.Data.Add("AdvancedInformation.FilePosition", "line 355");
exTop.Data.Add("AdvancedInformation.UserContext", "single user mode");
// Show the exception message box with additional information that
// is helpful when a user calls technical support.
ExceptionMessageBox box = new ExceptionMessageBox(exTop);
box.Show(this);
}
Try
' Do something that you don't expect to generate an exception.
Throw New ApplicationException("Failed to connect to the server.")
Catch ex As ApplicationException
Dim str As String = "An unexpected error occurred. Please call Helpdesk."
Dim exTop As ApplicationException = New ApplicationException(str, ex)
exTop.Source = Me.Text
' Information in the Data property of an exception that has a name
' beginning with "HelpLink.Advanced" is shown when the user
' clicks the Advanced Information button of the exception message
' box dialog box.
exTop.Data.Add("AdvancedInformation.FileName", "application.dll")
exTop.Data.Add("AdvancedInformation.FilePosition", "line 355")
exTop.Data.Add("AdvancedInformation.UserContext", "single user mode")
' Show the exception message box with additional information that
' is helpful when a user calls technical support.
Dim box As ExceptionMessageBox = New ExceptionMessageBox(exTop)
box.Show(Me)
End Try
Construtores
ExceptionMessageBox() |
Cria uma instância de ExceptionMessageBox com as propriedades padrão. |
ExceptionMessageBox(Exception) |
Cria uma instância de ExceptionMessageBox usando informações do Exception especificado. |
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons) |
Cria uma instância de ExceptionMessageBox usando informações do Exception especificado e especificando os botões a serem exibidos na caixa de mensagem. |
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol) |
Cria uma instância de ExceptionMessageBox usando informações do Exception especificado e especificando os botões e o símbolo a serem exibidos na caixa de mensagem. |
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton) |
Cria uma instância de ExceptionMessageBox usando informações da Exception especificado e especificando os botões, o símbolo e o botão padrão a serem exibidos na caixa de mensagem de exceção. . |
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions) |
Cria uma instância de ExceptionMessageBox usando informações da Exception especificado e especificando os botões, o símbolo, o botão padrão e outras propriedades a serem exibidas na caixa de mensagem de exceção. |
ExceptionMessageBox(String) |
Cria uma instância de ExceptionMessageBox com o texto da mensagem de erro de nível superior fornecido. |
ExceptionMessageBox(String, String) |
Cria uma instância com o texto da mensagem de ExceptionMessageBox erro de nível superior fornecido e a legenda da caixa de diálogo da caixa de mensagem de exceção. |
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons) |
Cria uma instância com o texto da mensagem de ExceptionMessageBox erro de nível superior fornecido e a legenda da caixa de diálogo da caixa de mensagem de exceção. O método também especifica botões a serem exibidos na caixa de mensagem de exceção. |
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol) |
Cria uma instância de ExceptionMessageBox com o texto da mensagem de erro de nível superior fornecido e a legenda da caixa de diálogo da caixa de mensagem de exceção. O método também especifica os botões e o símbolo a serem exibidos na caixa de mensagem de exceção. |
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton) |
Cria uma instância de ExceptionMessageBox com o texto da mensagem de erro de nível superior fornecido e a legenda da caixa de diálogo da caixa de mensagem. O método também especifica os botões, o símbolo e o botão padrão a serem exibidos na caixa de mensagem de exceção. |
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions) |
Cria uma instância de ExceptionMessageBox com o texto da mensagem de erro de nível superior fornecido e a legenda da caixa de diálogo da caixa de mensagem. O método também especifica os botões, o símbolo, o botão padrão e as opções da caixa de diálogo a serem exibidos na caixa de mensagem de exceção. |
Propriedades
AbortButtonText |
Obtém o texto padrão para o botão Anular . |
Beep |
Especifica se um som audível deve ser reproduzido quando a mensagem for exibida. |
Buttons |
Obtém ou define os botões a serem exibidos na caixa de mensagem. |
CancelButtonText |
Obtém o texto padrão para o botão Cancelar . |
Caption |
Obtém ou define a legenda da caixa de diálogo da caixa de mensagem de exceção. |
CheckBoxRegistryKey |
Define um aberto RegistryKey que controla a caixa de seleção que é exibida na caixa de mensagem de exceção quando ShowCheckBox é |
CheckBoxRegistryMeansDoNotShowDialog |
Determina se o conteúdo do valor do Registro especificado por CheckBoxRegistryKey e CheckBoxRegistryValue indica uma decisão anterior do usuário de não exibir esta mensagem. |
CheckBoxRegistryValue |
Obtém ou define o nome do valor do Registro que controla a caixa de seleção na caixa de mensagem de exceção quando ShowCheckBox é |
CheckBoxText |
Obtém ou define o texto a ser exibido na caixa de seleção na caixa de mensagem de exceção quando ShowCheckBox é |
CustomDialogResult |
Obtém o botão da caixa de diálogo de texto personalizado clicado. |
CustomSymbol |
Obtém ou define um bitmap personalizado a ser usado como o símbolo na caixa de mensagem de exceção. |
Data |
Obtém a interface de IDictionary que armazena o link de ajuda e informações avançadas associadas à mensagem de nível superior. |
DefaultButton |
Obtém ou define o botão padrão na caixa de mensagem. |
DefaultDialogResult |
Obtém ou define o valor retornado pelo método Show(IWin32Window) quando o usuário tiver indicado previamente que uma determinada mensagem não deve ser exibida novamente. |
FailButtonText |
Obtém o texto padrão para o botão Falhar . |
Font |
Obtém ou define a fonte usada na caixa de mensagem. |
HelpLink |
Obtém ou define o link para o arquivo de ajuda ou para a página de ajuda da Web associada à mensagem de nível superior. |
IgnoreButtonText |
Obtém o texto padrão para o botão Ignorar . |
InnerException |
Obtém ou define a instância de Exception associada a mensagens de nível inferior. |
IsCheckBoxChecked |
Especifica se a caixa de seleção será marcada quando ShowCheckBox for |
Message |
Obtém ou define a Exception que contém a mensagem a ser exibida. |
MessageLevelDefault |
Obtém ou define o número de níveis de mensagens a serem exibidos na caixa de mensagem. |
NoButtonText |
Obtém o texto padrão para o botão Não |
OKButtonText |
Obtém o texto padrão para o botão OK |
Options |
Obtém ou define diversas opções de exibição para a caixa de mensagem. |
RetryButtonText |
Obtém o texto padrão para o botão Repetir . |
ShowCheckBox |
Especifica se a caixa de seleção deve ser mostrada na caixa de mensagem de exceção. |
ShowToolBar |
Especifica se a barra de ferramentas de botões de comando deve ser mostrada na caixa de mensagem de exceção. |
Symbol |
Obtém ou define o símbolo a ser exibido na caixa de mensagem de exceção. |
Text |
Obtém ou define o texto da mensagem de nível superior a ser exibido na caixa de mensagem de exceção. |
UseOwnerFont |
Especifica se a fonte da janela do proprietário deve ser recuperada e usada como a fonte para a caixa de mensagem de exceção. |
YesButtonText |
Obtém o texto padrão para o botão Sim |
Métodos
GetMessageText(Exception) |
Retorna a cadeia de caracteres que um usuário pode copiar na área de transferência quando a exceção é exibida em uma caixa de mensagem de exceção. |
SetButtonText(String) |
Define o texto para o botão de texto personalizado quando apenas um botão é exibido na caixa de mensagem de exceção. |
SetButtonText(String, String) |
Define o texto para os botões de texto personalizados quando apenas dois botões são exibidos na caixa de mensagem de exceção. |
SetButtonText(String, String, String) |
Define o texto para os botões de texto personalizados quando apenas três botões são exibidos na caixa de mensagem de exceção. |
SetButtonText(String, String, String, String) |
Define o texto para os botões de texto personalizados quando apenas quatro botões são exibidos na caixa de mensagem de exceção. |
SetButtonText(String, String, String, String, String) |
Define o texto para os botões de texto personalizados quando apenas cinco botões são exibidos na caixa de mensagem de exceção. |
Show(IntPtr, String, String, String, String, String, String, String) |
Exibe a caixa de mensagem de exceção. Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida. |
Show(IWin32Window) |
Mostra a caixa de mensagem de exceção como uma caixa de diálogo restrita centralizada na janela pai. |
Eventos
OnCopyToClipboard |
Ocorre quando o texto da mensagem de exceção é copiado da caixa de mensagem na Área de Transferência. |