ExceptionMessageBox Classe
Definizione
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à
-
ExceptionMessageBox
- Attributi
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 è |
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 è |
CheckBoxText |
Ottiene o imposta il testo da visualizzare nella casella di controllo nella finestra di messaggio eccezione quando ShowCheckBox è |
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 è |
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. |