MessageBox.Show 方法

參考

定義

命名空間:: System.Windows.Forms

組件:: System.Windows.Forms.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

顯示訊息方塊。

多載

Show(String)	顯示含有指定文字的訊息方塊。
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	使用指定的說明檔和說明關鍵字，顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	使用指定的說明檔、`HelpNavigator` 和說明主題，顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	使用指定的說明檔，顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	使用指定的說明檔和 `HelpNavigator`，顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	使用指定的說明檔和說明關鍵字，顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	在指定物件的前面顯示含有指定文字、標題、按鈕、圖示、預設按鈕和選項的訊息方塊。
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	使用指定的說明檔，顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)	顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	使用指定的說明檔和 `HelpNavigator`，顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	在指定物件的前面顯示含有指定文字、標題、按鈕、圖示和預設按鈕的訊息方塊。
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)	在指定物件的前面顯示含有指定文字、標題、按鈕和圖示的訊息方塊。
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	顯示含有指定文字、標題、圖示和預設按鈕的訊息方塊。
Show(IWin32Window, String, String, MessageBoxButtons)	在指定物件的前面顯示含有指定文字、標題和按鈕的訊息方塊。
Show(String, String, MessageBoxButtons, MessageBoxIcon)	顯示含有指定文字、標題、按鈕和圖示的訊息方塊。
Show(IWin32Window, String, String)	在指定物件的前面顯示含有指定文字和標題的訊息方塊。
Show(String, String, MessageBoxButtons)	顯示含有指定文字、標題和按鈕的訊息方塊。
Show(IWin32Window, String)	在指定物件的前面顯示含有指定文字的訊息方塊。
Show(String, String)	顯示含有指定文字和標題的訊息方塊。
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	顯示含有指定文字、標題、按鈕、圖示、預設按鈕和選項的訊息方塊。
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	使用指定的說明檔、`HelpNavigator` 和說明主題，顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。

Show(String)

顯示含有指定文字的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text);

public static System.Windows.Forms.DialogResult Show (string text);

public static System.Windows.Forms.DialogResult Show (string? text);

static member Show : string -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String) As DialogResult

參數

text: String

要顯示在訊息方塊中的文字。

傳回

DialogResult

其中一個 DialogResult 值。

範例

下列程式碼範例會顯示簡單的訊息方塊。

private void DisplayMessageBoxText()
{
         MessageBox.Show("Hello, world.");
}

Private Sub DisplayMessageBoxText()

    MessageBox.Show("Hello, world.")
End Sub

備註

根據預設，訊息方塊會顯示 [ 確定 ] 按鈕。訊息方塊不包含標題中的標題。

適用於

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

使用指定的說明檔和說明關鍵字，顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

參數

owner: IWin32Window

IWin32Window 實作，將擁有強制回應對話方塊。

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

buttons: MessageBoxButtons

其中一個 MessageBoxButtons 值，指定要在訊息方塊中顯示哪些按鈕。

icon: MessageBoxIcon

其中一個 MessageBoxIcon 值，指定那個圖示要顯示在訊息方塊中。

defaultButton: MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值，指定訊息方塊的預設按鈕。

options: MessageBoxOptions

其中一個 MessageBoxOptions 值，指定訊息方塊使用的顯示及關聯的選項。如果要使用預設值，可以傳遞 0。

helpFilePath: String

使用者按一下 [說明] 按鈕時所顯示說明檔的路徑和名稱。

keyword: String

當使用者按下 [說明] 按鈕時要顯示的說明關鍵字。

傳回

DialogResult

其中一個 DialogResult 值。

例外狀況

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成員。

-或-

icon 不是 MessageBoxIcon 的成員。

-或-

指定的 defaultButton 參數不是 MessageBoxDefaultButton 的成員。

InvalidOperationException

嘗試在不執行使用者互動模式的處理序中顯示 MessageBox。這個由 UserInteractive 屬性所指定。

ArgumentException

options 指定 DefaultDesktopOnly 和 ServiceNotification。

-或-

buttons 指定了無效的 MessageBoxButtons 組合。

範例

下列程式碼範例示範如何顯示主視窗上層的訊息方塊。訊息方塊會顯示 [說明] 按鈕。當使用者按一下 [說明] 按鈕時，即 Mspaint.chm 會開啟 [說明] 檔案， mspaint.chm::/paint_brush.htm 並顯示關鍵字所識別的主題。此範例會要求 Mspaint.chm 安裝說明檔。

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
System::Windows::Forms::DialogResult r8 = MessageBox::Show( this, "Message with Help file and keyword.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", "mspaint.chm::/paint_brush.htm" );

// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r8 = MessageBox.Show (this, "Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");

' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file, 
' and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
' associated topic.
Dim r8 As DialogResult = MessageBox.Show(Me, "Message with Help file and keyword.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, 0, _
                                   "mspaint.chm", _
                                   "mspaint.chm::/paint_brush.htm")

備註

訊息方塊是強制回應對話方塊，這表示在強制回應表單上的物件之外，無法 (鍵盤或滑鼠按一下) 輸入。程式必須隱藏或關閉強制回應表單 (通常會回應某些使用者動作) ，才能發生另一個表單的輸入。您可以使用 owner 參數來指定實作介面的特定物件 IWin32Window ，該物件將做為對話方塊的最上層擁有者。

當使用者按一下 [說明] 按鈕時，會開啟參數中指定的 helpFilePath [說明] 檔案，並顯示參數所識別的 keyword Help 關鍵字主題。擁有訊息方塊的表單 (或使用中表單) 也會收到 HelpRequested 事件。

另請參閱

適用於

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

使用指定的說明檔、HelpNavigator 和說明主題，顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object? param);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

參數

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

buttons: MessageBoxButtons

其中一個 MessageBoxButtons 值，指定要在訊息方塊中顯示哪些按鈕。

icon: MessageBoxIcon

其中一個 MessageBoxIcon 值，指定那個圖示要顯示在訊息方塊中。

defaultButton: MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值，指定訊息方塊的預設按鈕。

options: MessageBoxOptions

其中一個 MessageBoxOptions 值，指定訊息方塊使用的顯示及關聯的選項。如果要使用預設值，可以傳遞 0。

helpFilePath: String

使用者按一下 [說明] 按鈕時所顯示說明檔的路徑和名稱。

navigator: HelpNavigator

其中一個 HelpNavigator 值。

param: Object

當使用者按下 [說明] 按鈕時要顯示之說明主題的數字 ID。

傳回

DialogResult

其中一個 DialogResult 值。

例外狀況

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成員。

-或-

icon 不是 MessageBoxIcon 的成員。

-或-

指定的 defaultButton 參數不是 MessageBoxDefaultButton 的成員。

InvalidOperationException

嘗試在不執行使用者互動模式的處理序中顯示 MessageBox。這個由 UserInteractive 屬性所指定。

ArgumentException

options 指定 DefaultDesktopOnly 和 ServiceNotification。

-或-

buttons 指定了無效的 MessageBoxButtons 組合。

範例

下列程式碼範例示範如何使用 [說明] 按鈕來顯示訊息方塊。當使用者按一下 [說明] 按鈕時，即 Mspaint.chm 會開啟 [說明] 檔案，並顯示關鍵字所識別的 ovals [說明索引] 索引標籤和主題。此範例會要求 Mspaint.chm 安裝說明檔。

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Display a message box. The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
System::Windows::Forms::DialogResult r5 = MessageBox::Show( "Message with Help file and Help navigator with additional parameter.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::KeywordIndex, "ovals" );

// Display a message box. The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r5 = MessageBox.Show ("Message with Help file and Help navigator with additional parameter.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.KeywordIndex, "ovals");

' Display a message box. The Help button opens the Mspaint.chm Help file, 
' shows index with the "ovals" keyword selected, and displays the
' associated topic.
Dim r5 As DialogResult = MessageBox.Show("Message with Help file and Help navigator with additional parameter.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.KeywordIndex, "ovals")

備註

訊息方塊是強制回應對話方塊，這表示在強制回應表單上的物件之外，無法 (鍵盤或滑鼠按一下) 輸入。程式必須隱藏或關閉強制回應表單 (通常會回應某些使用者動作) ，才能發生另一個表單的輸入。

當使用者按一下 [說明] 按鈕時，會開啟參數中指定的 helpFilePath 說明檔案，並顯示參數所識別的說明 navigator 內容。擁有訊息方塊的表單 (或使用中表單) 也會收到 HelpRequested 事件。

編譯的說明檔會在頁面中提供目錄、索引、搜尋和關鍵字連結。您可以針對 navigator ： TableOfContents 、 Find 、 Index 或 Topic 使用下列值。

您可以使用 param 來提供命令的 Topic 進一步精簡。如果參數中指定的 navigator 值為、 Index 或 Find ，這個值應該是 null 。 TableOfContents navigator如果參數參考 Topic ，這個值應該參考包含要顯示之主題數值的物件。

參數 helpFilePath 的格式可以是 C：\path\sample.chm 或 /folder/file.htm。

另請參閱

適用於

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

使用指定的說明檔，顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

參數

owner: IWin32Window

IWin32Window 實作，將擁有強制回應對話方塊。

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

buttons: MessageBoxButtons

其中一個 MessageBoxButtons 值，指定要在訊息方塊中顯示哪些按鈕。

icon: MessageBoxIcon

其中一個 MessageBoxIcon 值，指定那個圖示要顯示在訊息方塊中。

defaultButton: MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值，指定訊息方塊的預設按鈕。

options: MessageBoxOptions

其中一個 MessageBoxOptions 值，指定訊息方塊使用的顯示及關聯的選項。如果要使用預設值，可以傳遞 0。

helpFilePath: String

使用者按一下 [說明] 按鈕時所顯示說明檔的路徑和名稱。

傳回

DialogResult

其中一個 DialogResult 值。

例外狀況

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成員。

-或-

icon 不是 MessageBoxIcon 的成員。

-或-

指定的 defaultButton 參數不是 MessageBoxDefaultButton 的成員。

InvalidOperationException

嘗試在不執行使用者互動模式的處理序中顯示 MessageBox。這個由 UserInteractive 屬性所指定。

ArgumentException

options 指定 DefaultDesktopOnly 和 ServiceNotification。

-或-

buttons 指定了無效的 MessageBoxButtons 組合。

範例

下列程式碼範例示範如何顯示主表單上層的訊息方塊。訊息方塊會顯示 [說明] 按鈕。當使用者按一下 [說明] 按鈕時，就會開啟 [ Mspaint.chm 說明] 檔案。此範例會要求 Mspaint.chm 安裝說明檔。

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
System::Windows::Forms::DialogResult r2 = MessageBox::Show( this, "Message with Help file.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm" );

// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r2 = MessageBox.Show (this, "Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");

' Display a message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file.
Dim r2 As DialogResult = MessageBox.Show(Me, "Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

備註

訊息方塊是強制回應對話方塊，這表示在強制回應表單上的物件之外，無法 (鍵盤或滑鼠按一下) 輸入。程式必須隱藏或關閉強制回應表單 (通常會回應某些使用者動作) ，才能發生另一個表單的輸入。您可以使用 owner 參數來指定實作介面的特定物件 IWin32Window ，該物件將做為對話方塊的最上層視窗和擁有者。

當使用者按一下 [說明] 按鈕時，會開啟參數中指定的 helpFilePath 說明檔案。擁有訊息方塊的表單 (或使用中表單) 也會收到 HelpRequested 事件。

參數 helpFilePath 的格式可以是 C：\path\sample.chm 或 /folder/file.htm。

另請參閱

適用於

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

使用指定的說明檔和 HelpNavigator，顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

參數

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

buttons: MessageBoxButtons

其中一個 MessageBoxButtons 值，指定要在訊息方塊中顯示哪些按鈕。

icon: MessageBoxIcon

其中一個 MessageBoxIcon 值，指定那個圖示要顯示在訊息方塊中。

defaultButton: MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值，指定訊息方塊的預設按鈕。

options: MessageBoxOptions

其中一個 MessageBoxOptions 值，指定訊息方塊使用的顯示及關聯的選項。如果要使用預設值，可以傳遞 0。

helpFilePath: String

使用者按一下 [說明] 按鈕時所顯示說明檔的路徑和名稱。

navigator: HelpNavigator

其中一個 HelpNavigator 值。

傳回

DialogResult

其中一個 DialogResult 值。

例外狀況

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成員。

-或-

icon 不是 MessageBoxIcon 的成員。

-或-

指定的 defaultButton 參數不是 MessageBoxDefaultButton 的成員。

InvalidOperationException

嘗試在不執行使用者互動模式的處理序中顯示 MessageBox。這個由 UserInteractive 屬性所指定。

ArgumentException

options 指定 DefaultDesktopOnly 和 ServiceNotification。

-或-

buttons 指定了無效的 MessageBoxButtons 組合。

範例

下列程式碼範例示範如何使用 [說明] 按鈕來顯示訊息方塊。當使用者按一下 [說明] 按鈕時，會 Mspaint.chm 開啟 [說明] 檔案，並顯示 [說明索引] 索引標籤。此範例會要求 Mspaint.chm 安裝說明檔。

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Display a message box. The Help button opens 
// the Mspaint.chm Help file and shows the Help contents 
// on the Index tab.
System::Windows::Forms::DialogResult r3 = MessageBox::Show( "Message with Help file and Help navigator.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::Index );

// Display a message box. The Help button opens 
// the Mspaint.chm Help file and shows the Help contents 
// on the Index tab.
DialogResult r3 = MessageBox.Show ("Message with Help file and Help navigator.", 
                                   "Help Caption", MessageBoxButtons.OK,
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.Index);

' Display a message box. The Help button opens 
' the Mspaint.chm Help file and shows the Help contents 
' on the Index tab.
Dim r3 As DialogResult = MessageBox.Show("Message with Help file and Help navigator.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.Index)

備註

當使用者按一下 [說明] 按鈕時，會開啟參數中指定的 helpFilePath 說明檔，並顯示參數所識別的說明 navigator 內容。擁有訊息方塊的表單 (或使用中表單) 也會收到 HelpRequested 事件。

編譯的說明檔會在頁面中提供目錄、索引、搜尋和關鍵字連結。您可以針對 navigator ： TableOfContents 、 Find 、 Index 或 Topic 使用下列值。

參數 helpFilePath 的格式可以是 C：\path\sample.chm 或 /folder/file.htm。

另請參閱

適用於

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)

使用指定的說明檔和說明關鍵字，顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

參數

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

buttons: MessageBoxButtons

其中一個 MessageBoxButtons 值，指定要在訊息方塊中顯示哪些按鈕。

icon: MessageBoxIcon

其中一個 MessageBoxIcon 值，指定那個圖示要顯示在訊息方塊中。

defaultButton: MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值，指定訊息方塊的預設按鈕。

options: MessageBoxOptions

其中一個 MessageBoxOptions 值，指定訊息方塊使用的顯示及關聯的選項。如果要使用預設值，可以傳遞 0。

helpFilePath: String

使用者按一下 [說明] 按鈕時所顯示說明檔的路徑和名稱。

keyword: String

當使用者按下 [說明] 按鈕時要顯示的說明關鍵字。

傳回

DialogResult

其中一個 DialogResult 值。

例外狀況

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成員。

-或-

icon 不是 MessageBoxIcon 的成員。

-或-

指定的 defaultButton 參數不是 MessageBoxDefaultButton 的成員。

InvalidOperationException

嘗試在不執行使用者互動模式的處理序中顯示 MessageBox。這個由 UserInteractive 屬性所指定。

ArgumentException

options 指定 DefaultDesktopOnly 和 ServiceNotification。

-或-

buttons 指定了無效的 MessageBoxButtons 組合。

範例

下列程式碼範例示範如何使用 [說明] 按鈕來顯示訊息方塊。當使用者按一下 [說明] 按鈕時，即 Mspaint.chm 會開啟 [說明] 檔案， mspaint.chm::/paint_brush.htm 並顯示關鍵字所識別的主題。此範例會要求 Mspaint.chm 安裝說明檔。

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
System::Windows::Forms::DialogResult r7 = MessageBox::Show( "Message with Help file and keyword.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", "mspaint.chm::/paint_brush.htm" );

// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r7 = MessageBox.Show ("Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");

' Display a message box. The Help button opens the Mspaint.chm Help file, 
' and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
' associated topic.
Dim r7 As DialogResult = MessageBox.Show("Message with Help file and keyword.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, 0, _
                                   "mspaint.chm", _
                                   "mspaint.chm::/paint_brush.htm")

備註

另請參閱

適用於

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

在指定物件的前面顯示含有指定文字、標題、按鈕、圖示、預設按鈕和選項的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

參數

owner: IWin32Window

IWin32Window 實作，將擁有強制回應對話方塊。

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

buttons: MessageBoxButtons

其中一個 MessageBoxButtons 值，指定要在訊息方塊中顯示哪些按鈕。

icon: MessageBoxIcon

其中一個 MessageBoxIcon 值，指定那個圖示要顯示在訊息方塊中。

defaultButton: MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值，指定訊息方塊的預設按鈕。

options: MessageBoxOptions

其中一個 MessageBoxOptions 值，指定訊息方塊使用的顯示及關聯的選項。如果要使用預設值，可以傳遞 0。

傳回

DialogResult

其中一個 DialogResult 值。

例外狀況

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成員。

-或-

icon 不是 MessageBoxIcon 的成員。

-或-

defaultButton 不是 MessageBoxDefaultButton 的成員。

InvalidOperationException

嘗試在不執行使用者互動模式的處理序中顯示 MessageBox。這個由 UserInteractive 屬性所指定。

ArgumentException

options 指定 DefaultDesktopOnly 和 ServiceNotification。

-或-

options 指定 DefaultDesktopOnly 或 ServiceNotification 並指定 owner 參數中的值。這兩個選項的使用時機為，當您叫用 (Invoke) 的方法版本無法接受 owner 參數時。

-或-

buttons 指定了無效的 MessageBoxButtons 組合。

範例

下列程式碼範例示範如何使用這個多載 Show 所支援的選項來顯示 MessageBox 。確認字串變數 ServerName 為空白之後，此範例會顯示， MessageBox 為使用者提供取消作業的選項。 Show如果方法的傳回值評估為 Yes ，則會關閉顯示 MessageBox 的表單。

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }


private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}

Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

備註

您可以使用 owner 參數來指定實作介面的特定物件 IWin32Window ，該物件將做為對話方塊的最上層視窗和擁有者。訊息方塊是強制回應對話方塊，這表示在強制回應表單上的物件之外，無法 (鍵盤或滑鼠按一下) 輸入。程式必須隱藏或關閉強制回應表單 (通常會回應某些使用者動作) ，才能發生另一個表單的輸入。

訊息方塊中最多可以有三個按鈕。

另請參閱

適用於

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)

使用指定的說明檔，顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

參數

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

buttons: MessageBoxButtons

其中一個 MessageBoxButtons 值，指定要在訊息方塊中顯示哪些按鈕。

icon: MessageBoxIcon

其中一個 MessageBoxIcon 值，指定那個圖示要顯示在訊息方塊中。

defaultButton: MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值，指定訊息方塊的預設按鈕。

options: MessageBoxOptions

其中一個 MessageBoxOptions 值，指定訊息方塊使用的顯示及關聯的選項。如果要使用預設值，可以傳遞 0。

helpFilePath: String

使用者按一下 [說明] 按鈕時所顯示說明檔的路徑和名稱。

傳回

DialogResult

其中一個 DialogResult 值。

例外狀況

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成員。

-或-

icon 不是 MessageBoxIcon 的成員。

-或-

指定的 defaultButton 參數不是 MessageBoxDefaultButton 的成員。

InvalidOperationException

嘗試在不執行使用者互動模式的處理序中顯示 MessageBox。這個由 UserInteractive 屬性所指定。

ArgumentException

options 指定 DefaultDesktopOnly 和 ServiceNotification。

-或-

buttons 指定了無效的 MessageBoxButtons 組合。

範例

下列程式碼範例示範如何使用 [說明] 按鈕來顯示訊息方塊。當使用者按一下 [說明] 按鈕時，就會開啟 [ Mspaint.chm 說明] 檔案。此範例會要求 Mspaint.chm 安裝說明檔。

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Display a message box with a help button. 
// The Help button opens the Mspaint.chm Help file.
System::Windows::Forms::DialogResult r1 = MessageBox::Show( "Message with Help file.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm" );

// Display a message box with a help button. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r1 = MessageBox.Show ("Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");

' Display a message box with a help button. 
' The Help button opens the Mspaint.chm Help file.
Dim r1 As DialogResult = MessageBox.Show("Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

備註

當使用者按一下 [說明] 按鈕時，會開啟參數中指定的 helpFilePath 說明檔案。擁有訊息方塊的表單 (或使用中表單) 也會收到 HelpRequested 事件。

參數 helpFilePath 的格式可以是 C：\path\sample.chm 或 /folder/file.htm。

另請參閱

適用於

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)

顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, bool displayHelpButton);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * bool -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, displayHelpButton As Boolean) As DialogResult

參數

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

buttons: MessageBoxButtons

其中一個 MessageBoxButtons 值，指定要在訊息方塊中顯示哪些按鈕。

icon: MessageBoxIcon

其中一個 MessageBoxIcon 值，指定那個圖示要顯示在訊息方塊中。

defaultButton: MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值，指定訊息方塊的預設按鈕。

options: MessageBoxOptions

其中一個 MessageBoxOptions 值，指定訊息方塊使用的顯示及關聯的選項。如果要使用預設值，可以傳遞 0。

displayHelpButton: Boolean

若要顯示 [說明] 按鈕，則為 true，否則為 false。預設為 false。

傳回

DialogResult

其中一個 DialogResult 值。

例外狀況

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成員。

-或-

icon 不是 MessageBoxIcon 的成員。

-或-

指定的 defaultButton 參數不是 MessageBoxDefaultButton 的成員。

InvalidOperationException

嘗試在不執行使用者互動模式的處理序中顯示 MessageBox。這個由 UserInteractive 屬性所指定。

ArgumentException

options 指定 DefaultDesktopOnly 和 ServiceNotification。

-或-

buttons 指定了無效的 MessageBoxButtons 組合。

範例

下列程式碼範例示範如何使用 [說明] 按鈕顯示訊息方塊、處理 Control.HelpRequested 事件，以及顯示自訂說明視窗以回應事件。

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
System::Windows::Forms::DialogResult AlertMessageWithCustomHelpWindow()
{
   
   // Handle the HelpRequested event for the following message.
   this->HelpRequested += gcnew System::Windows::Forms::HelpEventHandler( this, &Form1::Form1_HelpRequested );
   this->Tag = "Message with Help button.";
   
   // Show a message box with OK and Help buttons.
   System::Windows::Forms::DialogResult r = MessageBox::Show( "Message with Help button.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, true );
   
   // Remove the HelpRequested event handler to keep the event
   // from being handled for other message boxes.
   this->HelpRequested -= gcnew System::Windows::Forms::HelpEventHandler( this, &Form1::Form1_HelpRequested );
   
   // Return the dialog box result.
   return r;
}

void Form1_HelpRequested( System::Object^ sender, System::Windows::Forms::HelpEventArgs^ hlpevent )
{
   
   // Create a custom Help window in response to the HelpRequested event.
   Form^ helpForm = gcnew Form;
   
   // Set up the form position, size, and title caption.
   helpForm->StartPosition = FormStartPosition::Manual;
   helpForm->Size = System::Drawing::Size( 200, 400 );
   helpForm->DesktopLocation = Point(this->DesktopBounds.X + this->Size.Width,this->DesktopBounds.Top);
   helpForm->Text = "Help Form";
   
   // Create a label to contain the Help text.
   Label^ helpLabel = gcnew Label;
   
   // Add the label to the form and set its text.
   helpForm->Controls->Add( helpLabel );
   helpLabel->Dock = DockStyle::Fill;
   
   // Use the sender parameter to identify the context of the Help request.
   // The parameter must be cast to the Control type to get the Tag property.
   Control^ senderControl = dynamic_cast<Control^>(sender);
   helpLabel->Text = String::Format( "Help information shown in response to user action on the '{0}' message.", dynamic_cast<String^>(senderControl->Tag) );
   
   // Set the Help form to be owned by the main form. This helps
   // to ensure that the Help form is disposed of.
   this->AddOwnedForm( helpForm );
   
   // Show the custom Help window.
   helpForm->Show();
   
   // Indicate that the HelpRequested event is handled.
   hlpevent->Handled = true;
}

// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
private DialogResult AlertMessageWithCustomHelpWindow ()
{
    // Handle the HelpRequested event for the following message.
    this.HelpRequested += new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

    this.Tag = "Message with Help button.";

    // Show a message box with OK and Help buttons.
    DialogResult r = MessageBox.Show ("Message with Help button.", 
                                      "Help Caption", MessageBoxButtons.OK, 
                                      MessageBoxIcon.Question, 
                                      MessageBoxDefaultButton.Button1, 
                                      0, true);

    // Remove the HelpRequested event handler to keep the event
    // from being handled for other message boxes.
    this.HelpRequested -= new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

    // Return the dialog box result.
    return r;
}

private void Form1_HelpRequested (System.Object sender, System.Windows.Forms.HelpEventArgs hlpevent)
{
    // Create a custom Help window in response to the HelpRequested event.
    Form helpForm = new Form ();

    // Set up the form position, size, and title caption.
    helpForm.StartPosition = FormStartPosition.Manual;
    helpForm.Size = new Size (200, 400);
    helpForm.DesktopLocation = new Point (this.DesktopBounds.X + 
                                          this.Size.Width, 
                                          this.DesktopBounds.Top);
    helpForm.Text = "Help Form";

    // Create a label to contain the Help text.
    Label helpLabel = new Label ();

    // Add the label to the form and set its text.
    helpForm.Controls.Add (helpLabel);
    helpLabel.Dock = DockStyle.Fill;

    // Use the sender parameter to identify the context of the Help request.
    // The parameter must be cast to the Control type to get the Tag property.
    Control senderControl = sender as Control;

    helpLabel.Text = "Help information shown in response to user action on the '" + 
                      (string)senderControl.Tag + "' message.";

    // Set the Help form to be owned by the main form. This helps
    // to ensure that the Help form is disposed of.
    this.AddOwnedForm (helpForm);

    // Show the custom Help window.
    helpForm.Show ();

    // Indicate that the HelpRequested event is handled.
    hlpevent.Handled = true;
}

' Display a message box with a Help button. Show a custom Help window
' by handling the HelpRequested event.
Private Function AlertMessageWithCustomHelpWindow() As DialogResult

    ' Handle the HelpRequested event for the following message.
    AddHandler Me.HelpRequested, AddressOf Me.Form1_HelpRequested

    Me.Tag = "Message with Help button."

    ' Show a message box with OK and Help buttons.
    Dim r As DialogResult = MessageBox.Show("Message with Help button.", _
                                          "Help Caption", MessageBoxButtons.OK, _
                                          MessageBoxIcon.Question, _
                                          MessageBoxDefaultButton.Button1, _
                                          0, True)

    ' Remove the HelpRequested event handler to keep the event
    ' from being handled for other message boxes.
    RemoveHandler Me.HelpRequested, AddressOf Me.Form1_HelpRequested

    ' Return the dialog box result.
    Return r
End Function

Private Sub Form1_HelpRequested(ByVal sender As System.Object, ByVal hlpevent As System.Windows.Forms.HelpEventArgs)

    ' Create a custom Help window in response to the HelpRequested event.
    Dim helpForm As Form = New Form

    ' Set up the form position, size, and title caption.
    With helpForm
        .StartPosition = FormStartPosition.Manual
        .Size = New Size(200, 400)
        .DesktopLocation = New Point(Me.DesktopBounds.X + _
                                     Me.Size.Width, Me.DesktopBounds.Top)
        .Text = "Help Form"
    End With

    ' Create a label to contain the Help text.
    Dim helpLabel As Label = New Label

    ' Add the label to the form and set its text.
    helpForm.Controls.Add(helpLabel)
    helpLabel.Dock = DockStyle.Fill

    ' Use the sender parameter to identify the context of the Help request.
    ' The parameter must be cast to the Control type to get the Tag property.
    Dim senderControl As Control = CType(sender, Control)

    helpLabel.Text = "Help information shown in response to user action on the '" & _
                      CStr(senderControl.Tag) & "' message."

    ' Set the Help form to be owned by the main form. This helps
    ' to ensure that the Help form is disposed of.
    Me.AddOwnedForm(helpForm)

    ' Show the custom Help window.
    helpForm.Show()

    ' Indicate that the HelpRequested event is handled.
    hlpevent.Handled = True
End Sub

備註

當使用者按一下 [說明] 按鈕時，擁有訊息方塊的表單 (或作用中表單) 收到 HelpRequested 事件。處理事件以執行自訂說明 HelpRequested 動作。

另請參閱

適用於

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)

使用指定的說明檔和 HelpNavigator，顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

參數

owner: IWin32Window

IWin32Window 實作，將擁有強制回應對話方塊。

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

buttons: MessageBoxButtons

其中一個 MessageBoxButtons 值，指定要在訊息方塊中顯示哪些按鈕。

icon: MessageBoxIcon

其中一個 MessageBoxIcon 值，指定那個圖示要顯示在訊息方塊中。

defaultButton: MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值，指定訊息方塊的預設按鈕。

options: MessageBoxOptions

其中一個 MessageBoxOptions 值，指定訊息方塊使用的顯示及關聯的選項。如果要使用預設值，可以傳遞 0。

helpFilePath: String

使用者按一下 [說明] 按鈕時所顯示說明檔的路徑和名稱。

navigator: HelpNavigator

其中一個 HelpNavigator 值。

傳回

DialogResult

其中一個 DialogResult 值。

例外狀況

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成員。

-或-

icon 不是 MessageBoxIcon 的成員。

-或-

指定的 defaultButton 參數不是 MessageBoxDefaultButton 的成員。

InvalidOperationException

嘗試在不執行使用者互動模式的處理序中顯示 MessageBox。這個由 UserInteractive 屬性所指定。

ArgumentException

options 指定 DefaultDesktopOnly 和 ServiceNotification。

-或-

buttons 指定了無效的 MessageBoxButtons 組合。

範例

下列程式碼範例示範如何顯示主視窗上層的訊息方塊。訊息方塊會顯示 [說明] 按鈕。當使用者按一下 [說明] 按鈕時，會 Mspaint.chm 開啟 [說明] 檔案，並顯示 [說明索引] 索引標籤。此範例會要求 Mspaint.chm 安裝說明檔。

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file
// and shows the Help contents on the Index tab.
System::Windows::Forms::DialogResult r4 = MessageBox::Show( this, "Message with Help file and Help navigator.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::Index );

// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file
// and shows the Help contents on the Index tab.
DialogResult r4 = MessageBox.Show (this, 
                                   "Message with Help file and Help navigator.", 
                                   "Help Caption", MessageBoxButtons.OK,
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.Index);

' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file
' and shows the Help contents on the Index tab.
Dim r4 As DialogResult = MessageBox.Show(Me, _
                                      "Message with Help file and Help navigator.", _
                                      "Help Caption", MessageBoxButtons.OK, _
                                      MessageBoxIcon.Question, _
                                      MessageBoxDefaultButton.Button1, _
                                      0, "mspaint.chm", _
                                      HelpNavigator.Index)

備註

訊息方塊是強制回應對話方塊，這表示沒有輸入 (鍵盤或滑鼠按一下) 會發生，但強制回應表單上的物件除外。程式必須隱藏或關閉強制回應表單 (通常會回應某些使用者動作) ，才能發生另一個表單的輸入。您可以使用 owner 參數來指定實作介面的特定物件 IWin32Window ，該物件將做為對話方塊的最上層視窗和擁有者。

當使用者按一下 [說明] 按鈕時，會開啟參數中指定的 helpFilePath 說明檔案，並顯示參數所 navigator 識別的說明內容。擁有訊息方塊的表單 (或作用中表單) 也會接收 HelpRequested 事件。

編譯的說明檔提供頁面中的內容目錄、索引、搜尋和關鍵字連結。您可以使用下列值 navigator ： TableOfContents 、 Find 、 Index 或 Topic 。

參數 helpFilePath 的格式可以是 C：\path\sample.chm 或 /folder/file.htm。

另請參閱

適用於

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

在指定物件的前面顯示含有指定文字、標題、按鈕、圖示和預設按鈕的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

參數

owner: IWin32Window

IWin32Window 實作，將擁有強制回應對話方塊。

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

buttons: MessageBoxButtons

其中一個 MessageBoxButtons 值，指定要在訊息方塊中顯示哪些按鈕。

icon: MessageBoxIcon

其中一個 MessageBoxIcon 值，指定那個圖示要顯示在訊息方塊中。

defaultButton: MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值，指定訊息方塊的預設按鈕。

傳回

DialogResult

其中一個 DialogResult 值。

例外狀況

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成員。

-或-

icon 不是 MessageBoxIcon 的成員。

-或-

defaultButton 不是 MessageBoxDefaultButton 的成員。

InvalidOperationException

嘗試在不執行使用者互動模式的處理序中顯示 MessageBox。這個由 UserInteractive 屬性所指定。

範例

下列程式碼範例示範如何使用這個多載 Show 所支援的選項來顯示 MessageBox 。確認字串變數、 ServerName 為空白之後，此範例會顯示 MessageBox ，為使用者提供取消作業的選項。 Show如果方法的傳回值評估為 Yes ，則會關閉顯示 MessageBox 的表單。

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }


private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}

Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

備註

您可以使用 owner 參數來指定實作介面的特定物件 IWin32Window ，該物件將做為對話方塊的最上層視窗和擁有者。訊息方塊是強制回應對話方塊，這表示沒有輸入 (鍵盤或滑鼠按一下) 會發生，但強制回應表單上的物件除外。程式必須隱藏或關閉強制回應表單 (通常會回應某些使用者動作) ，才能發生另一個表單的輸入。

訊息方塊中最多可以有三個按鈕。

另請參閱

適用於

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)

在指定物件的前面顯示含有指定文字、標題、按鈕和圖示的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

參數

owner: IWin32Window

IWin32Window 實作，將擁有強制回應對話方塊。

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

buttons: MessageBoxButtons

其中一個 MessageBoxButtons 值，指定要在訊息方塊中顯示哪些按鈕。

icon: MessageBoxIcon

其中一個 MessageBoxIcon 值，指定那個圖示要顯示在訊息方塊中。

傳回

DialogResult

其中一個 DialogResult 值。

例外狀況

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成員。

-或-

icon 不是 MessageBoxIcon 的成員。

InvalidOperationException

嘗試在不執行使用者互動模式的處理序中顯示 MessageBox。這個由 UserInteractive 屬性所指定。

範例

private:
   void validateUserEntry4()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry4()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}

Private Sub ValidateUserEntry4()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, MessageBoxIcon.Question)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

備註

訊息方塊中最多可以有三個按鈕。

另請參閱

適用於

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)

顯示含有指定文字、標題、圖示和預設按鈕的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

參數

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

buttons: MessageBoxButtons

其中一個 MessageBoxButtons 值，指定要在訊息方塊中顯示哪些按鈕。

icon: MessageBoxIcon

其中一個 MessageBoxIcon 值，指定那個圖示要顯示在訊息方塊中。

defaultButton: MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值，指定訊息方塊的預設按鈕。

傳回

DialogResult

其中一個 DialogResult 值。

例外狀況

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成員。

-或-

icon 不是 MessageBoxIcon 的成員。

-或-

defaultButton 不是 MessageBoxDefaultButton 的成員。

InvalidOperationException

嘗試在不執行使用者互動模式的處理序中顯示 MessageBox。這個由 UserInteractive 屬性所指定。

範例

下列程式碼範例示範如何使用這個多載 Show 所支援的選項來顯示 MessageBox 。確認字串變數為 ServerName 空白之後，此範例會顯示 MessageBox 具有問題方塊圖示的，為使用者提供取消作業的選項。 Show如果方法的傳回值評估為 Yes ，則會關閉顯示 MessageBox 的表單。

private:
   void validateUserEntry3()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1 );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry3()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
        MessageBoxIcon.Question, MessageBoxDefaultButton.Button1);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}

Private Sub ValidateUserEntry3()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, MessageBoxIcon.Question, _
            MessageBoxDefaultButton.Button1)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If
End Sub

備註

訊息方塊中最多可以有三個按鈕。

另請參閱

適用於

Show(IWin32Window, String, String, MessageBoxButtons)

在指定物件的前面顯示含有指定文字、標題和按鈕的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

參數

owner: IWin32Window

IWin32Window 實作，將擁有強制回應對話方塊。

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

buttons: MessageBoxButtons

其中一個 MessageBoxButtons 值，指定要在訊息方塊中顯示哪些按鈕。

傳回

DialogResult

其中一個 DialogResult 值。

例外狀況

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成員。

InvalidOperationException

嘗試在不執行使用者互動模式的處理序中顯示 MessageBox。這個由 UserInteractive 屬性所指定。

範例

private:
   void validateUserEntry5()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry5()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}

Private Sub ValidateUserEntry5()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

備註

訊息方塊中最多可以有三個按鈕。

另請參閱

MessageBoxButtons

適用於

Show(String, String, MessageBoxButtons, MessageBoxIcon)

顯示含有指定文字、標題、按鈕和圖示的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

參數

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

buttons: MessageBoxButtons

其中一個 MessageBoxButtons 值，指定要在訊息方塊中顯示哪些按鈕。

icon: MessageBoxIcon

其中一個 MessageBoxIcon 值，指定那個圖示要顯示在訊息方塊中。

傳回

DialogResult

其中一個 DialogResult 值。

例外狀況

InvalidEnumArgumentException

指定的 buttons 參數不是 MessageBoxButtons 的成員。

-或-

指定的 icon 參數不是 MessageBoxIcon 的成員。

InvalidOperationException

嘗試在不執行使用者互動模式的處理序中顯示 MessageBox。這個由 UserInteractive 屬性所指定。

範例

下列程式碼範例示範處理 ComboBox.DropDown 事件時的其中 Show 一個方法。若要執行此範例，請將下列程式碼貼到表單中，並從表單的建構函式或 Load 方法呼叫 InitializeComboBox 方法。

internal:
   // Declare ComboBox1
   System::Windows::Forms::ComboBox^ ComboBox1;

private:
   // Initialize ComboBox1.
   void InitializeComboBox()
   {
      this->ComboBox1 = gcnew ComboBox;
      this->ComboBox1->Location = System::Drawing::Point( 128, 48 );
      this->ComboBox1->Name = "ComboBox1";
      this->ComboBox1->Size = System::Drawing::Size( 100, 21 );
      this->ComboBox1->TabIndex = 0;
      this->ComboBox1->Text = "Typical";
      array<String^>^ installs = {"Typical","Compact","Custom"};
      ComboBox1->Items->AddRange( installs );
      this->Controls->Add( this->ComboBox1 );
      
      // Hook up the event handler.
      this->ComboBox1->DropDown += gcnew System::EventHandler(
         this, &Form1::ComboBox1_DropDown );
   }

   // Handles the ComboBox1 DropDown event. If the user expands the  
   // drop-down box, a message box will appear, recommending the
   // typical installation.
   void ComboBox1_DropDown( Object^ sender, System::EventArgs^ e )
   {
      MessageBox::Show( "Typical installation is strongly recommended.",
         "Install information", MessageBoxButtons::OK,
         MessageBoxIcon::Information );
   }


// Declare ComboBox1.
internal System.Windows.Forms.ComboBox ComboBox1;

// Initialize ComboBox1.
private void InitializeComboBox()
{
    this.ComboBox1 = new ComboBox();
    this.ComboBox1.Location = new System.Drawing.Point(128, 48);
    this.ComboBox1.Name = "ComboBox1";
    this.ComboBox1.Size = new System.Drawing.Size(100, 21);
    this.ComboBox1.TabIndex = 0;
    this.ComboBox1.Text	= "Typical";
    string[] installs = new string[]{"Typical", "Compact", "Custom"};
    ComboBox1.Items.AddRange(installs);
    this.Controls.Add(this.ComboBox1);
    
    // Hook up the event handler.
    this.ComboBox1.DropDown +=  
        new System.EventHandler(ComboBox1_DropDown);
}

// Handles the ComboBox1 DropDown event. If the user expands the  
// drop-down box, a message box will appear, recommending the
// typical installation.
private void ComboBox1_DropDown(object sender, System.EventArgs e)
{
    MessageBox.Show("Typical installation is strongly recommended.", 
    "Install information", MessageBoxButtons.OK, 
        MessageBoxIcon.Information);
}


' Declare ComboBox1.
Friend WithEvents ComboBox1 As System.Windows.Forms.ComboBox

' Initialize ComboBox1.
Private Sub InitializeComboBox()
    Me.ComboBox1 = New ComboBox
    Me.ComboBox1.Location = New System.Drawing.Point(128, 48)
    Me.ComboBox1.Name = "ComboBox1"
    Me.ComboBox1.Size = New System.Drawing.Size(100, 21)
    Me.ComboBox1.TabIndex = 0
    Me.ComboBox1.Text = "Typical"
    Dim installs() As String = New String() _
        {"Typical", "Compact", "Custom"}
    ComboBox1.Items.AddRange(installs)
    Me.Controls.Add(Me.ComboBox1)
End Sub

' Handles the ComboBox1 DropDown event. If the user expands the  
' drop-down box, a message box will appear, recommending the
' typical installation.
Private Sub ComboBox1_DropDown _ 
    (ByVal sender As Object, ByVal e As System.EventArgs) _ 
    Handles ComboBox1.DropDown
    MessageBox.Show("Typical installation is strongly recommended.", _
    "Install information", MessageBoxButtons.OK, MessageBoxIcon.Information)
End Sub

備註

訊息方塊中最多可以有三個按鈕。

另請參閱

適用於

Show(IWin32Window, String, String)

在指定物件的前面顯示含有指定文字和標題的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption);

static member Show : System.Windows.Forms.IWin32Window * string * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String) As DialogResult

參數

owner: IWin32Window

IWin32Window 實作，將擁有強制回應對話方塊。

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

傳回

DialogResult

其中一個 DialogResult 值。

備註

根據預設，訊息方塊會顯示 [ 確定 ] 按鈕。

適用於

Show(String, String, MessageBoxButtons)

顯示含有指定文字、標題和按鈕的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

參數

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

buttons: MessageBoxButtons

其中一個 MessageBoxButtons 值，指定要在訊息方塊中顯示哪些按鈕。

傳回

DialogResult

其中一個 DialogResult 值。

例外狀況

InvalidEnumArgumentException

指定的 buttons 參數不是 MessageBoxButtons 的成員。

InvalidOperationException

嘗試在不執行使用者互動模式的處理序中顯示 MessageBox。這個由 UserInteractive 屬性所指定。

範例

private:
   void validateUserEntry()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;

         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry()
{
    // Checks the value of the text.
    if(serverName.Text.Length == 0)
    {
        // Initializes the variables to pass to the MessageBox.Show method.
        string message = "You did not enter a server name. Cancel this operation?";
     string caption = "Error Detected in Input";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.
        result = MessageBox.Show(message, caption, buttons);
        if (result == System.Windows.Forms.DialogResult.Yes)
        {
            // Closes the parent form.
            this.Close();
        }
    }
}

Private Sub ValidateUserEntry()
    ' Checks the value of the text.
    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.
        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "Error Detected in Input"
        Dim Buttons As MessageBoxButtons = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays the MessageBox
        Result = MessageBox.Show(Message, Caption, Buttons)

        ' Gets the result of the MessageBox display.
        If Result = System.Windows.Forms.DialogResult.Yes Then
            ' Closes the parent form.
            Me.Close()
        End If
    End If
End Sub

備註

訊息方塊中最多可以有三個按鈕。

另請參閱

MessageBoxButtons

適用於

Show(IWin32Window, String)

在指定物件的前面顯示含有指定文字的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text);

static member Show : System.Windows.Forms.IWin32Window * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String) As DialogResult

參數

owner: IWin32Window

IWin32Window 實作，將擁有強制回應對話方塊。

text: String

要顯示在訊息方塊中的文字。

傳回

DialogResult

其中一個 DialogResult 值。

備註

根據預設，訊息方塊會顯示 [ 確定 ] 按鈕。訊息方塊不包含標題中的標題。

適用於

Show(String, String)

顯示含有指定文字和標題的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption);

public static System.Windows.Forms.DialogResult Show (string text, string caption);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption);

static member Show : string * string -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String) As DialogResult

參數

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

傳回

DialogResult

其中一個 DialogResult 值。

備註

根據預設，訊息方塊會顯示 [ 確定 ] 按鈕。

適用於

Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)

顯示含有指定文字、標題、按鈕、圖示、預設按鈕和選項的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);

public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);

public static System.Windows.Forms.DialogResult Show (string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);

static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult

Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

參數

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

buttons: MessageBoxButtons

其中一個 MessageBoxButtons 值，指定要在訊息方塊中顯示哪些按鈕。

icon: MessageBoxIcon

其中一個 MessageBoxIcon 值，指定那個圖示要顯示在訊息方塊中。

defaultButton: MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值，指定訊息方塊的預設按鈕。

options: MessageBoxOptions

其中一個 MessageBoxOptions 值，指定訊息方塊使用的顯示及關聯的選項。如果要使用預設值，可以傳遞 0。

傳回

DialogResult

其中一個 DialogResult 值。

例外狀況

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成員。

-或-

icon 不是 MessageBoxIcon 的成員。

-或-

指定的 defaultButton 參數不是 MessageBoxDefaultButton 的成員。

InvalidOperationException

嘗試在不執行使用者互動模式的處理序中顯示 MessageBox。這個由 UserInteractive 屬性所指定。

ArgumentException

options 指定 DefaultDesktopOnly 和 ServiceNotification。

-或-

buttons 指定了無效的 MessageBoxButtons 組合。

範例

下列程式碼範例示範如何使用這個多載 Show 所支援的選項來顯示 MessageBox 。確認字串變數為 ServerName 空白之後，此範例會顯示 MessageBox 具有問題方塊圖示的，為使用者提供取消作業的選項。此範例會 RightAlign 使用列舉的成員 MessageBoxOptions ，將文字對齊對話方塊的右邊緣。 Show如果方法的傳回值評估為 Yes ，則會關閉顯示 MessageBox 的表單。

private:
   void validateUserEntry2()
   {
      // Checks the value of the text.
      if ( serverName->Text->Length == 0 )
      {
         // Initializes the variables to pass to the MessageBox::Show method.
         String^ message = "You did not enter a server name. Cancel this operation?";
         String^ caption = "No Server Name Specified";
         MessageBoxButtons buttons = MessageBoxButtons::YesNo;
         System::Windows::Forms::DialogResult result;
         
         // Displays the MessageBox.
         result = MessageBox::Show( this, message, caption, buttons, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }


private void validateUserEntry2()
{

    // Checks the value of the text.

    if(serverName.Text.Length == 0)
    {

        // Initializes the variables to pass to the MessageBox.Show method.

        string message = "You did not enter a server name. Cancel this operation?";
        string caption = "No Server Name Specified";
        MessageBoxButtons buttons = MessageBoxButtons.YesNo;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}

Private Sub ValidateUserEntry2()


    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

備註

訊息方塊中最多可以有三個按鈕。

另請參閱

適用於

Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

使用指定的說明檔、HelpNavigator 和說明主題，顯示含有指定文字、標題、按鈕、圖示、預設按鈕、選項和 [說明] 按鈕的訊息方塊。

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);

public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window? owner, string? text, string? caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object? param);

static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult

Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

參數

owner: IWin32Window

IWin32Window 實作，將擁有強制回應對話方塊。

text: String

要顯示在訊息方塊中的文字。

caption: String

要顯示在訊息方塊標題列中的文字。

buttons: MessageBoxButtons

其中一個 MessageBoxButtons 值，指定要在訊息方塊中顯示哪些按鈕。

icon: MessageBoxIcon

其中一個 MessageBoxIcon 值，指定那個圖示要顯示在訊息方塊中。

defaultButton: MessageBoxDefaultButton

其中一個 MessageBoxDefaultButton 值，指定訊息方塊的預設按鈕。

options: MessageBoxOptions

其中一個 MessageBoxOptions 值，指定訊息方塊使用的顯示及關聯的選項。如果要使用預設值，可以傳遞 0。

helpFilePath: String

使用者按一下 [說明] 按鈕時所顯示說明檔的路徑和名稱。

navigator: HelpNavigator

其中一個 HelpNavigator 值。

param: Object

當使用者按下 [說明] 按鈕時要顯示之說明主題的數字 ID。

傳回

DialogResult

其中一個 DialogResult 值。

例外狀況

InvalidEnumArgumentException

buttons 不是 MessageBoxButtons 的成員。

-或-

icon 不是 MessageBoxIcon 的成員。

-或-

指定的 defaultButton 參數不是 MessageBoxDefaultButton 的成員。

InvalidOperationException

嘗試在不執行使用者互動模式的處理序中顯示 MessageBox。這個由 UserInteractive 屬性所指定。

ArgumentException

options 指定 DefaultDesktopOnly 和 ServiceNotification。

-或-

buttons 指定了無效的 MessageBoxButtons 組合。

範例

下列程式碼範例示範如何顯示主視窗上層的訊息方塊。訊息方塊會顯示 [說明] 按鈕。當使用者按一下 [說明] 按鈕時， Mspaint.chm 即會開啟 [說明] 檔案，並顯示關鍵字所識別的 ovals [說明索引] 索引標籤和主題。此範例需要 Mspaint.chm 安裝說明檔。

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;

Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms

// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
System::Windows::Forms::DialogResult r6 = MessageBox::Show( this, "Message with Help file and Help navigator with additional parameter.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::KeywordIndex, "ovals" );

// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r6 = MessageBox.Show (this, 
                                   "Message with Help file and Help navigator with additional parameter.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.KeywordIndex, "ovals");

' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file, 
' shows index with the "ovals" keyword selected, and displays the
' associated topic.
Dim r6 As DialogResult = MessageBox.Show(Me, _
                                   "Message with Help file and Help navigator with additional parameter.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.KeywordIndex, "ovals")

備註

編譯的說明檔會在頁面中提供目錄、索引、搜尋和關鍵字連結。您可以針對 navigator ： TableOfContents 、 Find 、 Index 或 Topic 使用下列值。

參數 helpFilePath 的格式可以是 C：\path\sample.chm 或 /folder/file.htm。

另請參閱

適用於