This topic has not yet been rated - Rate this topic

MessageBox.Show Method (String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions)

.NET Framework 3.5

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.

Namespace: System.Windows
Assembly: PresentationFramework (in PresentationFramework.dll)

Syntax

C++

JScript

Copy

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

XAML

Copy

You cannot use methods in XAML.

Parameters

messageBoxText: Type: System.String
A String that specifies the text to display.

caption: Type: System.String
A String that specifies the title bar caption to display.

button: Type: System.Windows.MessageBoxButton
A MessageBoxButton value that specifies which button or buttons to display.

icon: Type: System.Windows.MessageBoxImage
A MessageBoxImage value that specifies the icon to display.

defaultResult: Type: System.Windows.MessageBoxResult
A MessageBoxResult value that specifies the default result of the message box.

options: Type: System.Windows.MessageBoxOptions
A MessageBoxOptions value object that specifies the options.

Return Value

Type: System.Windows.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.

Copy

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);
}

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0

Reference

MessageBox Class

MessageBox Members

Show Overload

System.Windows Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ