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, blokujące inne akcje w aplikacji, dopóki użytkownik go nie zamknie. Element 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 użyć elementu , MessageBox aby poinformować użytkownika o brakującym wpisie w obiekcie TextBox. W tym przykładzie metoda jest wywoływana z istniejącego TextBox formularza o 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ć pole komunikatu, wywołaj metodę staticMessageBox.Show. Tytuł, komunikat, przyciski i ikony wyświetlane w polu komunikatu są określane przez parametry przekazywane do tej metody.

Metody

Nazwa	Opis
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()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
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, 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, 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(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)	Wyświetla pole komunikatu przed określonym obiektem oraz z określonym tekstem, podpisem, przyciskami, ikoną, przyciskiem domyślnym i opcjami.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Wyświetla pole komunikatu przed określonym obiektem oraz z określonym tekstem, podpisem, przyciskami, ikoną i przyciskiem domyślnym.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)	Wyświetla pole komunikatu przed określonym obiektem oraz z określonym tekstem, podpisem, przyciskami i ikoną.
Show(IWin32Window, String, String, MessageBoxButtons)	Wyświetla pole komunikatu przed określonym obiektem oraz z określonym tekstem, podpisem i przyciskami.
Show(IWin32Window, String, String)	Wyświetla pole komunikatu przed określonym obiektem oraz z określonym tekstem i podpisem.
Show(IWin32Window, String)	Wyświetla pole komunikatu przed określonym obiektem i określonym tekstem.
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, 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, 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, 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, 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)	Wyświetla pole komunikatu z określonym tekstem, podpisem, przyciskami, ikoną, przyciskiem domyślnym i opcjami.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Wyświetla pole komunikatu z określonym tekstem, podpisem, przyciskami, ikoną i przyciskiem domyślnym.
Show(String, String, MessageBoxButtons, MessageBoxIcon)	Wyświetla pole komunikatu z określonym tekstem, podpisem, przyciskami i ikoną.
Show(String, String, MessageBoxButtons)	Wyświetla pole komunikatu z określonym tekstem, podpisem i przyciskami.
Show(String, String)	Wyświetla pole komunikatu z określonym tekstem i podpisem.
Show(String)	Wyświetla pole komunikatu z określonym tekstem.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

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