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
Public methodSupported by Silverlight for Windows Phone Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodSupported by Silverlight for Windows Phone 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.)
Public methodSupported by Silverlight for Windows Phone GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public methodSupported by Silverlight for Windows Phone GetType Gets the Type of the current instance. (Inherited from Object.)
Protected methodSupported by Silverlight for Windows Phone MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public methodStatic memberSupported by Silverlight for Windows Phone Show(String) Displays a message box that contains the specified text and an OK button.
Public methodStatic member 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.
Public methodStatic memberSupported by Silverlight for Windows Phone Show(String, String, MessageBoxButton) Displays a message box that contains the specified text, title bar caption, and response buttons.
Public methodStatic member Show(Window, String, String, MessageBoxButton) Displays a message box that is modal to the window specified by the owner parameter.
Public methodSupported by Silverlight for Windows Phone 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.

See Also

Reference