Article
11/18/2011

MessageBox Class

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Displays a message to the user and optionally prompts for a response.

Inheritance Hierarchy

System.Object
System.Windows.MessageBox

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

Syntax

'Declaration
Public NotInheritable Class MessageBox

public sealed class MessageBox

The MessageBox type exposes the following members.

Methods

	Name	Description
	Equals(Object)	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	Show(String)	Displays a message box that contains the specified text and an OK button.
	Show(Window, String)	Displays a message box that contains the specified text and an OK button that is modal to the window specified by the owner parameter.
	Show(String, String, MessageBoxButton)	Displays a message box that contains the specified text, title bar caption, and response buttons.
	Show(Window, String, String, MessageBoxButton)	Displays a message box that is modal to the window specified by the owner parameter.
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Remarks

The MessageBox class provides a static Show method that you can use to display a message in a simple dialog box. The dialog box is modal and provides an OK button.

An overload of the Show method enables you to specify a title bar caption and an optional Cancel button. If you display a Cancel button, you can use the return value of the method to determine the user's response.

The message box may have a slightly different appearance on different platforms. For example, the message box includes an icon when it is displayed on a Macintosh.

Examples

The following example code demonstrates how to use this class.

Dim result As MessageBoxResult = _
    MessageBox.Show("Would you like to see the simple version?", _
    "MessageBox Example", MessageBoxButton.OKCancel)

If (result = MessageBoxResult.OK) Then
    MessageBox.Show("No caption, one button.")
End If

MessageBoxResult result = 
    MessageBox.Show("Would you like to see the simple version?", 
    "MessageBox Example", MessageBoxButton.OKCancel);

if (result == MessageBoxResult.OK)
{
    MessageBox.Show("No caption, one button.");
}

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Partager via