ExceptionMessageBox ExceptionMessageBox ExceptionMessageBox Class

정의

텍스트, 단추 및 기호는 Microsoft Windows.NET Framework 기반 응용 프로그램의 사용자 환경 개선 하기 위해 사용자 지정할 수 있는 메시지 상자를 표시 합니다. Displays a message box that can be customized with text, buttons, and symbols to improve the customer experience with a Microsoft Windows .NET Framework-based application.

public ref class ExceptionMessageBox
[System.Runtime.InteropServices.ComVisible(false)]
public class ExceptionMessageBox
Public Class ExceptionMessageBox
상속
ExceptionMessageBoxExceptionMessageBoxExceptionMessageBox
특성

예제

이 예제에서는 표시 된 메시지 상자는 확인 단추입니다.This example displays the message box with an OK button.

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

이 예에서는 예외 메시지 상자를 사용하여 문제 해결이나 디버깅에 도움이 되는 추가적인 정보를 표시합니다.This example uses the exception message box to show additional information that is helpful when troubleshooting or debugging.

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()

기본 속성을 사용하여 ExceptionMessageBox 인스턴스를 만듭니다. Creates an instance of ExceptionMessageBox with the default properties.

ExceptionMessageBox(Exception) ExceptionMessageBox(Exception) ExceptionMessageBox(Exception)

지정한 ExceptionMessageBox의 정보를 사용하여 Exception 인스턴스를 만듭니다. Creates an instance of ExceptionMessageBox by using information from the specified Exception.

ExceptionMessageBox(String) ExceptionMessageBox(String) ExceptionMessageBox(String)

제공된 최상위 오류 메시지 텍스트를 사용하여 ExceptionMessageBox 인스턴스를 만듭니다. Creates an instance of ExceptionMessageBox with the supplied top-level error message text.

ExceptionMessageBox(Exception, ExceptionMessageBoxButtons) ExceptionMessageBox(Exception, ExceptionMessageBoxButtons) ExceptionMessageBox(Exception, ExceptionMessageBoxButtons)

지정한 ExceptionMessageBox의 정보를 사용하고 메시지 상자에 표시할 단추를 지정하여 Exception 인스턴스를 만듭니다. Creates an instance of ExceptionMessageBox by using information from the specified Exception and by specifying the buttons to display in the message box.

ExceptionMessageBox(String, String) ExceptionMessageBox(String, String) ExceptionMessageBox(String, String)

제공된 최상위 오류 메시지 텍스트와 예외 메시지 상자의 대화 상자 캡션을 사용하여 ExceptionMessageBox 인스턴스를 만듭니다. Creates an instance of ExceptionMessageBox with the supplied top-level error message text and the dialog box caption of the exception message box.

ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol) ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol) ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)

지정한 ExceptionMessageBox의 정보를 사용하고 메시지 상자에 표시할 단추와 기호를 지정하여 Exception 인스턴스를 만듭니다. Creates an instance of ExceptionMessageBox by using information from the specified Exception and by specifying the buttons and symbol to display in the message box.

ExceptionMessageBox(String, String, ExceptionMessageBoxButtons) ExceptionMessageBox(String, String, ExceptionMessageBoxButtons) ExceptionMessageBox(String, String, ExceptionMessageBoxButtons)

제공된 최상위 오류 메시지 텍스트와 예외 메시지 상자의 대화 상자 캡션을 사용하여 ExceptionMessageBox 인스턴스를 만듭니다. Creates an instance of ExceptionMessageBox with the supplied top-level error message text and the dialog box caption of the exception message box. 이 메서드는 예외 메시지 상자에 표시할 단추도 지정합니다. The method also specifies buttons to display in the exception message box.

ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton) ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton) ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)

지정한 ExceptionMessageBox의 정보를 사용하고 예외 메시지 상자에 표시할 단추, 기호 및 기본 단추를 지정하여 Exception 인스턴스를 만듭니다. Creates an instance of ExceptionMessageBox by using information from the specified Exception and by specifying the buttons, symbol, and default button to display in the exception message box. 의 인스턴스에 액세스할 때마다 SQL Server 로그인을 제공할 필요가 없습니다. .

ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol) ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol) ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)

제공된 최상위 오류 메시지 텍스트와 예외 메시지 상자의 대화 상자 캡션을 사용하여 ExceptionMessageBox 인스턴스를 만듭니다. Creates an instance of ExceptionMessageBox with the supplied top-level error message text and dialog box caption of the exception message box. 이 메서드는 예외 메시지 상자에 표시할 단추와 기호도 지정합니다. The method also specifies the buttons and symbol to display in the exception message box.

ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions) ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions) ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)

지정한 ExceptionMessageBox의 정보를 사용하고 예외 메시지 상자에 표시할 단추, 기호, 기본 단추 및 기타 속성을 지정하여 Exception 인스턴스를 만듭니다. Creates an instance of ExceptionMessageBox by using information from the specified Exception and by specifying the buttons, symbol, default button, and other properties to display in the exception message box.

ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton) ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton) ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)

제공된 최상위 오류 메시지 텍스트와 메시지 상자의 대화 상자 캡션을 사용하여 ExceptionMessageBox 인스턴스를 만듭니다. Creates an instance of ExceptionMessageBox with the supplied top-level error message text and dialog box caption of the message box. 이 메서드는 예외 메시지 상자에 표시할 단추, 기호 및 기본 단추도 지정합니다. The method also specifies the buttons, symbol, and default button to display in the exception message box.

ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions) ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions) ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)

제공된 최상위 오류 메시지 텍스트와 메시지 상자의 대화 상자 캡션을 사용하여 ExceptionMessageBox 인스턴스를 만듭니다. Creates an instance of ExceptionMessageBox with the supplied top-level error message text and dialog box caption of the message box. 이 메서드는 예외 메시지 상자에 표시할 단추, 기호, 기본 단추 및 대화 상자 옵션도 지정합니다. The method also specifies the buttons, symbol, default button, and dialog options to display in the exception message box.

속성

AbortButtonText AbortButtonText AbortButtonText

기본 텍스트를 가져옵니다는 * * 중단 * * 단추입니다. Gets the default text for the Abort button.

Beep Beep Beep

메시지가 표시될 때 소리를 낼지 여부를 지정합니다. Specifies whether to play an audible sound when the message is displayed.

Buttons Buttons Buttons

메시지 상자에 표시할 단추를 가져오거나 설정합니다. Gets or sets the buttons to display in the message box.

CancelButtonText CancelButtonText CancelButtonText

기본 텍스트를 가져옵니다는 * * 취소 * * 단추입니다. Gets the default text for the Cancel button.

Caption Caption Caption

예외 메시지 상자의 대화 상자 캡션을 가져오거나 설정합니다. Gets or sets the dialog box caption of the exception message box.

CheckBoxRegistryKey CheckBoxRegistryKey CheckBoxRegistryKey

RegistryKeytrue일 때 예외 메시지 상자에 표시되는 확인란을 제어하는 열린 ShowCheckBox를 설정합니다. Sets an opened RegistryKey that controls the check box that is displayed on the exception message box when ShowCheckBox is true.

CheckBoxRegistryMeansDoNotShowDialog CheckBoxRegistryMeansDoNotShowDialog CheckBoxRegistryMeansDoNotShowDialog

CheckBoxRegistryKeyCheckBoxRegistryValue로 지정된 레지스트리 값 내용이 이 메시지를 보지 않겠다는 사용자의 이전 의사 결정을 나타내는지 여부를 확인합니다. Determines whether the registry value content specified by CheckBoxRegistryKey and CheckBoxRegistryValue indicates a previous user decision not to view this message.

CheckBoxRegistryValue CheckBoxRegistryValue CheckBoxRegistryValue

ShowCheckBoxtrue일 때 예외 메시지 상자의 확인란을 제어하는 레지스트리 값 이름을 가져오거나 설정합니다. Gets or sets the registry value name that controls the check box on the exception message box when ShowCheckBox is true.

CheckBoxText CheckBoxText CheckBoxText

ShowCheckBoxtrue일 때 예외 메시지 상자의 확인란에 표시할 텍스트를 가져오거나 설정합니다. Gets or sets the text to display in the check box on the exception message box when ShowCheckBox is true.

CustomDialogResult CustomDialogResult CustomDialogResult

클릭된 사용자 지정 텍스트 대화 상자 단추를 가져옵니다. Gets the clicked custom text dialog button.

CustomSymbol CustomSymbol CustomSymbol

예외 메시지 상자에서 기호로 사용할 사용자 지정 비트맵을 가져오거나 설정합니다. Gets or sets a custom bitmap to use as the symbol on the exception message box.

Data Data Data

최상위 메시지에 연결된 도움말 링크와 고급 정보를 저장하는 IDictionary 인터페이스를 가져옵니다. Gets the IDictionary interface that stores help link and advanced information associated with the top-level message.

DefaultButton DefaultButton DefaultButton

메시지 상자의 기본 단추를 가져오거나 설정합니다. Gets or sets the default button on the message box.

DefaultDialogResult DefaultDialogResult DefaultDialogResult

사용자가 지정한 메시지를 다시 표시하지 않도록 이전에 결정한 경우 Show(IWin32Window) 메서드에서 반환되는 값을 가져오거나 설정합니다. Gets or sets the value returned by the Show(IWin32Window) method when the user has previously indicated not to show a given message again.

FailButtonText FailButtonText FailButtonText

기본 텍스트를 가져옵니다는 * * 실패 * * 단추입니다. Gets the default text for the Fail button.

Font Font Font

메시지 상자에 사용되는 글꼴을 가져오거나 설정합니다. Gets or sets the font used in the message box.

HelpLink HelpLink HelpLink

최상위 메시지에 연결된 도움말 파일 또는 도움말 웹 페이지의 링크를 가져오거나 설정합니다. Gets or sets the link to the help file or help Web page associated with the top-level message.

IgnoreButtonText IgnoreButtonText IgnoreButtonText

기본 텍스트를 가져옵니다는 * * 무시 * * 단추입니다. Gets the default text for the Ignore button.

InnerException InnerException InnerException

하위 메시지에 연결된 Exception 인스턴스를 가져오거나 설정합니다. Gets or sets the Exception instance associated with the lower-level message(s).

IsCheckBoxChecked IsCheckBoxChecked IsCheckBoxChecked

ShowCheckBoxtrue일 때 확인란이 선택되는지 여부를 지정합니다. Specifies whether the check box is selected when ShowCheckBox is true.

Message Message Message

표시할 메시지가 포함된 Exception을 가져오거나 설정합니다. Gets or sets the Exception that contains the message to display.

MessageLevelDefault MessageLevelDefault MessageLevelDefault

메시지 상자에 표시할 메시지 수준의 수를 가져오거나 설정합니다. Gets or sets the number of message levels to display in the message box.

NoButtonText NoButtonText NoButtonText

기본 텍스트를 가져옵니다는 * * No * * 단추 Gets the default text for the No button

OKButtonText OKButtonText OKButtonText

기본 텍스트를 가져옵니다는 * * 확인 * * 단추 Gets the default text for the OK button

Options Options Options

메시지 상자의 기타 표시 옵션을 가져오거나 설정합니다. Gets or sets miscellaneous display options for the message box

RetryButtonText RetryButtonText RetryButtonText

기본 텍스트를 가져옵니다는 * * 재시도 * * 단추입니다. Gets the default text for the Retry button.

ShowCheckBox ShowCheckBox ShowCheckBox

예외 메시지 상자에 확인란을 표시할지 여부를 지정합니다. Specifies whether to show the check box in the exception message box.

ShowToolBar ShowToolBar ShowToolBar

예외 메시지 상자에 명령 단추 도구 모음을 표시할지 여부를 지정합니다. Specifies whether to show the command button toolbar on the exception message box.

Symbol Symbol Symbol

예외 메시지 상자에 표시할 기호를 가져오거나 설정합니다. Gets or sets the symbol to display in the exception message box.

Text Text Text

예외 메시지 상자에 표시할 최상위 메시지의 텍스트를 가져오거나 설정합니다. Gets or sets the text of the top-level message to display in the exception message box

UseOwnerFont UseOwnerFont UseOwnerFont

소유자 창의 글꼴을 검색해서 예외 메시지 상자의 글꼴로 사용할지 여부를 지정합니다. Specifies whether to retrieve the font of the owner window and use it as the font for the exception message box.

YesButtonText YesButtonText YesButtonText

기본 텍스트를 가져옵니다는 * * 예 * * 단추 Gets the default text for the Yes button

메서드

GetMessageText(Exception) GetMessageText(Exception) GetMessageText(Exception)

예외 메시지 상자에 예외가 표시될 때 사용자가 클립보드에 복사할 수 있는 문자열을 반환합니다. Returns the string that a user can copy to the clipboard when the exception is displayed in an exception message box.

SetButtonText(String) SetButtonText(String) SetButtonText(String)

예외 메시지 상자에 단추가 하나만 표시될 때 사용자 지정 텍스트 단추의 텍스트를 설정합니다. Sets the text for the custom text button when only one button is displayed in the exception message box.

SetButtonText(String, String) SetButtonText(String, String) SetButtonText(String, String)

예외 메시지 상자에 단추가 두 개만 표시될 때 사용자 지정 텍스트 단추의 텍스트를 설정합니다. Sets the text for the custom text buttons when only two buttons are displayed in the exception message box.

SetButtonText(String, String, String) SetButtonText(String, String, String) SetButtonText(String, String, String)

예외 메시지 상자에 단추가 세 개만 표시될 때 사용자 지정 텍스트 단추의 텍스트를 설정합니다. Sets the text for the custom text buttons when only three buttons are displayed in the exception message box.

SetButtonText(String, String, String, String) SetButtonText(String, String, String, String) SetButtonText(String, String, String, String)

예외 메시지 상자에 단추가 네 개만 표시될 때 사용자 지정 텍스트 단추의 텍스트를 설정합니다. Sets the text for the custom text buttons when only four buttons are displayed in the exception message box.

SetButtonText(String, String, String, String, String) SetButtonText(String, String, String, String, String) SetButtonText(String, String, String, String, String)

예외 메시지 상자에 단추가 다섯 개만 표시될 때 사용자 지정 텍스트 단추의 텍스트를 설정합니다. Sets the text for the custom text buttons when only five buttons are displayed in the exception message box.

Show(IWin32Window) Show(IWin32Window) Show(IWin32Window)

예외 메시지 상자를 부모 창 가운데에 모달 대화 상자로 표시합니다. Shows the exception message box as a modal dialog box centered on the parent window.

Show(IntPtr, String, String, String, String, String, String, String) Show(IntPtr, String, String, String, String, String, String, String) Show(IntPtr, String, String, String, String, String, String, String)

예외 메시지 상자를 표시합니다. Displays the exception message box. 정보를 제공하기 위해서만 확인됩니다. Identified for informational purposes only. 지원되지 않습니다. Not supported. 향후 호환성은 보장되지 않습니다. Future compatibility is not guaranteed.

이벤트

OnCopyToClipboard OnCopyToClipboard OnCopyToClipboard

예외 메시지 텍스트가 메시지 상자에서 클립보드로 복사될 때 발생합니다. Occurs when exception message text is copied from the message box to the Clipboard.

적용 대상