ExceptionMessageBox Classe

Riferimento

Definizione

Spazio dei nomi:: Microsoft.SqlServer.MessageBox

Assembly:: Microsoft.ExceptionMessageBox.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Visualizza una finestra di messaggio che può essere personalizzata con testo, pulsanti e simboli per migliorare l'esperienza del cliente con un'applicazione basata su Microsoft Windows .NET Framework.

public ref class ExceptionMessageBox

[System.Runtime.InteropServices.ComVisible(false)]
public class ExceptionMessageBox

[<System.Runtime.InteropServices.ComVisible(false)>]
type ExceptionMessageBox = class

Public Class ExceptionMessageBox

Ereditarietà: Object
ExceptionMessageBox

Attributi: ComVisibleAttribute

Esempio

In questo esempio viene visualizzata la finestra di messaggio con un pulsante 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

In questo esempio viene usata la finestra di messaggio eccezione per visualizzare informazioni aggiuntive utili per la risoluzione dei problemi o il debug.

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

Costruttori

ExceptionMessageBox()	Crea un'istanza di ExceptionMessageBox con le proprietà predefinite.
ExceptionMessageBox(Exception)	Crea un'istanza dell'oggetto ExceptionMessageBox tramite informazioni derivanti dall'oggetto Exception specificato.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons)	Crea un'istanza di ExceptionMessageBox tramite informazioni derivanti dall'oggetto Exception indicato e specificando i pulsanti da visualizzare nella finestra di messaggio.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Crea un'istanza di ExceptionMessageBox tramite informazioni derivanti dall'oggetto Exception indicato e specificando i pulsanti e il simbolo da visualizzare nella finestra di messaggio.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Crea un'istanza di ExceptionMessageBox tramite informazioni derivanti dall'oggetto Exception indicato e specificando i pulsanti, il simbolo e il pulsante predefinito da visualizzare nella finestra di messaggio eccezione. .
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Crea un'istanza di ExceptionMessageBox tramite informazioni derivanti dall'oggetto Exception indicato e specificando i pulsanti, il simbolo, il pulsante predefinito e altre proprietà da visualizzare nella finestra di messaggio eccezione.
ExceptionMessageBox(String)	Crea un'istanza di ExceptionMessageBox con il testo del messaggio di errore di livello principale fornito.
ExceptionMessageBox(String, String)	Crea un'istanza di ExceptionMessageBox con il testo del messaggio di errore di livello principale fornito e la didascalia della finestra di dialogo della finestra di messaggio eccezione.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons)	Crea un'istanza di ExceptionMessageBox con il testo del messaggio di errore di livello principale fornito e la didascalia della finestra di dialogo della finestra di messaggio eccezione. Il metodo specifica inoltre i pulsanti da visualizzare nella finestra di messaggio eccezione.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Crea un'istanza di ExceptionMessageBox con il testo del messaggio di errore di livello principale fornito e la didascalia della finestra di dialogo della finestra di messaggio eccezione. Il metodo specifica inoltre i pulsanti e il simbolo da visualizzare nella finestra di messaggio eccezione.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Crea un'istanza di ExceptionMessageBox con il testo del messaggio di errore di livello principale fornito e la didascalia della finestra di dialogo della finestra di messaggio. Il metodo specifica inoltre i pulsanti, il simbolo e il pulsante predefinito da visualizzare nella finestra di messaggio eccezione.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Crea un'istanza di ExceptionMessageBox con il testo del messaggio di errore di livello principale fornito e la didascalia della finestra di dialogo della finestra di messaggio. Il metodo specifica inoltre i pulsanti, il simbolo, il pulsante predefinito e le opzioni della finestra di dialogo da visualizzare nella finestra di messaggio dell'eccezione.

Proprietà

AbortButtonText	Ottiene il testo predefinito per il pulsante Abort .
Beep	Specifica se riprodurre un suono udibile quando viene visualizzato il messaggio.
Buttons	Ottiene o imposta i pulsanti da visualizzare nella finestra di messaggio.
CancelButtonText	Ottiene il testo predefinito per il pulsante Annulla .
Caption	Ottiene o imposta la didascalia della finestra di dialogo della finestra di messaggio eccezione.
CheckBoxRegistryKey	Imposta un oggetto RegistryKey aperto che controlla la casella di controllo visualizzata nella finestra di messaggio eccezione quando ShowCheckBox è `true`.
CheckBoxRegistryMeansDoNotShowDialog	Determina se il contenuto del valore del Registro di sistema specificato da CheckBoxRegistryKey e CheckBoxRegistryValue indica la decisione da parte di un utente precedente di non visualizzare il messaggio.
CheckBoxRegistryValue	Ottiene o imposta il nome del valore del Registro di sistema che controlla la casella di controllo nella finestra di messaggio eccezione quando ShowCheckBox è `true`.
CheckBoxText	Ottiene o imposta il testo da visualizzare nella casella di controllo nella finestra di messaggio eccezione quando ShowCheckBox è `true`.
CustomDialogResult	Ottiene il pulsante della finestra di dialogo con testo personalizzato su cui si è fatto clic.
CustomSymbol	Ottiene o imposta una bitmap personalizzata da utilizzare come simbolo nella finestra di messaggio eccezione.
Data	Ottiene l'interfaccia IDictionary in cui sono archiviati il collegamento della Guida e le informazioni avanzate associate al messaggio di livello principale.
DefaultButton	Ottiene o imposta il pulsante predefinito nella finestra di messaggio.
DefaultDialogResult	Ottiene o imposta il valore restituito dal metodo Show(IWin32Window) quando l'utente ha indicato in precedenza di non visualizzare più un determinato messaggio.
FailButtonText	Ottiene il testo predefinito per il pulsante Fail .
Font	Ottiene o imposta il carattere utilizzato nella finestra di messaggio.
HelpLink	Ottiene o imposta il collegamento al file della Guida o alla pagina Web della Guida associato al messaggio di livello principale.
IgnoreButtonText	Ottiene il testo predefinito per il pulsante Ignora .
InnerException	Ottiene o imposta l'istanza dell'oggetto Exception associata ai messaggi di livello secondario.
IsCheckBoxChecked	Specifica se viene selezionata la casella di controllo quando ShowCheckBox è `true`.
Message	Ottiene o imposta l'eccezione Exception che contiene il messaggio da visualizzare.
MessageLevelDefault	Ottiene o imposta il numero di livelli di messaggio da visualizzare nella finestra di messaggio.
NoButtonText	Ottiene il testo predefinito per il pulsante No
OKButtonText	Ottiene il testo predefinito per il pulsante OK
Options	Ottiene o imposta varie opzioni di visualizzazione per la finestra di messaggio.
RetryButtonText	Ottiene il testo predefinito per il pulsante Riprova .
ShowCheckBox	Specifica se visualizzare la casella di controllo nella finestra di messaggio eccezione.
ShowToolBar	Specifica se mostrare la barra degli strumenti dei pulsanti di comando nella finestra di messaggio eccezione.
Symbol	Ottiene o imposta il simbolo da visualizzare nella finestra di messaggio eccezione.
Text	Ottiene o imposta il testo del messaggio di livello principale da visualizzare nella finestra di messaggio eccezione.
UseOwnerFont	Specifica se recuperare il carattere della finestra proprietaria e utilizzarlo come carattere per la finestra di messaggio eccezione.
YesButtonText	Ottiene il testo predefinito per il pulsante Sì

Metodi

GetMessageText(Exception)	Restituisce la stringa che un utente può copiare negli Appunti quando l'eccezione viene visualizzata in una finestra di messaggio eccezione.
SetButtonText(String)	Imposta il testo per il pulsante con testo personalizzato quando solo un pulsante viene visualizzato nella finestra di messaggio eccezione.
SetButtonText(String, String)	Imposta il testo per i pulsanti con testo personalizzato quando solo due pulsanti vengono visualizzati nella finestra di messaggio eccezione.
SetButtonText(String, String, String)	Imposta il testo per i pulsanti con testo personalizzato quando solo tre pulsanti vengono visualizzati nella finestra di messaggio eccezione.
SetButtonText(String, String, String, String)	Imposta il testo per i pulsanti con testo personalizzato quando solo quattro pulsanti vengono visualizzati nella finestra di messaggio eccezione.
SetButtonText(String, String, String, String, String)	Imposta il testo per i pulsanti con testo personalizzato quando solo cinque pulsanti vengono visualizzati nella finestra di messaggio eccezione.
Show(IntPtr, String, String, String, String, String, String, String)	Visualizza la finestra di messaggio eccezione. Identificato solo a scopo informativo. Non supportata. Non è garantita la compatibilità con le versioni future.
Show(IWin32Window)	Mostra la finestra di messaggio eccezione come una finestra di dialogo modale allineata al centro nella finestra padre.

Eventi

OnCopyToClipboard

Si verifica quando il testo del messaggio eccezione viene copiato dalla finestra di messaggio negli Appunti.

Si applica a