MessageBox Klasa

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Wyświetla okno komunikatu, znane również jako okno dialogowe, które przedstawia użytkownikowi komunikat. Jest to modalne okno, które blokuje inne akcje w aplikacji, dopóki użytkownik go nie zamknie. Obiekt MessageBox może zawierać tekst, przyciski i symbole, które informują i instruują użytkownika.

public ref class MessageBox

public class MessageBox

type MessageBox = class

Public Class MessageBox

Dziedziczenie

Object

MessageBox

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą obiektu a MessageBox poinformować użytkownika o brakującym wpisie w obiekcie TextBox. W tym przykładzie metoda jest wywoływana z istniejącego formularza o TextBox nazwie 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

Poniższy przykład kodu pokazuje, jak zadać użytkownikowi pytanie "tak" lub "nie" i podjąć decyzję na podstawie odpowiedzi.

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

Uwagi

Nie można utworzyć nowego wystąpienia MessageBox klasy. Aby wyświetlić okno komunikatu, wywołaj metodę static MessageBox.Show. Tytuł, komunikat, przyciski i ikony wyświetlane w oknie komunikatu są określane przez parametry przekazywane do tej metody.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Show(IWin32Window, String)	Wyświetla okno komunikatu przed określonym obiektem i z określonym tekstem.
Show(IWin32Window, String, String)	Wyświetla okno komunikatu przed określonym obiektem oraz z określonym tekstem i podpisem.
Show(IWin32Window, String, String, MessageBoxButtons)	Wyświetla okno komunikatu przed określonym obiektem oraz z określonym tekstem, podpisem i przyciskami.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)	Wyświetla pole komunikatu przed określonym obiektem i z określonym tekstem, podpisem, przyciskami i ikoną.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Wyświetla pole komunikatu przed określonym obiektem i z określonym tekstem, podpisem, przyciskami, ikoną i przyciskiem domyślnym.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	Wyświetla pole komunikatu przed określonym obiektem i z określonym tekstem, podpisem, przyciskami, ikoną, przyciskiem domyślnym i opcjami.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Wyświetla pole komunikatu z określonym tekstem, podpisem, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc przy użyciu określonego pliku Pomocy.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Wyświetla pole komunikatu z określonym tekstem, podpisem, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc przy użyciu określonego pliku Pomocy i HelpNavigator.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Wyświetla pole komunikatu z określonym tekstem, podpisem, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc, przy użyciu określonego pliku Pomocy, HelpNavigatori tematu Pomoc.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Wyświetla pole komunikatu z określonym tekstem, podpisem, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc przy użyciu określonego pliku Pomocy i słowa kluczowego Pomoc.
Show(String)	Wyświetla pole komunikatu z określonym tekstem.
Show(String, String)	Wyświetla pole komunikatu z określonym tekstem i podpisem.
Show(String, String, MessageBoxButtons)	Wyświetla pole komunikatu z określonym tekstem, podpisem i przyciskami.
Show(String, String, MessageBoxButtons, MessageBoxIcon)	Wyświetla okno komunikatu z określonym tekstem, podpisem, przyciskami i ikoną.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Wyświetla okno komunikatu z określonym tekstem, podpisem, przyciskami, ikoną i przyciskiem domyślnym.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	Wyświetla pole komunikatu z określonym tekstem, podpisem, przyciskami, ikoną, przyciskiem domyślnym i opcjami.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)	Wyświetla pole komunikatu z określonym tekstem, podpisem, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Wyświetla pole komunikatu z określonym tekstem, podpisem, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc przy użyciu określonego pliku Pomocy.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Wyświetla pole komunikatu z określonym tekstem, podpisem, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc przy użyciu określonego pliku Pomocy i HelpNavigator.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Wyświetla pole komunikatu z określonym tekstem, podpisem, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc, przy użyciu określonego pliku Pomocy, HelpNavigatori tematu Pomoc.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Wyświetla pole komunikatu z określonym tekstem, podpisem, przyciskami, ikoną, przyciskiem domyślnym, opcjami i przyciskiem Pomoc przy użyciu określonego pliku Pomocy i słowa kluczowego Pomoc.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

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