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

Примеры

В этом примере отображается окно сообщения с кнопкой "ОК ".

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)	Создает экземпляр объекта ExceptionMessageBox с использованием данных из указанного объекта Exception.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons)	Создает экземпляр ExceptionMessageBox с использованием данных из заданного класса Exception и указанные кнопки.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Создает экземпляр ExceptionMessageBox с использованием данных из заданного класса Exception, указанные кнопки и символ.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Создает экземпляр ExceptionMessageBox, используя данные из заданного класса Exception, указанные кнопки, символ и кнопку по умолчанию в окне сообщения об исключении. .
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Создает экземпляр ExceptionMessageBox, используя данные из заданного класса Exception, указанные кнопки, символ, кнопку по умолчанию и другие свойства в окне сообщения об исключении.
ExceptionMessageBox(String)	Создает экземпляр ExceptionMessageBox с предоставленным текстом сообщения об ошибке верхнего уровня.
ExceptionMessageBox(String, String)	Создает экземпляр ExceptionMessageBox с предоставленным текстом сообщения об ошибке верхнего уровня и заголовком диалогового окна сообщения об исключении.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons)	Создает экземпляр ExceptionMessageBox с предоставленным текстом сообщения об ошибке верхнего уровня и заголовком диалогового окна сообщения об исключении. Этот метод также указывает кнопки для отображения в окне сообщения об исключении.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Создает экземпляр ExceptionMessageBox с предоставленным текстом сообщения об ошибке верхнего уровня и заголовком диалогового окна сообщения об исключении. Этот метод также указывает кнопки и символ, отображаемые в окне сообщения об исключении.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Создает экземпляр ExceptionMessageBox с предоставленным текстом сообщения об ошибке верхнего уровня и заголовком диалогового окна сообщения. Этот метод также указывает кнопки, символ и кнопку по умолчанию, отображаемые в окне сообщения об исключении.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Создает экземпляр ExceptionMessageBox с предоставленным текстом сообщения об ошибке верхнего уровня и заголовком диалогового окна сообщения. Этот метод также указывает кнопки, символ, кнопку по умолчанию и другие параметры диалогового окна, отображаемые в окне сообщения об исключении.

Свойства

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

Методы

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

События

OnCopyToClipboard

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