ExceptionMessageBox Kelas

Referensi

Definisi

Ruang nama:: Microsoft.SqlServer.MessageBox

Rakitan:: Microsoft.ExceptionMessageBox.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menampilkan kotak pesan yang dapat dikustomisasi dengan teks, tombol, dan simbol untuk meningkatkan pengalaman pelanggan dengan aplikasi berbasis 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

Warisan: Object
ExceptionMessageBox

Atribut: ComVisibleAttribute

Contoh

Contoh ini menampilkan kotak pesan dengan tombol 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

Contoh ini menggunakan kotak pesan pengecualian untuk menampilkan informasi tambahan yang berguna saat pemecahan masalah atau penelusuran kesalahan.

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

Konstruktor

ExceptionMessageBox()	Membuat instans ExceptionMessageBox dengan properti default.
ExceptionMessageBox(Exception)	Membuat instans dengan ExceptionMessageBox menggunakan informasi dari yang ditentukan Exception.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons)	Membuat instans dengan ExceptionMessageBox menggunakan informasi dari yang ditentukan Exception dan dengan menentukan tombol untuk ditampilkan dalam kotak pesan.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Membuat instans dengan ExceptionMessageBox menggunakan informasi dari yang ditentukan Exception dan dengan menentukan tombol dan simbol untuk ditampilkan dalam kotak pesan.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Membuat instans dengan ExceptionMessageBox menggunakan informasi dari yang ditentukan Exception dan dengan menentukan tombol, simbol, dan tombol default untuk ditampilkan dalam kotak pesan pengecualian. .
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Membuat instans dengan ExceptionMessageBox menggunakan informasi dari yang ditentukan Exception dan dengan menentukan tombol, simbol, tombol default, dan properti lain untuk ditampilkan dalam kotak pesan pengecualian.
ExceptionMessageBox(String)	Membuat instans ExceptionMessageBox dengan teks pesan kesalahan tingkat atas yang disediakan.
ExceptionMessageBox(String, String)	Membuat instans ExceptionMessageBox dengan teks pesan kesalahan tingkat atas yang disediakan dan keterangan kotak dialog kotak pesan pengecualian.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons)	Membuat instans ExceptionMessageBox dengan teks pesan kesalahan tingkat atas yang disediakan dan keterangan kotak dialog kotak pesan pengecualian. Metode ini juga menentukan tombol untuk ditampilkan dalam kotak pesan pengecualian.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Membuat instans ExceptionMessageBox dengan teks pesan kesalahan tingkat atas yang disediakan dan keterangan kotak dialog dari kotak pesan pengecualian. Metode ini juga menentukan tombol dan simbol untuk ditampilkan dalam kotak pesan pengecualian.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Membuat instans ExceptionMessageBox dengan teks pesan kesalahan tingkat atas yang disediakan dan keterangan kotak dialog kotak pesan. Metode ini juga menentukan tombol, simbol, dan tombol default untuk ditampilkan dalam kotak pesan pengecualian.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Membuat instans ExceptionMessageBox dengan teks pesan kesalahan tingkat atas yang disediakan dan keterangan kotak dialog kotak pesan. Metode ini juga menentukan tombol, simbol, tombol default, dan opsi dialog untuk ditampilkan dalam kotak pesan pengecualian.

Properti

AbortButtonText	Mendapatkan teks default untuk tombol Batalkan .
Beep	Menentukan apakah akan memutar suara yang dapat didengar ketika pesan ditampilkan.
Buttons	Mendapatkan atau mengatur tombol untuk ditampilkan dalam kotak pesan.
CancelButtonText	Mendapatkan teks default untuk tombol Batalkan .
Caption	Mendapatkan atau mengatur keterangan kotak dialog dari kotak pesan pengecualian.
CheckBoxRegistryKey	Mengatur yang dibuka RegistryKey yang mengontrol kotak centang yang ditampilkan pada kotak pesan pengecualian saat ShowCheckBox adalah `true`.
CheckBoxRegistryMeansDoNotShowDialog	Menentukan apakah konten nilai registri yang ditentukan oleh CheckBoxRegistryKey dan CheckBoxRegistryValue menunjukkan keputusan pengguna sebelumnya untuk tidak melihat pesan ini.
CheckBoxRegistryValue	Mendapatkan atau mengatur nama nilai registri yang mengontrol kotak centang pada kotak pesan pengecualian saat ShowCheckBox adalah `true`.
CheckBoxText	Mendapatkan atau mengatur teks untuk ditampilkan dalam kotak centang pada kotak pesan pengecualian saat ShowCheckBox adalah `true`.
CustomDialogResult	Mendapatkan tombol dialog teks kustom yang diklik.
CustomSymbol	Mendapatkan atau mengatur bitmap kustom untuk digunakan sebagai simbol pada kotak pesan pengecualian.
Data	IDictionary Mendapatkan antarmuka yang menyimpan tautan bantuan dan informasi tingkat lanjut yang terkait dengan pesan tingkat atas.
DefaultButton	Mendapatkan atau mengatur tombol default pada kotak pesan.
DefaultDialogResult	Mendapatkan atau mengatur nilai yang dikembalikan oleh Show(IWin32Window) metode ketika pengguna sebelumnya telah menunjukkan untuk tidak menampilkan pesan tertentu lagi.
FailButtonText	Mendapatkan teks default untuk tombol Gagal .
Font	Mendapatkan atau mengatur font yang digunakan dalam kotak pesan.
HelpLink	Mendapatkan atau mengatur tautan ke file bantuan atau halaman web bantuan yang terkait dengan pesan tingkat atas.
IgnoreButtonText	Mendapatkan teks default untuk tombol Abaikan .
InnerException	Mendapatkan atau mengatur instans yang Exception terkait dengan pesan tingkat bawah.
IsCheckBoxChecked	Menentukan apakah kotak centang dipilih saat ShowCheckBox adalah `true`.
Message	Mendapatkan atau mengatur Exception yang berisi pesan yang akan ditampilkan.
MessageLevelDefault	Mendapatkan atau mengatur jumlah tingkat pesan untuk ditampilkan dalam kotak pesan.
NoButtonText	Mendapatkan teks default untuk tombol Tidak
OKButtonText	Mendapatkan teks default untuk tombol OK
Options	Mendapatkan atau mengatur opsi tampilan lain-lain untuk kotak pesan
RetryButtonText	Mendapatkan teks default untuk tombol Coba Lagi .
ShowCheckBox	Menentukan apakah akan menampilkan kotak centang dalam kotak pesan pengecualian.
ShowToolBar	Menentukan apakah akan menampilkan toolbar tombol perintah pada kotak pesan pengecualian.
Symbol	Mendapatkan atau mengatur simbol untuk ditampilkan dalam kotak pesan pengecualian.
Text	Mendapatkan atau mengatur teks pesan tingkat atas untuk ditampilkan dalam kotak pesan pengecualian
UseOwnerFont	Menentukan apakah akan mengambil font jendela pemilik dan menggunakannya sebagai font untuk kotak pesan pengecualian.
YesButtonText	Mendapatkan teks default untuk tombol Ya

Metode

GetMessageText(Exception)	Mengembalikan string yang dapat disalin pengguna ke clipboard saat pengecualian ditampilkan dalam kotak pesan pengecualian.
SetButtonText(String)	Mengatur teks untuk tombol teks kustom jika hanya satu tombol yang ditampilkan dalam kotak pesan pengecualian.
SetButtonText(String, String)	Mengatur teks untuk tombol teks kustom saat hanya dua tombol yang ditampilkan dalam kotak pesan pengecualian.
SetButtonText(String, String, String)	Mengatur teks untuk tombol teks kustom jika hanya tiga tombol yang ditampilkan dalam kotak pesan pengecualian.
SetButtonText(String, String, String, String)	Mengatur teks untuk tombol teks kustom saat hanya empat tombol yang ditampilkan dalam kotak pesan pengecualian.
SetButtonText(String, String, String, String, String)	Mengatur teks untuk tombol teks kustom saat hanya lima tombol yang ditampilkan dalam kotak pesan pengecualian.
Show(IntPtr, String, String, String, String, String, String, String)	Menampilkan kotak pesan pengecualian. Diidentifikasi hanya untuk tujuan informasi. Tidak didukung. Kompatibilitas di masa mendatang tidak dijamin.
Show(IWin32Window)	Memperlihatkan kotak pesan pengecualian sebagai kotak dialog modal yang berpusat di jendela induk.

Acara

OnCopyToClipboard

Terjadi ketika teks pesan pengecualian disalin dari kotak pesan ke Clipboard.

Berlaku untuk