MessageBox.Show-Methode (String, String, MessageBoxButtons)
Aktualisiert: November 2007
Zeigt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung und den angegebenen Schaltflächen an.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
public static DialogResult Show( String text, String caption, MessageBoxButtons buttons )
public static function Show( text : String, caption : String, buttons : MessageBoxButtons ) : DialogResult
Parameter
- text
- Typ: System.String
Der im Meldungsfeld anzuzeigende Text.
- caption
- Typ: System.String
Der in der Titelleiste des Meldungsfelds anzuzeigende Text.
- buttons
- Typ: System.Windows.Forms.MessageBoxButtons
Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.
| Ausnahme | Bedingung |
|---|---|
| InvalidEnumArgumentException | Der angegebene buttons-Parameter ist kein Member von MessageBoxButtons. |
| InvalidOperationException | Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird. Dies wird durch die SystemInformation.UserInteractive-Eigenschaft angegeben. |
Im folgenden Codebeispiel wird veranschaulicht, wie eine MessageBox mit den Optionen angezeigt werden kann, die von dieser Überladung von Show unterstützt werden. Nachdem überprüft wurde, ob eine Zeichenfolgenvariable ServerName leer ist, wird im Beispiel eine MessageBox angezeigt, in der die Benutzer den Vorgang abbrechen können. Wenn der Rückgabewert der Show-Methode bei der Auswertung Yes ergibt, wird das Formular geschlossen, das das MessageBox-Objekt angezeigt hat.
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 void ValidateUserEntry()
{
// Checks the value of the text.
if (serverName.get_Text().get_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;
DialogResult result;
// Displays the MessageBox.
result = MessageBox.Show(this, message, caption, buttons);
if (result.Equals(DialogResult.Yes)) {
// Closes the parent form.
this.Close();
}
}
} //ValidateUserEntry
- UIPermission
für alle sicheren Teilfenster zum Aufrufen dieser Methode. Zugeordnete Enumeration: UIPermissionWindow.SafeSubWindows
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
