MessageBox Класс

Определение

Отображает окно сообщения, которое также называется диалоговым окном, которое представляет сообщение пользователю. Это модальное окно, блокирующее другие действия в приложении, пока пользователь не закроет его. Может MessageBox содержать текст, кнопки и символы, которые сообщают и указывают пользователю.

public ref class MessageBox
public class MessageBox
type MessageBox = class
Public Class MessageBox
Наследование
MessageBox

Примеры

В следующем примере кода показано, как использовать MessageBox для информирования пользователя о отсутствующих записях в a TextBox. В этом примере требуется, чтобы метод был вызван из существующей формы с TextBox именем ServerName на нем.

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

В следующем примере кода показано, как задать пользователю вопрос "да" или "нет" и принимать решение на основе ответа.

private:
   void Form1_FormClosing(Object^ sender, FormClosingEventArgs^ e)
   {
      // If the no button was pressed ...
      if ((MessageBox::Show(
         "Are you sure that you would like to close the form?", 
         "Form Closing", MessageBoxButtons::YesNo, 
         MessageBoxIcon::Question) == DialogResult::No))
      {
         // cancel the closure of the form.
         e->Cancel = true;
      }
   }
private void Form1_FormClosing(object sender, FormClosingEventArgs e)
{
    const string message =
        "Are you sure that you would like to close the form?";
    const string caption = "Form Closing";
    var result = MessageBox.Show(message, caption,
                                 MessageBoxButtons.YesNo,
                                 MessageBoxIcon.Question);

    // If the no button was pressed ...
    if (result == DialogResult.No)
    {
        // cancel the closure of the form.
        e.Cancel = true;
    }
}
Private Sub Form1_FormClosing( _
    ByVal sender As System.Object, _
    ByVal e As System.Windows.Forms.FormClosingEventArgs) _
    Handles MyBase.FormClosing

    Dim message As String = _
            "Are you sure that you would like to close the form?"
    Dim caption As String = "Form Closing"
    Dim result = MessageBox.Show(message, caption, _
                                 MessageBoxButtons.YesNo, _
                                 MessageBoxIcon.Question)

    ' If the no button was pressed ...
    If (result = DialogResult.No) Then
        ' cancel the closure of the form.
        e.Cancel = True
    End If
End Sub

Комментарии

Невозможно создать новый экземпляр MessageBox класса. Чтобы отобразить поле сообщения, вызовите static метод MessageBox.Show. Заголовки, кнопки и значки, отображаемые в окне сообщения, определяются параметрами, передаваемыми этому методу.

Методы

Имя Описание
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает Type текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неглубокую копию текущей Object.

(Унаследовано от Object)
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Отображает поле сообщения с указанным текстом, подписью, кнопками, значком, значком, кнопкой по умолчанию, параметрами и кнопкой справки, используя указанный файл HelpNavigatorсправки и раздел справки.

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

Отображает поле сообщения с указанным текстом, подписью, кнопками, значком, кнопкой по умолчанию, параметрами и кнопкой справки, используя указанный файл справки и HelpNavigator.

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

Отображает окно сообщения с указанным текстом, подписью, кнопками, значком, кнопкой по умолчанию, параметрами и кнопкой справки, используя указанный файл справки и ключевое слово справки.

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

Отображает поле сообщения с указанным текстом, подписью, кнопками, значком, кнопкой по умолчанию, параметрами и кнопкой справки с помощью указанного файла справки.

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

Отображает окно сообщения перед указанным объектом и с указанным текстом, подписью, кнопками, значком, кнопкой по умолчанию и параметрами.

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

Отображает окно сообщения перед указанным объектом и с указанным текстом, подписью, кнопками, значком и кнопкой по умолчанию.

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

Отображает окно сообщения перед указанным объектом и с указанным текстом, подписью, кнопками и значком.

Show(IWin32Window, String, String, MessageBoxButtons)

Отображает окно сообщения перед указанным объектом и с указанным текстом, подписью и кнопками.

Show(IWin32Window, String, String)

Отображает поле сообщения перед указанным объектом и с указанным текстом и подписью.

Show(IWin32Window, String)

Отображает поле сообщения перед указанным объектом и указанным текстом.

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

Отображает поле сообщения с указанным текстом, подписью, кнопками, значком, кнопкой по умолчанию, параметрами и кнопкой справки.

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

Отображает поле сообщения с указанным текстом, подписью, кнопками, значком, значком, кнопкой по умолчанию, параметрами и кнопкой справки, используя указанный файл HelpNavigatorсправки и раздел справки.

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

Отображает поле сообщения с указанным текстом, подписью, кнопками, значком, кнопкой по умолчанию, параметрами и кнопкой справки, используя указанный файл справки и HelpNavigator.

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

Отображает окно сообщения с указанным текстом, подписью, кнопками, значком, кнопкой по умолчанию, параметрами и кнопкой справки, используя указанный файл справки и ключевое слово справки.

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

Отображает поле сообщения с указанным текстом, подписью, кнопками, значком, кнопкой по умолчанию, параметрами и кнопкой справки с помощью указанного файла справки.

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

Отображает поле сообщения с указанным текстом, подписью, кнопками, значком, значком, кнопкой по умолчанию и параметрами.

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

Отображает поле сообщения с указанным текстом, подписью, кнопками, значком и кнопкой по умолчанию.

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Отображает поле сообщения с указанным текстом, подписью, кнопками и значком.

Show(String, String, MessageBoxButtons)

Отображает поле сообщения с указанным текстом, подписью и кнопками.

Show(String, String)

Отображает поле сообщения с указанным текстом и подписью.

Show(String)

Отображает поле сообщения с указанным текстом.

ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Применяется к

См. также раздел