MessageBox Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Affiche une fenêtre de message, également appelée boîte de dialogue, qui présente un message à l’utilisateur. Il s’agit d’une fenêtre modale, bloquant d’autres actions dans l’application jusqu’à ce que l’utilisateur le ferme. Un MessageBox peut contenir du texte, des boutons et des symboles qui informent et indiquent à l’utilisateur.

public ref class MessageBox

public class MessageBox

type MessageBox = class

Public Class MessageBox

Héritage

Object

MessageBox

Exemples

L’exemple de code suivant montre comment utiliser un MessageBox pour informer l’utilisateur d’une entrée manquante dans un TextBox. Cet exemple nécessite que la méthode soit appelée à partir d’un formulaire existant avec un TextBoxnom de serveur sur celui-ci.

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

L’exemple de code suivant montre comment poser à l’utilisateur une question oui ou non et prendre une décision en fonction de la réponse.

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

Remarques

Vous ne pouvez pas créer une instance de la MessageBox classe. Pour afficher une boîte de message, appelez la static méthode MessageBox.Show. Le titre, le message, les boutons et les icônes affichés dans la boîte de message sont déterminés par les paramètres que vous passez à cette méthode.

Méthodes

Nom	Description
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Affiche une zone de message avec le texte, la légende, les boutons, les icônes, le bouton par défaut, les options et le bouton Aide, à l’aide du fichier HelpNavigatord’aide spécifié et de la rubrique Aide.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Affiche une zone de message avec le texte, la légende, les boutons, l’icône, le bouton par défaut, les options et le bouton Aide, à l’aide du fichier d’aide spécifié et HelpNavigator.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Affiche une zone de message avec le texte, la légende, les boutons, l’icône, le bouton par défaut, les options et le bouton Aide, à l’aide du fichier d’aide et du mot clé d’aide spécifiés.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Affiche une zone de message avec le texte, la légende, les boutons, l’icône, le bouton par défaut, les options et le bouton Aide, à l’aide du fichier d’aide spécifié.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	Affiche une zone de message devant l’objet spécifié et avec le texte, la légende, les boutons, l’icône, le bouton par défaut et les options spécifiés.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Affiche une zone de message devant l’objet spécifié et avec le texte, la légende, les boutons, l’icône et le bouton par défaut spécifiés.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)	Affiche une zone de message devant l’objet spécifié et avec le texte, la légende, les boutons et l’icône spécifiés.
Show(IWin32Window, String, String, MessageBoxButtons)	Affiche une boîte de message devant l’objet spécifié et avec le texte, la légende et les boutons spécifiés.
Show(IWin32Window, String, String)	Affiche une zone de message devant l’objet spécifié et avec le texte et la légende spécifiés.
Show(IWin32Window, String)	Affiche une zone de message devant l’objet spécifié et avec le texte spécifié.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)	Affiche une zone de message avec le texte, la légende, les boutons, l’icône, le bouton par défaut, les options et le bouton Aide spécifiés.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Affiche une zone de message avec le texte, la légende, les boutons, les icônes, le bouton par défaut, les options et le bouton Aide, à l’aide du fichier HelpNavigatord’aide spécifié et de la rubrique Aide.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Affiche une zone de message avec le texte, la légende, les boutons, l’icône, le bouton par défaut, les options et le bouton Aide, à l’aide du fichier d’aide spécifié et HelpNavigator.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Affiche une zone de message avec le texte, la légende, les boutons, l’icône, le bouton par défaut, les options et le bouton Aide, à l’aide du fichier d’aide et du mot clé d’aide spécifiés.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Affiche une zone de message avec le texte, la légende, les boutons, l’icône, le bouton par défaut, les options et le bouton Aide, à l’aide du fichier d’aide spécifié.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	Affiche une zone de message avec le texte, la légende, les boutons, l’icône, le bouton par défaut et les options spécifiés.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Affiche une zone de message avec le texte, la légende, les boutons, l’icône et le bouton par défaut spécifiés.
Show(String, String, MessageBoxButtons, MessageBoxIcon)	Affiche une zone de message avec le texte, la légende, les boutons et l’icône spécifiés.
Show(String, String, MessageBoxButtons)	Affiche une zone de message avec du texte, une légende et des boutons spécifiés.
Show(String, String)	Affiche une zone de message avec du texte et une légende spécifiés.
Show(String)	Affiche une zone de message avec du texte spécifié.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

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