ExceptionMessageBox Clase

Referencia

Definición

Espacio de nombres:: Microsoft.SqlServer.MessageBox

Ensamblado:: Microsoft.ExceptionMessageBox.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Muestra un cuadro de mensaje que se puede personalizar con texto, botones y símbolos para mejorar la experiencia del cliente con una aplicación basada en .NET Framework de 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

Herencia: Object
ExceptionMessageBox

Atributos: ComVisibleAttribute

Ejemplos

En este ejemplo se muestra el cuadro de mensaje con un botón Aceptar .

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

En este ejemplo se usa el cuadro de mensajes de excepción para mostrar información adicional que puede resultar de utilidad para la depuración o solución de problemas.

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

Constructores

ExceptionMessageBox()	Crea una instancia de ExceptionMessageBox con las propiedades predeterminadas.
ExceptionMessageBox(Exception)	Crea una instancia de ExceptionMessageBox usando información de la Exception especificada.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons)	Crea una instancia de ExceptionMessageBox usando información de la Exception especificada y estableciendo los botones que se van a mostrar en el cuadro de mensaje.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Crea una instancia de ExceptionMessageBox usando información de la Exception especificada y estableciendo los botones y el símbolo que se van a mostrar en el cuadro de mensaje.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Crea una instancia de ExceptionMessageBox usando información de la Exception especificada y estableciendo los botones, el símbolo y el botón predeterminado que se van a mostrar en el cuadro de mensaje de excepción. .
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Crea una instancia de ExceptionMessageBox usando información de la Exception especificada y estableciendo los botones, el símbolo, el botón predeterminado y otras propiedades que se van a mostrar en el cuadro de mensaje de excepción.
ExceptionMessageBox(String)	Crea una instancia de ExceptionMessageBox con el texto del mensaje de error de nivel superior proporcionado.
ExceptionMessageBox(String, String)	Crea una instancia de con el texto del mensaje de ExceptionMessageBox error de nivel superior proporcionado y el título del cuadro de diálogo del cuadro de mensaje de excepción.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons)	Crea una instancia de con el texto del mensaje de ExceptionMessageBox error de nivel superior proporcionado y el título del cuadro de diálogo del cuadro de mensaje de excepción. El método también especifica los botones que se van a mostrar en el cuadro de mensaje de excepción.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Crea una instancia de ExceptionMessageBox con el texto del mensaje de error de nivel superior proporcionado y el título del cuadro de mensaje de excepción. El método también especifica los botones y el símbolo que se van a mostrar en el cuadro de mensaje de excepción.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Crea una instancia de ExceptionMessageBox con el texto del mensaje de error de nivel superior proporcionado y el título del cuadro de mensaje. El método también especifica los botones, el símbolo y el botón predeterminado que se van a mostrar en el cuadro de mensaje de excepción.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Crea una instancia de ExceptionMessageBox con el texto del mensaje de error de nivel superior proporcionado y el título del cuadro de mensaje. El método también especifica los botones, el símbolo, el botón predeterminado y las opciones de cuadro de diálogo que se van a mostrar en el cuadro de mensaje de excepción.

Propiedades

AbortButtonText	Obtiene el texto predeterminado del botón Anular .
Beep	Especifica si se va a reproducir un sonido cuando se muestra el mensaje.
Buttons	Obtiene o establece los botones que se van a mostrar en el cuadro de mensaje.
CancelButtonText	Obtiene el texto predeterminado del botón Cancelar .
Caption	Obtiene o establece el título del diálogo del cuadro de mensaje de excepción.
CheckBoxRegistryKey	Establece una RegistryKey abierta que controla la casilla que se muestra en el cuadro de mensaje de excepción cuando ShowCheckBox es `true`.
CheckBoxRegistryMeansDoNotShowDialog	Determina si el contenido del valor del Registro especificado mediante CheckBoxRegistryKey y CheckBoxRegistryValue indica que el usuario ya ha expresado que no desea ver este mensaje.
CheckBoxRegistryValue	Obtiene o establece el nombre del valor del Registro que controla la casilla del cuadro de mensaje de excepción cuando ShowCheckBox es `true`.
CheckBoxText	Obtiene o establece el texto que se va a mostrar en la casilla del cuadro de mensaje de excepción cuando ShowCheckBox es `true`.
CustomDialogResult	Obtiene el botón del diálogo de texto personalizado en el que se ha hecho clic.
CustomSymbol	Obtiene o establece un mapa de bits personalizado como símbolo en el cuadro de mensaje de excepción.
Data	Obtiene la interfaz de IDictionary que almacena el vínculo de ayuda e información avanzada asociados con el mensaje de nivel superior.
DefaultButton	Obtiene o establece el botón predeterminado del cuadro de mensaje.
DefaultDialogResult	Obtiene o establece el valor devuelto por el método Show(IWin32Window) cuando el usuario ha indicado previamente que no se vuelva a mostrar un mensaje concreto.
FailButtonText	Obtiene el texto predeterminado del botón Error .
Font	Obtiene o establece la fuente usada en el cuadro de mensaje.
HelpLink	Obtiene o establece el vínculo con el archivo de ayuda o la página web de ayuda asociada al mensaje de nivel superior.
IgnoreButtonText	Obtiene el texto predeterminado del botón Omitir .
InnerException	Obtiene o establece la instancia de Exception asociada a los mensajes de nivel inferior.
IsCheckBoxChecked	Especifica si la casilla está activada cuando ShowCheckBox es `true`.
Message	Obtiene o establece la Exception que contiene el mensaje que se va a mostrar.
MessageLevelDefault	Obtiene o establece el número de niveles de mensaje que se van a mostrar en el cuadro de mensaje.
NoButtonText	Obtiene el texto predeterminado del botón No .
OKButtonText	Obtiene el texto predeterminado del botón Aceptar .
Options	Obtiene o establece diversas opciones de visualización para el cuadro de mensaje
RetryButtonText	Obtiene el texto predeterminado del botón Reintentar .
ShowCheckBox	Especifica si mostrar la casilla en el cuadro de mensaje de excepción.
ShowToolBar	Especifica si mostrar la barra de herramientas de botones de comandos en el cuadro de mensaje de excepción.
Symbol	Obtiene o establece el símbolo que se va a mostrar en el cuadro de mensaje de excepción.
Text	Obtiene o establece el texto del mensaje de nivel superior que se va a mostrar en el cuadro de mensaje de excepción
UseOwnerFont	Especifica si se va a recuperar la fuente de la ventana principal y se va a usar en el cuadro de mensaje de excepción.
YesButtonText	Obtiene el texto predeterminado del botón Sí .

Métodos

GetMessageText(Exception)	Devuelve una cadena que el usuario puede copiar en el Portapapeles cuando la excepción se muestra en un cuadro de mensaje de excepción.
SetButtonText(String)	Establece el texto para el botón de texto personalizado cuando solo se muestra un botón en el cuadro de mensaje de excepción.
SetButtonText(String, String)	Establece el texto para los botones de texto personalizado cuando solo se muestran dos botones en el cuadro de mensaje de excepción.
SetButtonText(String, String, String)	Establece el texto para los botones de texto personalizado cuando solo se muestran tres botones en el cuadro de mensaje de excepción.
SetButtonText(String, String, String, String)	Establece el texto para los botones de texto personalizado cuando solo se muestran cuatro botones en el cuadro de mensaje de excepción.
SetButtonText(String, String, String, String, String)	Establece el texto para los botones de texto personalizado cuando solo se muestran cinco botones en el cuadro de mensaje de excepción.
Show(IntPtr, String, String, String, String, String, String, String)	Muestra el cuadro de mensaje de excepción. Solamente se identifica con fines informativos. No se admite. La compatibilidad con versiones posteriores no está garantizada.
Show(IWin32Window)	Muestra el cuadro de mensaje de excepción como un diálogo modal centrado en la ventana primaria.

Eventos

OnCopyToClipboard

Se produce cuando el texto del mensaje de excepción se copia del cuadro de mensaje en el Portapapeles.

Se aplica a