ExceptionMessageBox Classe

Referência

Definição

Namespace:: Microsoft.SqlServer.MessageBox

Assembly:: Microsoft.ExceptionMessageBox.dll

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: Object
ExceptionMessageBox

Atributos: ComVisibleAttribute

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 é `true`.
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 é `true`.
CheckBoxText	Obtém ou define o texto a ser exibido na caixa de seleção na caixa de mensagem de exceção quando ShowCheckBox é `true`.
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 `true`.
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.

Aplica-se a