MessageBox Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Zeigt ein Meldungsfenster an, das auch als Dialogfeld bezeichnet wird, in dem dem Benutzer eine Nachricht angezeigt wird. Es handelt sich um ein modales Fenster, das andere Aktionen in der Anwendung blockiert, bis der Benutzer sie schließt. A MessageBox kann Text, Schaltflächen und Symbole enthalten, die den Benutzer informieren und anweisen.
public ref class MessageBox
public class MessageBox
type MessageBox = class
Public Class MessageBox
- Vererbung
-
MessageBox
Beispiele
Das folgende Codebeispiel zeigt, wie sie den Benutzer über MessageBox einen fehlenden Eintrag in einem TextBox. Dieses Beispiel erfordert, dass die Methode aus einem vorhandenen Formular mit einem TextBox benannten ServerName aufgerufen wird.
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
Das folgende Codebeispiel zeigt, wie Sie dem Benutzer eine Ja- oder Nein-Frage stellen und basierend auf der Antwort eine Entscheidung treffen.
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
Hinweise
Sie können keine neue Instanz der MessageBox Klasse erstellen. Rufen Sie die static Methode MessageBox.Showauf, um ein Meldungsfeld anzuzeigen. Der Titel, die Nachrichten, Schaltflächen und Symbole, die im Meldungsfeld angezeigt werden, werden durch Parameter bestimmt, die Sie an diese Methode übergeben.
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object) |
Zeigt ein Meldungsfeld mit dem angegebenen Text, der Beschriftung, den Schaltflächen, symbol, der Standardschaltfläche, den Optionen und der Hilfeschaltfläche mithilfe der angegebenen Hilfedatei und |
| Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator) |
Zeigt ein Meldungsfeld mit dem angegebenen Text, der Beschriftung, Schaltflächen, Symbol, Standardschaltfläche, Optionen und Hilfeschaltfläche unter Verwendung der angegebenen Hilfedatei und |
| Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String) |
Zeigt ein Meldungsfeld mit dem angegebenen Text, der Beschriftung, den Schaltflächen, symbol, der Standardschaltfläche, den Optionen und der Hilfeschaltfläche unter Verwendung der angegebenen Hilfedatei und des Hilfeschlüsselworts an. |
| Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String) |
Zeigt ein Meldungsfeld mit dem angegebenen Text, der Beschriftung, den Schaltflächen, dem Symbol, der Standardschaltfläche, den Optionen und der Hilfeschaltfläche mithilfe der angegebenen Hilfedatei an. |
| Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions) |
Zeigt ein Meldungsfeld vor dem angegebenen Objekt und mit dem angegebenen Text, der Beschriftung, Schaltflächen, Symbol, Standardschaltfläche und Optionen an. |
| Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton) |
Zeigt ein Meldungsfeld vor dem angegebenen Objekt und mit dem angegebenen Text, der Beschriftung, den Schaltflächen, dem Symbol und der Standardschaltfläche an. |
| Show(IWin32Window, String, String, MessageBoxButtons, MessageBoxIcon) |
Zeigt ein Meldungsfeld vor dem angegebenen Objekt und mit dem angegebenen Text, der Beschriftung, den Schaltflächen und dem Symbol an. |
| Show(IWin32Window, String, String, MessageBoxButtons) |
Zeigt ein Meldungsfeld vor dem angegebenen Objekt und mit dem angegebenen Text, der Beschriftung und den Schaltflächen an. |
| Show(IWin32Window, String, String) |
Zeigt ein Meldungsfeld vor dem angegebenen Objekt und mit dem angegebenen Text und der angegebenen Beschriftung an. |
| Show(IWin32Window, String) |
Zeigt ein Meldungsfeld vor dem angegebenen Objekt und mit dem angegebenen Text an. |
| Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, Boolean) |
Zeigt ein Meldungsfeld mit dem angegebenen Text, der Beschriftung, den Schaltflächen, dem Symbol, der Standardschaltfläche, den Optionen und der Hilfeschaltfläche an. |
| Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator, Object) |
Zeigt ein Meldungsfeld mit dem angegebenen Text, der Beschriftung, den Schaltflächen, symbol, der Standardschaltfläche, den Optionen und der Hilfeschaltfläche mithilfe der angegebenen Hilfedatei und |
| Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, HelpNavigator) |
Zeigt ein Meldungsfeld mit dem angegebenen Text, der Beschriftung, Schaltflächen, Symbol, Standardschaltfläche, Optionen und Hilfeschaltfläche unter Verwendung der angegebenen Hilfedatei und |
| Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String, String) |
Zeigt ein Meldungsfeld mit dem angegebenen Text, der Beschriftung, den Schaltflächen, symbol, der Standardschaltfläche, den Optionen und der Hilfeschaltfläche unter Verwendung der angegebenen Hilfedatei und des Hilfeschlüsselworts an. |
| Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions, String) |
Zeigt ein Meldungsfeld mit dem angegebenen Text, der Beschriftung, den Schaltflächen, dem Symbol, der Standardschaltfläche, den Optionen und der Hilfeschaltfläche mithilfe der angegebenen Hilfedatei an. |
| Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton, MessageBoxOptions) |
Zeigt ein Meldungsfeld mit dem angegebenen Text, der Beschriftung, den Schaltflächen, dem Symbol, der Standardschaltfläche und den Optionen an. |
| Show(String, String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton) |
Zeigt ein Meldungsfeld mit dem angegebenen Text, der Beschriftung, schaltflächen, dem Symbol und der Standardschaltfläche an. |
| Show(String, String, MessageBoxButtons, MessageBoxIcon) |
Zeigt ein Meldungsfeld mit angegebenem Text, Beschriftung, Schaltflächen und Symbol an. |
| Show(String, String, MessageBoxButtons) |
Zeigt ein Meldungsfeld mit angegebenem Text, Beschriftung und Schaltflächen an. |
| Show(String, String) |
Zeigt ein Meldungsfeld mit angegebenem Text und Beschriftung an. |
| Show(String) |
Zeigt ein Meldungsfeld mit angegebenem Text an. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |