ExceptionMessageBox Класс

Определение

Пространство имен:

Microsoft.SqlServer.MessageBox

Сборка:

Microsoft.ExceptionMessageBox.dll

Отображается окно сообщений, которое можно настраивать с помощью текста, кнопок и символов для улучшения клиентского опыта с помощью приложения на базе 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

Наследование

Object

ExceptionMessageBox

Атрибуты

ComVisibleAttribute

Примеры

В этом примере окно сообщений отображается кнопкой 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

В этом примере используется окно с исключениями для отображения дополнительной информации, полезной при устранении неполадок или отладке.

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

Конструкторы

Имя	Описание
ExceptionMessageBox()	Создаёт экземпляр ExceptionMessageBox с свойствами по умолчанию.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Создаёт экземпляр ExceptionMessageBox , используя информацию из указанного Exception и указывая кнопки, символ, кнопку по умолчанию и другие свойства для отображения в окне исключения.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Создаёт экземпляр ExceptionMessageBox с помощью информации из указанного Exception и указания кнопок, символа и кнопки по умолчанию для отображения в окне исключения. .
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Создаёт экземпляр ExceptionMessageBox , используя информацию из указанного Exception и указывая кнопки и символ для отображения в окне сообщений.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons)	Создаёт экземпляр ExceptionMessageBox , используя информацию из указанного Exception и указывая кнопки для отображения в окне сообщений.
ExceptionMessageBox(Exception)	Создаёт экземпляр ExceptionMessageBox , используя информацию из указанного Exception.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Создаёт экземпляр ExceptionMessageBox с указанным текстом верхнего уровня сообщения об ошибке и подписью в диалоговом окне окна. Метод также указывает кнопки, символ, кнопку по умолчанию и диалоговые параметры для отображения в окне исключения.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Создаёт экземпляр ExceptionMessageBox с указанным текстом верхнего уровня сообщения об ошибке и подписью в диалоговом окне окна. Метод также указывает кнопки, символ и кнопку по умолчанию для отображения в окне исключения.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Создаёт экземпляр ExceptionMessageBox с указанным текстом верхнего уровня сообщения об ошибке и подписью в диалоговом окне в окне исключения. Метод также указывает кнопки и символ для отображения в окне исключения.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons)	Создаёт экземпляр ExceptionMessageBox с указанным текстом верхнего уровня сообщения об ошибке и подписью в диалоговом окне в окне исключения. Метод также указывает кнопки для отображения в окне сообщений об исключении.
ExceptionMessageBox(String, String)	Создаёт экземпляр ExceptionMessageBox с указанным текстом верхнего уровня сообщения об ошибке и подписью в диалоговом окне в окне исключения.
ExceptionMessageBox(String)	Создаёт экземпляр ExceptionMessageBox с предоставленным верхнеуровневым текстом сообщения об ошибке.

Свойства

Имя	Описание
AbortButtonText	Получает стандартный текст для кнопки отмены .
Beep	Указывает, нужно ли воспроизводить слышимый звук при отображении сообщения.
Buttons	Получает или устанавливает кнопки для отображения в окне сообщений.
CancelButtonText	Получает стандартный текст для кнопки Cancel .
Caption	Получает или устанавливает подпись в диалоговом окне в окне сообщения об исключении.
CheckBoxRegistryKey	Устанавливает открытый RegistryKey , управляющий галочкой, отображаемой в окне исключения, когда ShowCheckBox это true.
CheckBoxRegistryMeansDoNotShowDialog	Определяет, указывает ли содержимое значения реестра, указанное и CheckBoxRegistryKeyCheckBoxRegistryValue указывает на предыдущее решение пользователя не просматривать это сообщение.
CheckBoxRegistryValue	Получает или устанавливает имя значения реестра, которое управляет галочкой в поле исключения, когда ShowCheckBox это .true
CheckBoxText	Получает или устанавливает отображение текста так, чтобы он отображался в галочке в окне исключения, когда ShowCheckBox это .true
CustomDialogResult	Появляется кнопка нажатия пользовательского текста.
CustomSymbol	Получает или устанавливает пользовательский растровой мап для использования в качестве символа в окне исключения.
Data	Получает IDictionary интерфейс, который хранит ссылки на помощь и расширенную информацию, связанную с сообщением верхнего уровня.
DefaultButton	Получает или устанавливает кнопку по умолчанию в окне сообщений.
DefaultDialogResult	Получает или устанавливает значение, возвращаемое Show(IWin32Window) методом, когда пользователь ранее указал не показывать заданное сообщение снова.
FailButtonText	Получает стандартный текст для кнопки Fail .
Font	Получает или устанавливает шрифт, используемый в окне сообщений.
HelpLink	Получает или устанавливает ссылку на файл справки или страницу справки, связанную с сообщением верхнего уровня.
IgnoreButtonText	Получает стандартный текст для кнопки «Игнорировать ».
InnerException	Получает или устанавливает экземпляр Exception , связанный с нижним уровневым сообщением(ами).
IsCheckBoxChecked	Указывает, выбрана ли галочка, когда ShowCheckBox равна true.
Message	Получает или устанавливает отображение сообщения Exception .
MessageLevelDefault	Получает или устанавливает количество уровней сообщений для отображения в окне сообщений.
NoButtonText	Получает стандартный текст для кнопки «Нет »
OKButtonText	Получает стандартный текст для кнопки OK
Options	Получает или устанавливает различные варианты отображения для окна сообщений
RetryButtonText	Получает стандартный текст для кнопки «Повторить».
ShowCheckBox	Указывает, нужно ли показывать галочку в поле сообщения исключения.
ShowToolBar	Указывает, показывать ли панель инструментов командной кнопки в окне сообщений об исключении.
Symbol	Получает или устанавливает символ для отображения в окне исключения.
Text	Получает или устанавливает отображение текста верхнего уровня сообщения в окне исключения
UseOwnerFont	Указывает, нужно ли получить шрифт из окна владельца и использовать его как шрифт для окна исключения.
YesButtonText	Получает стандартный текст для кнопки «Да »

Методы

Имя	Описание
GetMessageText(Exception)	Возвращает строку, которую пользователь может скопировать в буфер обмена, когда исключение отображается в окне сообщений об исключении.
SetButtonText(String, String, String, String, String)	Устанавливает текст для пользовательских кнопок, когда в окне исключения отображается всего пять кнопок.
SetButtonText(String, String, String, String)	Устанавливает текст для пользовательских текстовых кнопок, когда в окне исключения отображаются только четыре кнопки.
SetButtonText(String, String, String)	Устанавливает текст для пользовательских текстовых кнопок, когда в окне исключения отображаются только три кнопки.
SetButtonText(String, String)	Устанавливает текст для пользовательских текстовых кнопок, когда в окне исключения отображаются только две кнопки.
SetButtonText(String)	Устанавливает текст для пользовательской кнопки текста, когда в окне исключения отображается только одна кнопка.
Show(IntPtr, String, String, String, String, String, String, String)	Отображается окно об исключении. Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется.
Show(IWin32Window)	Отображается окно об исключениях как модальное диалоговое окно, центрированное вокруг родительского окна.

События

Имя	Описание
OnCopyToClipboard	Возникает, когда текст сообщения об исключениях копируется из окна сообщений в буфер обмена.