Klasa ExceptionMessageBox

Wyświetla okno komunikatu, który można dostosować za pomocą tekstu, przycisków i symboli, aby poprawić wrażenia z Microsoft systemu Windows.Na podstawie NET Framework aplikacji.

Hierarchia dziedziczenia

System. . :: . .Object
  Microsoft.SqlServer.MessageBox..::..ExceptionMessageBox

Przestrzeń nazw:  Microsoft.SqlServer.MessageBox
Zestaw:  Microsoft.ExceptionMessageBox (w Microsoft.ExceptionMessageBox.dll)

Syntax

'Deklaracja
<ComVisibleAttribute(False)> _
Public Class ExceptionMessageBox
'Użycie
Dim instance As ExceptionMessageBox

[ComVisibleAttribute(false)]
public class ExceptionMessageBox

[ComVisibleAttribute(false)]
public ref class ExceptionMessageBox

[<ComVisibleAttribute(false)>]
type ExceptionMessageBox =  class end

public class ExceptionMessageBox

Typ ExceptionMessageBox uwidacznia następujące elementy członkowskie.

Konstruktorzy

	Nazwa	Opis
	ExceptionMessageBox() () () ()	Tworzy wystąpienie ExceptionMessageBox z właściwości domyślnych.
	ExceptionMessageBox(Exception)	Tworzy wystąpienie ExceptionMessageBox przy użyciu informacji z określonego Exception.
	ExceptionMessageBox(String)	Tworzy wystąpienie ExceptionMessageBox z tekstem wiadomości dostarczone błąd najwyższego poziom.
	ExceptionMessageBox(Exception, ExceptionMessageBoxButtons)	Tworzy wystąpienie ExceptionMessageBox przy użyciu informacji z określonego Exception i określając przycisków wyświetlanych w oknie komunikatu.
	ExceptionMessageBox(String, String)	Tworzy wystąpienie ExceptionMessageBox tekst komunikatu błędu podany najwyższego poziom i podpis pole dialogowe komunikat wyjątku.
	ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Tworzy wystąpienie ExceptionMessageBox przy użyciu informacji z określonego Exception i określając przycisków i symboli do wyświetlenia w oknie komunikatu.
	ExceptionMessageBox(String, String, ExceptionMessageBoxButtons)	Tworzy wystąpienie ExceptionMessageBox tekst komunikatu błędu podany najwyższego poziom i podpis pole dialogowe komunikat wyjątku. Metoda określa również przyciski, aby wyświetlić w polu komunikat o wyjątku.
	ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Tworzy wystąpienie ExceptionMessageBox przy użyciu informacji z określonego Exception i określając przyciski, symbol i przycisk domyślne, aby wyświetlić komunikat wyjątku. .
	ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Tworzy wystąpienie ExceptionMessageBox z dostarczonego błąd najwyższego poziom wiadomości tekst i okno dialogowe pole podpis wiadomości wyjątek. Metoda określa również przyciski i symbol do wyświetlenia w polu komunikat o wyjątku.
	ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Tworzy wystąpienie ExceptionMessageBox przy użyciu informacji z określonego Exception i określając przyciski, symbol, przycisk domyślny i inne właściwości, aby wyświetlić komunikat wyjątku.
	ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Tworzy wystąpienie ExceptionMessageBox z dostarczonego błąd najwyższego poziom wiadomości tekst i okno dialogowe pole podpisu w polu komunikat. Metoda określa również przyciski, symbol i przycisk domyślne, aby wyświetlić w polu komunikat o wyjątku.
	ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Infrastruktura. Tworzy wystąpienie ExceptionMessageBox z dostarczonego błąd najwyższego poziom wiadomości tekst i okno dialogowe pole podpisu w polu komunikat. Metoda określa również przyciski, symbol, przycisk domyślny i okno dialogowe Opcje, aby wyświetlić w polu komunikat o wyjątku.

Do góry

Właściwości

	Nazwa	Opis
	AbortButtonText	Pobiera tekst domyślny dla przerwanie przycisku.
	Beep	Określa, czy odtwarzanie dźwiękowego, gdy wyświetlany jest komunikat.
	Buttons	Pobiera lub ustawia przycisków wyświetlanych w oknie komunikatu.
	CancelButtonText	Pobiera tekst domyślny dla anulowanie przycisku.
	Caption	Pobiera lub ustawia okno dialogowe Podpis pola okna komunikatu wyjątek.
	CheckBoxRegistryKey	Ustawia otwartej RegistryKey steruje pole wyboru jest wyświetlany na komunikat wyjątku pole po ShowCheckbox()()()() jest true.
	CheckBoxRegistryMeansDoNotShowDialog	Określa, czy zawartość rejestru wartości określonej przez CheckBoxRegistryKey i CheckBoxRegistryValue wskazuje poprzednich decyzji użytkownika nie, aby wyświetlić wiadomość.
	CheckBoxRegistryValue	Pobiera lub ustawia nazwę wartości rejestru sterująca pole wyboru na komunikat wyjątku pole obowiązującymi ShowCheckbox()()()() jest true.
	CheckBoxText	Pobiera lub ustawia tekst do wyświetlenia w polu wyboru na komunikat wyjątku kiedy pole ShowCheckbox()()()() jest true.
	CustomDialogResult	Pobiera tekst niestandardowy kliknięty przycisk okna dialogowego.
	CustomSymbol	Pobiera lub ustawia niestandardową mapę bitową jako symbol w polu Komunikat wyjątku.
	Data	Pobiera IDictionary interfejs, który przechowuje łącze Pomoc i zaawansowane informacje skojarzone z najwyższego poziom wiadomości.
	DefaultButton	Pobiera lub ustawia domyślny przycisk w oknie komunikatu.
	DefaultDialogResult	Pobiera lub ustawia wartość zwracana przez Show metoda, gdy użytkownik wcześniej wskazało nie pokazuj danej wiadomości.
	FailButtonText	Pobiera tekst domyślny dla Niepowodzenie przycisku.
	Font	Pobiera lub ustawia czcionkę w polu komunikat.
	HelpLink	Pobiera lub ustawia łącze do pliku pomocy lub strona sieci Web pomocy skojarzonych z komunikatem najwyższego poziom.
	IgnoreButtonText	Pobiera tekst domyślny dla Ignoruj przycisku.
	InnerException	Pobiera lub ustawia Exception wystąpienie skojarzone z wiadomości niższego poziom.
	IsCheckBoxChecked	Określa, czy pole wyboru jest zaznaczone, gdy ShowCheckbox()()()() jest true.
	Message	Pobiera lub ustawia Exception zawierający komunikat do wyświetlania.
	MessageLevelDefault	Pobiera lub ustawia liczbę poziomów wiadomości wyświetlanych w oknie komunikatu.
	NoButtonText	Pobiera tekst domyślny dla nr przycisk
	OKButtonText	Pobiera tekst domyślny dla OK przycisk
	Options	Pobiera lub ustawia opcje wyświetlania dodatkowych w oknie komunikatu
	RetryButtonText	Pobiera tekst domyślny dla ponownie przycisku.
	ShowCheckBox	Określa, czy pole wyboru w polu Komunikat wyjątku.
	ShowToolBar	Określa, czy wyświetlać pasek narzędzi przycisku polecenia w oknie komunikatu wyjątek.
	Symbol	Pobiera lub ustawia symbol do wyświetlenia w polu komunikat o wyjątku.
	Text	Pobiera lub ustawia tekst najwyższego poziom komunikat wyświetlany w polu komunikat o wyjątku
	UseOwnerFont	Określa, czy pobieranie czcionek okno właściciela i użyć czcionki, w oknie komunikatu wyjątek.
	YesButtonText	Pobiera tekst domyślny dla Tak przycisk

Do góry

Metody

	Nazwa	Opis
	Equals	(Dziedziczony z Object).
	Finalize	(Dziedziczony z Object).
	GetHashCode	(Dziedziczony z Object).
	GetMessageText	Zwraca ciąg, który użytkownik można skopiować do Schowka, gdy wyjątek jest wyświetlana w polu komunikat o wyjątku.
	GetType	(Dziedziczony z Object).
	MemberwiseClone	(Dziedziczony z Object).
	SetButtonText(String)	Ustawia tekst przycisku Niestandardowy tekst, gdy tylko jeden przycisk jest wyświetlany w polu komunikat o wyjątku.
	SetButtonText(String, String)	Ustawia tekst dla przycisków niestandardowy tekst, gdy tylko dwa przyciski są wyświetlane w polu komunikat o wyjątku.
	SetButtonText(String, String, String)	Ustawia tekst dla przycisków niestandardowy tekst, gdy tylko trzy przyciski są wyświetlane w polu komunikat o wyjątku.
	SetButtonText(String, String, String, String)	Ustawia tekst dla przycisków niestandardowy tekst, gdy tylko cztery przyciski są wyświetlane w polu komunikat o wyjątku.
	SetButtonText(String, String, String, String, String)	Ustawia tekst dla przycisków niestandardowy tekst, gdy tylko pięć przycisków są wyświetlane w polu komunikat o wyjątku.
	Show(IWin32Window)	Wyświetla okno komunikatu wyjątek jako modalnego okna dialogowego wyśrodkowany na okno nadrzędne.
	Show(IntPtr, String, String, String, String, String, String, String)	Infrastruktura. Wyświetla okno komunikatu wyjątek. Określone tylko w celach informacyjnych. Nieobsługiwane. Przyszła zgodność nie jest gwarantowana.
	ToString	(Dziedziczony z Object).

Do góry

Zdarzenia

	Nazwa	Opis
	OnCopyToClipboard	Występuje, gdy tekst komunikatu wyjątek jest kopiowany z pola wiadomości do Schowka.

Do góry

Przykłady

W tym przykładzie wyświetla okno komunikatu z OK przycisku.

           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

W tym przykładzie użyto okna komunikatu wyjątek, aby wyświetlić dodatkowe informacje pomocne przy rozwiązywaniu problemów lub debugowania.

            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

Bezpieczeństwo wątków

Wszystkie publiczne statyczny (Shared w języku Visual Basic) elementy członkowskie tego typu są bezpieczne dla wątków. Nie ma gwarancji, że elementy członkowskie wystąpień będą bezpieczne dla wątków.

Zobacz także

Reference

Przestrzeń nazw Microsoft.SqlServer.MessageBox