MessageBox Klass

Definition

Visar ett meddelandefönster, även kallat en dialogruta, som visar ett meddelande för användaren. Det är ett modalt fönster som blockerar andra åtgärder i programmet tills användaren stänger det. En MessageBox kan innehålla text, knappar och symboler som informerar och instruerar användaren.

public ref class MessageBox
public class MessageBox
type MessageBox = class
Public Class MessageBox
Arv
MessageBox

Exempel

Följande kodexempel visar hur du använder en MessageBox för att informera användaren om en saknad post i en TextBox. Det här exemplet kräver att metoden anropas från ett befintligt formulär med namnet TextBoxServerName på.

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

I följande kodexempel visas hur du ställer en ja- eller nejfråga till användaren och fattar ett beslut baserat på svaret.

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

Kommentarer

Du kan inte skapa en ny instans av MessageBox klassen. Om du vill visa en meddelanderuta anropar du static metoden MessageBox.Show. Rubriken, meddelandet, knapparna och ikonerna som visas i meddelanderutan bestäms av parametrar som du skickar till den här metoden.

Metoder

Name Description
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object)

Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp, alternativ och hjälpknapp med den angivna hjälpfilen HelpNavigatoroch hjälpavsnittet.

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

Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp, alternativ och hjälpknapp med den angivna hjälpfilen och HelpNavigator.

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

Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp, alternativ och hjälpknapp med hjälpknappen angiven hjälpfil och hjälpnyckelord.

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

Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp, alternativ och hjälpknapp med den angivna hjälpfilen.

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

Visar en meddelanderuta framför det angivna objektet och med angiven text, bildtext, knappar, ikon, standardknapp och alternativ.

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

Visar en meddelanderuta framför det angivna objektet och med angiven text, bildtext, knappar, ikon och standardknapp.

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

Visar en meddelanderuta framför det angivna objektet och med angiven text, bildtext, knappar och ikon.

Show(IWin32Window, String, String, MessageBoxButtons)

Visar en meddelanderuta framför det angivna objektet och med angiven text, bildtext och knappar.

Show(IWin32Window, String, String)

Visar en meddelanderuta framför det angivna objektet och med angiven text och bildtext.

Show(IWin32Window, String)

Visar en meddelanderuta framför det angivna objektet och med den angivna texten.

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

Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp, alternativ och hjälpknapp.

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

Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp, alternativ och hjälpknapp med den angivna hjälpfilen HelpNavigatoroch hjälpavsnittet.

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

Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp, alternativ och hjälpknapp med den angivna hjälpfilen och HelpNavigator.

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

Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp, alternativ och hjälpknapp med hjälpknappen angiven hjälpfil och hjälpnyckelord.

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

Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp, alternativ och hjälpknapp med den angivna hjälpfilen.

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

Visar en meddelanderuta med angiven text, bildtext, knappar, ikon, standardknapp och alternativ.

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

Visar en meddelanderuta med angiven text, bildtext, knappar, ikon och standardknapp.

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Visar en meddelanderuta med angiven text, bildtext, knappar och ikon.

Show(String, String, MessageBoxButtons)

Visar en meddelanderuta med angiven text, bildtext och knappar.

Show(String, String)

Visar en meddelanderuta med angiven text och bildtext.

Show(String)

Visar en meddelanderuta med angiven text.

ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)

Gäller för

Se även