MessageBox Classe

Definizione

Visualizza una finestra di messaggio, nota anche come finestra di dialogo, che presenta un messaggio all'utente. Si tratta di una finestra modale, che impedisce altre azioni nell'applicazione fino alla sua chiusura. Un oggetto MessageBox può contenere testo, pulsanti e simboli che forniscono istruzioni e informazioni all'utente.

public ref class MessageBox
public class MessageBox
type MessageBox = class
Public Class MessageBox
Ereditarietà
MessageBox

Esempio

Nell'esempio di codice seguente viene illustrato come usare un MessageBox oggetto per informare l'utente di una voce mancante in un oggetto TextBox. In questo esempio è necessario che il metodo venga chiamato da un modulo esistente con un TextBox nome 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

Nell'esempio di codice seguente viene illustrato come porre all'utente una domanda sì o no e prendere una decisione in base alla risposta.

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

Commenti

Non è possibile creare una nuova istanza della MessageBox classe . Per visualizzare una finestra di messaggio, chiamare il static metodo MessageBox.Show. Il titolo, il messaggio, i pulsanti e le icone visualizzati nella finestra di messaggio sono determinati dai parametri passati a questo metodo.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
Show(IWin32Window, String)

Visualizza una finestra di messaggio davanti all'oggetto indicato e con il testo specificato.

Show(IWin32Window, String, String)

Visualizza una finestra di messaggio davanti all'oggetto specificato, con il testo e la didascalia specificati.

Show(IWin32Window, String, String, MessageBoxButtons)

Visualizza una finestra di messaggio davanti all'oggetto specificato, con il testo, la didascalia e i pulsanti specificati.

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

Visualizza una finestra di messaggio davanti all'oggetto specificato, con il testo, la didascalia, i pulsanti e l'icona specificati.

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

Visualizza una finestra di messaggio davanti all'oggetto specificato, con il testo, la didascalia, i pulsanti, l'icona e il pulsante predefinito specificati.

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

Visualizza una finestra di messaggio davanti all'oggetto specificato, con il testo, la didascalia, i pulsanti l'icona, il pulsante predefinito e le opzioni specificati.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida desiderato.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida desiderato e HelpNavigator.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida, HelpNavigator e l'argomento della Guida desiderati.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida e la parola chiave della Guida desiderati.

Show(String)

Visualizza una finestra di messaggio con il testo specificato.

Show(String, String)

Visualizza una finestra di messaggio con il testo e le didascalie specificati.

Show(String, String, MessageBoxButtons)

Visualizza una finestra di messaggio con il testo, la didascalia e i pulsanti specificati.

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti e l'icona specificati.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona e il pulsante predefinito specificati.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito e le opzioni specificati.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida desiderato.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida desiderato e HelpNavigator.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida, HelpNavigator e l'argomento della Guida desiderati.

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

Visualizza una finestra di messaggio con il testo, la didascalia, i pulsanti, l'icona, il pulsante predefinito, le opzioni e il pulsante ? specificati, usando il file della Guida e la parola chiave della Guida desiderati.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche