MessageBox.Show Method

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Displays a message box.

Overloads

Show(String)	Displays a message box that has a message and that returns a result.
Show(String, String)	Displays a message box that has a message and title bar caption; and that returns a result.
Show(Window, String)	Displays a message box in front of the specified window. The message box displays a message and returns a result.
Show(String, String, MessageBoxButton)	Displays a message box that has a message, title bar caption, and button; and that returns a result.
Show(Window, String, String)	Displays a message box in front of the specified window. The message box displays a message and title bar caption; and it returns a result.
Show(String, String, MessageBoxButton, MessageBoxImage)	Displays a message box that has a message, title bar caption, button, and icon; and that returns a result.
Show(Window, String, String, MessageBoxButton)	Displays a message box in front of the specified window. The message box displays a message, title bar caption, and button; and it also returns a result.
Show(String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult)	Displays a message box that has a message, title bar caption, button, and icon; and that accepts a default message box result and returns a result.
Show(Window, String, String, MessageBoxButton, MessageBoxImage)	Displays a message box in front of the specified window. The message box displays a message, title bar caption, button, and icon; and it also returns a result.
Show(String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions)	Displays a message box that has a message, title bar caption, button, and icon; and that accepts a default message box result, complies with the specified options, and returns a result.
Show(Window, String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult)	Displays a message box in front of the specified window. The message box displays a message, title bar caption, button, and icon; and accepts a default message box result and returns a result.
Show(Window, String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions)	Displays a message box in front of the specified window. The message box displays a message, title bar caption, button, and icon; and accepts a default message box result, complies with the specified options, and returns a result.

Remarks

Use an overload of the Show method, which enables you to specify an owner window. Otherwise, the message box is owned by the window that is currently active.

Show(String)

Displays a message box that has a message and that returns a result.

public:
 static System::Windows::MessageBoxResult Show(System::String ^ messageBoxText);

public static System.Windows.MessageBoxResult Show (string messageBoxText);

static member Show : string -> System.Windows.MessageBoxResult

Public Shared Function Show (messageBoxText As String) As MessageBoxResult

Parameters

messageBoxText

String

A String that specifies the text to display.

Returns

MessageBoxResult

A MessageBoxResult value that specifies which message box button is clicked by the user.

Examples

The following example shows how to use this overload of the Show method.

private void ShowMessageBoxButton_Click(object sender, RoutedEventArgs e)
{
    // Configure message box
    string message = "Hello, MessageBox!";
    // Show message box
    MessageBoxResult result = MessageBox.Show(message);
}

Private Sub showMessageBoxButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' Configure message box
    Dim message As String = "Hello, MessageBox!"
    ' Show message box
    Dim result As MessageBoxResult = MessageBox.Show(message)
End Sub

Show(String, String)

Displays a message box that has a message and title bar caption; and that returns a result.

public:
 static System::Windows::MessageBoxResult Show(System::String ^ messageBoxText, System::String ^ caption);

public static System.Windows.MessageBoxResult Show (string messageBoxText, string caption);

static member Show : string * string -> System.Windows.MessageBoxResult

Public Shared Function Show (messageBoxText As String, caption As String) As MessageBoxResult

Parameters

messageBoxText

String

A String that specifies the text to display.

caption

String

A String that specifies the title bar caption to display.

Returns

MessageBoxResult

A MessageBoxResult value that specifies which message box button is clicked by the user.

Examples

The following example shows how to use this overload of the Show method.

private void ShowMessageBoxButton_Click(object sender, RoutedEventArgs e)
{
    // Configure message box
    string message = "Message text";
    string caption = "Caption text";
    // Show message box
    MessageBoxResult result = MessageBox.Show(message, caption);
}

Private Sub showMessageBoxButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' Configure message box
    Dim message As String = "Message text"
    Dim caption As String = "Caption text"
    ' Show message box
    Dim result As MessageBoxResult = MessageBox.Show(message, caption)
End Sub

Show(Window, String)

Displays a message box in front of the specified window. The message box displays a message and returns a result.

public:
 static System::Windows::MessageBoxResult Show(System::Windows::Window ^ owner, System::String ^ messageBoxText);

public static System.Windows.MessageBoxResult Show (System.Windows.Window owner, string messageBoxText);

static member Show : System.Windows.Window * string -> System.Windows.MessageBoxResult

Public Shared Function Show (owner As Window, messageBoxText As String) As MessageBoxResult

Parameters

owner

Window

A Window that represents the owner window of the message box.

messageBoxText

String

A String that specifies the text to display.

Returns

MessageBoxResult

A MessageBoxResult value that specifies which message box button is clicked by the user.

Remarks

By default, the message box appears in front of the window that is currently active.

See also

• Activated
• Show(String)

Show(String, String, MessageBoxButton)

Displays a message box that has a message, title bar caption, and button; and that returns a result.

public:
 static System::Windows::MessageBoxResult Show(System::String ^ messageBoxText, System::String ^ caption, System::Windows::MessageBoxButton button);

public static System.Windows.MessageBoxResult Show (string messageBoxText, string caption, System.Windows.MessageBoxButton button);

static member Show : string * string * System.Windows.MessageBoxButton -> System.Windows.MessageBoxResult

Public Shared Function Show (messageBoxText As String, caption As String, button As MessageBoxButton) As MessageBoxResult

Parameters

messageBoxText

String

A String that specifies the text to display.

caption

String

A String that specifies the title bar caption to display.

button

MessageBoxButton

A MessageBoxButton value that specifies which button or buttons to display.

Returns

MessageBoxResult

A MessageBoxResult value that specifies which message box button is clicked by the user.

Examples

The following example shows how to use this overload of the Show method.

private void ShowMessageBoxButton_Click(object sender, RoutedEventArgs e)
{
    // Configure message box
    string message = "Hello, MessageBox!";
    string caption = "Caption text";
    MessageBoxButton buttons = MessageBoxButton.OKCancel;
    // Show message box
    MessageBoxResult result = MessageBox.Show(message, caption, buttons);
}

Private Sub showMessageBoxButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' Configure message box
    Dim message As String = "Hello, MessageBox!"
    Dim caption As String = "Caption text"
    Dim buttons As MessageBoxButton = MessageBoxButton.OKCancel
    ' Show message box
    Dim result As MessageBoxResult = MessageBox.Show(message, caption, buttons)
End Sub

Show(Window, String, String)

Displays a message box in front of the specified window. The message box displays a message and title bar caption; and it returns a result.

public:
 static System::Windows::MessageBoxResult Show(System::Windows::Window ^ owner, System::String ^ messageBoxText, System::String ^ caption);

public static System.Windows.MessageBoxResult Show (System.Windows.Window owner, string messageBoxText, string caption);

static member Show : System.Windows.Window * string * string -> System.Windows.MessageBoxResult

Public Shared Function Show (owner As Window, messageBoxText As String, caption As String) As MessageBoxResult

Parameters

owner

Window

A Window that represents the owner window of the message box.

messageBoxText

String

A String that specifies the text to display.

caption

String

A String that specifies the title bar caption to display.

Returns

MessageBoxResult

A MessageBoxResult value that specifies which message box button is clicked by the user.

Remarks

By default, the message box appears in front of the window that is currently active.

See also

• Activated
• Show(String, String)

Show(String, String, MessageBoxButton, MessageBoxImage)

Displays a message box that has a message, title bar caption, button, and icon; and that returns a result.

public:
 static System::Windows::MessageBoxResult Show(System::String ^ messageBoxText, System::String ^ caption, System::Windows::MessageBoxButton button, System::Windows::MessageBoxImage icon);

public static System.Windows.MessageBoxResult Show (string messageBoxText, string caption, System.Windows.MessageBoxButton button, System.Windows.MessageBoxImage icon);

static member Show : string * string * System.Windows.MessageBoxButton * System.Windows.MessageBoxImage -> System.Windows.MessageBoxResult

Public Shared Function Show (messageBoxText As String, caption As String, button As MessageBoxButton, icon As MessageBoxImage) As MessageBoxResult

Parameters

messageBoxText

String

A String that specifies the text to display.

caption

String

A String that specifies the title bar caption to display.

button

MessageBoxButton

A MessageBoxButton value that specifies which button or buttons to display.

icon

MessageBoxImage

A MessageBoxImage value that specifies the icon to display.

Returns

MessageBoxResult

A MessageBoxResult value that specifies which message box button is clicked by the user.

Examples

The following example shows how to use this overload of the Show method.

private void ShowMessageBoxButton_Click(object sender, RoutedEventArgs e)
{
    // Configure message box
    string message = "Hello, MessageBox!";
    string caption = "Caption text";
    MessageBoxButton buttons = MessageBoxButton.OKCancel;
    MessageBoxImage icon = MessageBoxImage.Information;
    // Show message box
    MessageBoxResult result = MessageBox.Show(message, caption, buttons, icon);
}

Private Sub showMessageBoxButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' Configure message box
    Dim message As String = "Hello, MessageBox!"
    Dim caption As String = "Caption text"
    Dim buttons As MessageBoxButton = MessageBoxButton.OKCancel
    Dim icon As MessageBoxImage = MessageBoxImage.Information
    ' Show message box
    Dim result As MessageBoxResult = MessageBox.Show(message, caption, buttons, icon)
End Sub

Show(Window, String, String, MessageBoxButton)

Displays a message box in front of the specified window. The message box displays a message, title bar caption, and button; and it also returns a result.

public:
 static System::Windows::MessageBoxResult Show(System::Windows::Window ^ owner, System::String ^ messageBoxText, System::String ^ caption, System::Windows::MessageBoxButton button);

public static System.Windows.MessageBoxResult Show (System.Windows.Window owner, string messageBoxText, string caption, System.Windows.MessageBoxButton button);

static member Show : System.Windows.Window * string * string * System.Windows.MessageBoxButton -> System.Windows.MessageBoxResult

Public Shared Function Show (owner As Window, messageBoxText As String, caption As String, button As MessageBoxButton) As MessageBoxResult

Parameters

owner

Window

A Window that represents the owner window of the message box.

messageBoxText

String

A String that specifies the text to display.

caption

String

A String that specifies the title bar caption to display.

button

MessageBoxButton

A MessageBoxButton value that specifies which button or buttons to display.

Returns

MessageBoxResult

A MessageBoxResult value that specifies which message box button is clicked by the user.

Remarks

By default, the message box appears in front of the window that is currently active.

See also

• Activated
• Show(String, String, MessageBoxButton)

Show(String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult)

Displays a message box that has a message, title bar caption, button, and icon; and that accepts a default message box result and returns a result.

public:
 static System::Windows::MessageBoxResult Show(System::String ^ messageBoxText, System::String ^ caption, System::Windows::MessageBoxButton button, System::Windows::MessageBoxImage icon, System::Windows::MessageBoxResult defaultResult);

public static System.Windows.MessageBoxResult Show (string messageBoxText, string caption, System.Windows.MessageBoxButton button, System.Windows.MessageBoxImage icon, System.Windows.MessageBoxResult defaultResult);

static member Show : string * string * System.Windows.MessageBoxButton * System.Windows.MessageBoxImage * System.Windows.MessageBoxResult -> System.Windows.MessageBoxResult

Public Shared Function Show (messageBoxText As String, caption As String, button As MessageBoxButton, icon As MessageBoxImage, defaultResult As MessageBoxResult) As MessageBoxResult

Parameters

messageBoxText

String

A String that specifies the text to display.

caption

String

A String that specifies the title bar caption to display.

button

MessageBoxButton

A MessageBoxButton value that specifies which button or buttons to display.

icon

MessageBoxImage

A MessageBoxImage value that specifies the icon to display.

defaultResult

MessageBoxResult

A MessageBoxResult value that specifies the default result of the message box.

Returns

MessageBoxResult

A MessageBoxResult value that specifies which message box button is clicked by the user.

Examples

The following example shows how to use this overload of the Show method.

private void ShowMessageBoxButton_Click(object sender, RoutedEventArgs e)
{
    // Configure message box
    string message = "Hello, MessageBox!";
    string caption = "Caption text";
    MessageBoxButton buttons = MessageBoxButton.OKCancel;
    MessageBoxImage icon = MessageBoxImage.Information;
    MessageBoxResult defaultResult = MessageBoxResult.OK;
    // Show message box
    MessageBoxResult result = MessageBox.Show(message, caption, buttons, icon, defaultResult);
}

Private Sub showMessageBoxButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' Configure message box
    Dim message As String = "Hello, MessageBox!"
    Dim caption As String = "Caption text"
    Dim buttons As MessageBoxButton = MessageBoxButton.OKCancel
    Dim icon As MessageBoxImage = MessageBoxImage.Information
    Dim defaultResult As MessageBoxResult = MessageBoxResult.OK
    ' Show message box
    Dim result As MessageBoxResult = MessageBox.Show(message, caption, buttons, icon, defaultResult)
End Sub

Show(Window, String, String, MessageBoxButton, MessageBoxImage)

Displays a message box in front of the specified window. The message box displays a message, title bar caption, button, and icon; and it also returns a result.

public:
 static System::Windows::MessageBoxResult Show(System::Windows::Window ^ owner, System::String ^ messageBoxText, System::String ^ caption, System::Windows::MessageBoxButton button, System::Windows::MessageBoxImage icon);

public static System.Windows.MessageBoxResult Show (System.Windows.Window owner, string messageBoxText, string caption, System.Windows.MessageBoxButton button, System.Windows.MessageBoxImage icon);

static member Show : System.Windows.Window * string * string * System.Windows.MessageBoxButton * System.Windows.MessageBoxImage -> System.Windows.MessageBoxResult

Public Shared Function Show (owner As Window, messageBoxText As String, caption As String, button As MessageBoxButton, icon As MessageBoxImage) As MessageBoxResult

Parameters

owner

Window

A Window that represents the owner window of the message box.

messageBoxText

String

A String that specifies the text to display.

caption

String

A String that specifies the title bar caption to display.

button

MessageBoxButton

A MessageBoxButton value that specifies which button or buttons to display.

icon

MessageBoxImage

A MessageBoxImage value that specifies the icon to display.

Returns

MessageBoxResult

A MessageBoxResult value that specifies which message box button is clicked by the user.

Remarks

By default, the message box appears in front of the window that is currently active.

See also

• Activated
• Show(String, String, MessageBoxButton, MessageBoxImage)

Show(String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions)

Displays a message box that has a message, title bar caption, button, and icon; and that accepts a default message box result, complies with the specified options, and returns a result.

public:
 static System::Windows::MessageBoxResult Show(System::String ^ messageBoxText, System::String ^ caption, System::Windows::MessageBoxButton button, System::Windows::MessageBoxImage icon, System::Windows::MessageBoxResult defaultResult, System::Windows::MessageBoxOptions options);

public static System.Windows.MessageBoxResult Show (string messageBoxText, string caption, System.Windows.MessageBoxButton button, System.Windows.MessageBoxImage icon, System.Windows.MessageBoxResult defaultResult, System.Windows.MessageBoxOptions options);

static member Show : string * string * System.Windows.MessageBoxButton * System.Windows.MessageBoxImage * System.Windows.MessageBoxResult * System.Windows.MessageBoxOptions -> System.Windows.MessageBoxResult

Public Shared Function Show (messageBoxText As String, caption As String, button As MessageBoxButton, icon As MessageBoxImage, defaultResult As MessageBoxResult, options As MessageBoxOptions) As MessageBoxResult

Parameters

messageBoxText

String

A String that specifies the text to display.

caption

String

A String that specifies the title bar caption to display.

button

MessageBoxButton

A MessageBoxButton value that specifies which button or buttons to display.

icon

MessageBoxImage

A MessageBoxImage value that specifies the icon to display.

defaultResult

MessageBoxResult

A MessageBoxResult value that specifies the default result of the message box.

options

MessageBoxOptions

A MessageBoxOptions value object that specifies the options.

Returns

MessageBoxResult

A MessageBoxResult value that specifies which message box button is clicked by the user.

Examples

The following example shows how to use this overload of the Show method.

private void ShowMessageBoxButton_Click(object sender, RoutedEventArgs e)
{
    // Configure message box
    string message = "Hello, MessageBox!";
    string caption = "Caption text";
    MessageBoxButton buttons = MessageBoxButton.OKCancel;
    MessageBoxImage icon = MessageBoxImage.Information;
    MessageBoxResult defaultResult = MessageBoxResult.OK;
    MessageBoxOptions options = MessageBoxOptions.RtlReading;
    // Show message box
    MessageBoxResult result = MessageBox.Show(message, caption, buttons, icon, defaultResult, options);
}

Private Sub showMessageBoxButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' Configure message box
    Dim message As String = "Hello, MessageBox!"
    Dim caption As String = "Caption text"
    Dim buttons As MessageBoxButton = MessageBoxButton.OKCancel
    Dim icon As MessageBoxImage = MessageBoxImage.Information
    Dim defaultResult As MessageBoxResult = MessageBoxResult.OK
    Dim options As MessageBoxOptions = MessageBoxOptions.RtlReading
    ' Show message box
    Dim result As MessageBoxResult = MessageBox.Show(message, caption, buttons, icon, defaultResult, options)
End Sub

Show(Window, String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult)

Displays a message box in front of the specified window. The message box displays a message, title bar caption, button, and icon; and accepts a default message box result and returns a result.

public:
 static System::Windows::MessageBoxResult Show(System::Windows::Window ^ owner, System::String ^ messageBoxText, System::String ^ caption, System::Windows::MessageBoxButton button, System::Windows::MessageBoxImage icon, System::Windows::MessageBoxResult defaultResult);

public static System.Windows.MessageBoxResult Show (System.Windows.Window owner, string messageBoxText, string caption, System.Windows.MessageBoxButton button, System.Windows.MessageBoxImage icon, System.Windows.MessageBoxResult defaultResult);

static member Show : System.Windows.Window * string * string * System.Windows.MessageBoxButton * System.Windows.MessageBoxImage * System.Windows.MessageBoxResult -> System.Windows.MessageBoxResult

Public Shared Function Show (owner As Window, messageBoxText As String, caption As String, button As MessageBoxButton, icon As MessageBoxImage, defaultResult As MessageBoxResult) As MessageBoxResult

Parameters

owner

Window

A Window that represents the owner window of the message box.

messageBoxText

String

A String that specifies the text to display.

caption

String

A String that specifies the title bar caption to display.

button

MessageBoxButton

A MessageBoxButton value that specifies which button or buttons to display.

icon

MessageBoxImage

A MessageBoxImage value that specifies the icon to display.

defaultResult

MessageBoxResult

A MessageBoxResult value that specifies the default result of the message box.

Returns

MessageBoxResult

A MessageBoxResult value that specifies which message box button is clicked by the user.

Remarks

By default, the message box appears in front of the window that is currently active.

See also

• Activated
• Show(String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult)

Show(Window, String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions)

Displays a message box in front of the specified window. The message box displays a message, title bar caption, button, and icon; and accepts a default message box result, complies with the specified options, and returns a result.

public:
 static System::Windows::MessageBoxResult Show(System::Windows::Window ^ owner, System::String ^ messageBoxText, System::String ^ caption, System::Windows::MessageBoxButton button, System::Windows::MessageBoxImage icon, System::Windows::MessageBoxResult defaultResult, System::Windows::MessageBoxOptions options);

public static System.Windows.MessageBoxResult Show (System.Windows.Window owner, string messageBoxText, string caption, System.Windows.MessageBoxButton button, System.Windows.MessageBoxImage icon, System.Windows.MessageBoxResult defaultResult, System.Windows.MessageBoxOptions options);

static member Show : System.Windows.Window * string * string * System.Windows.MessageBoxButton * System.Windows.MessageBoxImage * System.Windows.MessageBoxResult * System.Windows.MessageBoxOptions -> System.Windows.MessageBoxResult

Public Shared Function Show (owner As Window, messageBoxText As String, caption As String, button As MessageBoxButton, icon As MessageBoxImage, defaultResult As MessageBoxResult, options As MessageBoxOptions) As MessageBoxResult

Parameters

owner

Window

A Window that represents the owner window of the message box.

messageBoxText

String

A String that specifies the text to display.

caption

String

A String that specifies the title bar caption to display.

button

MessageBoxButton

A MessageBoxButton value that specifies which button or buttons to display.

icon

MessageBoxImage

A MessageBoxImage value that specifies the icon to display.

defaultResult

MessageBoxResult

A MessageBoxResult value that specifies the default result of the message box.

options

MessageBoxOptions

A MessageBoxOptions value object that specifies the options.

Returns

MessageBoxResult

A MessageBoxResult value that specifies which message box button is clicked by the user.

Remarks

By default, the message box appears in front of the window that is currently active.

See also

• Activated
• Show(String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions)