MessageBox Classe

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Affiche une fenêtre de message, également appelée une boîte de dialogue qui affiche un message à l’utilisateur. Il s’agit d’une fenêtre modale, bloquant les autres actions dans l’application jusqu’à ce que l’utilisateur la ferme. Une MessageBox peut contenir du texte, des boutons et des symboles donnant des informations et des instructions à 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 élément pour informer l’utilisateur d’une entrée manquante dans un TextBox. Cet exemple exige que la méthode soit appelée à partir d’un formulaire existant avec un TextBox nom 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 demander à 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 nouvelle 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 zone de message sont déterminés par les paramètres que vous transmettez à cette méthode.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Show(IWin32Window, String)	Affiche une boîte de message devant l'objet spécifié et avec le texte spécifié.
Show(IWin32Window, String, String)	Affiche une boîte de message devant l'objet spécifié, et avec le texte et la légende 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, MessageBoxButtons, MessageBoxIcon)	Affiche une boîte 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, MessageBoxIcon, MessageBoxDefaultButton)	Affiche une boîte 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, MessageBoxDefaultButton, MessageBoxOptions)	Affiche une boîte 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, MessageBoxOptions, String)	Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que bouton Aide avec le fichier d'aide spécifié.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que le bouton Aide avec le fichier d'aide et le `HelpNavigator` spécifiés.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que le bouton Aide avec le fichier d'aide, le `HelpNavigator` et la rubrique d'aide spécifiés.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que bouton Aide avec le fichier d'aide spécifié et le mot clé d'aide.
Show(String)	Affiche une boîte de message avec le texte spécifié.
Show(String, String)	Affiche une boîte de message avec le texte et la légende spécifiés.
Show(String, String, MessageBoxButtons)	Affiche une boîte de message avec le texte, la légende et le texte spécifiés.
Show(String, String, MessageBoxButtons, MessageBoxIcon)	Affiche une boîte de message avec le texte, la légende, les boutons et l'icône spécifiés.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Affiche une boîte 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, MessageBoxDefaultButton, MessageBoxOptions)	Affiche une boîte 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, MessageBoxOptions, Boolean)	Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que le bouton Aide.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que bouton Aide avec le fichier d'aide spécifié.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que le bouton Aide avec le fichier d'aide et le `HelpNavigator` spécifiés.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que le bouton Aide avec le fichier d'aide, le `HelpNavigator` et la rubrique d'aide spécifiés.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Affiche une boîte de message avec le texte, la légende, les boutons, l'icône, le bouton par défaut et les options spécifiés, ainsi que bouton Aide avec le fichier d'aide spécifié et le mot clé d'aide.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

S’applique à

Voir aussi

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