MessageBox Classe

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Exibe uma janela de mensagem, também conhecida como uma caixa de diálogo que exibe uma mensagem ao usuário. É uma janela modal, bloqueando outras ações no aplicativo até que o usuário a feche. Um MessageBox pode conter texto, botões e símbolos que informam e instruem o usuário.

public ref class MessageBox

public class MessageBox

type MessageBox = class

Public Class MessageBox

Herança: Object
MessageBox

Exemplos

O exemplo de código a seguir mostra como usar um MessageBox para informar o usuário de uma entrada ausente em um TextBox. Este exemplo requer que o método seja chamado de um formulário existente com um TextBox ServerName nomeado nele.

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

O exemplo de código a seguir mostra como fazer uma pergunta sim ou nenhuma ao usuário e tomar uma decisão com base na resposta.

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

Comentários

Você não pode criar uma nova instância da MessageBox classe. Para exibir uma caixa de mensagem, chame o static método MessageBox.Show. O título, a mensagem, os botões e os ícones exibidos na caixa de mensagem são determinados pelos parâmetros que você passa para esse método.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Show(IWin32Window, String)	Exibe uma caixa de mensagem na frente do objeto especificado e com o texto especificado.
Show(IWin32Window, String, String)	Exibe uma caixa de mensagem na frente do objeto especificado e com o texto e a legenda especificados.
Show(IWin32Window, String, String, MessageBoxButtons)	Exibe uma caixa de mensagem na frente do objeto especificado e com o texto, a legenda e os botões especificados.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon)	Exibe uma caixa de mensagem na frente do objeto especificado e com o texto especificado, legenda, botões e ícone.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Exibe uma caixa de mensagem na frente do objeto especificado e com o texto, legenda, botões, ícone e o botão padrão.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	Exibe uma caixa de mensagem na frente do objeto especificado e com o texto, legenda, botões, ícone, botão padrão e opções especificados.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda, usando o arquivo de Ajuda especificado.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda, usando o arquivo de Ajuda especificado e `HelpNavigator`.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda, usando o arquivo de Ajuda especificado, `HelpNavigator` e o tópico da Ajuda.
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Exibe uma caixa de mensagem com o texto, a legenda, os botões, o ícone, o botão padrão, as opções e o botão de Ajuda especificados, usando o arquivo de Ajuda e a palavra-chave de Ajuda especificados.
Show(String)	Exibe uma caixa de mensagem com o texto especificado.
Show(String, String)	Exibe uma caixa de mensagem com o texto e a legenda especificados.
Show(String, String, MessageBoxButtons)	Exibe uma caixa de mensagem com o texto, a legenda os botões especificados.
Show(String, String, MessageBoxButtons, MessageBoxIcon)	Exibe uma caixa de mensagem com o texto, legenda, botões e ícone especificados.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Exibe uma caixa de mensagem com o texto, a legenda, os botões, o ícone e o botão padrão especificados.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions)	Exibe uma caixa de mensagem com o texto, legenda, botões, ícone, botão padrão e opções especificados.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean)	Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String)	Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda, usando o arquivo de Ajuda especificado.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator)	Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda, usando o arquivo de Ajuda especificado e `HelpNavigator`.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)	Exibe uma caixa de mensagem com o texto especificado, legenda, botões, ícone, botão padrão, opções e botão Ajuda, usando o arquivo de Ajuda especificado, `HelpNavigator` e o tópico da Ajuda.
Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String)	Exibe uma caixa de mensagem com o texto, a legenda, os botões, o ícone, o botão padrão, as opções e o botão de Ajuda especificados, usando o arquivo de Ajuda e a palavra-chave de Ajuda especificados.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a

Confira também

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