MessageBox.Show Methode

Definition

Zeigt ein Meldungsfeld an.Displays a message box.

Überlädt

Show(String)

Zeigt ein Meldungsfeld mit angegebenem Text an.Displays a message box with specified text.

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

Zeigt mithilfe der angegebenen Hilfedatei und des angegebenen Hilfeschlüsselworts ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche Hilfe an.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword.

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

Zeigt mithilfe der angegebenen Hilfedatei, HelpNavigator und des angegebenen Hilfethemas ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche Hilfe an.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic.

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

Zeigt unter Verwendung der angegebenen Hilfedatei ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche Hilfe an.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.

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

Zeigt mithilfe der angegebenen Hilfedatei und HelpNavigator ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche Hilfe an.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator.

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

Zeigt mithilfe der angegebenen Hilfedatei und des angegebenen Hilfeschlüsselworts ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche Hilfe an.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword.

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

Zeigt vor dem angegebenen Objekt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der Standardschaltfläche und Optionen an.Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, default button, and options.

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

Zeigt unter Verwendung der angegebenen Hilfedatei ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche Hilfe an.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.

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

Zeigt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche Hilfe an.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button.

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

Zeigt mithilfe der angegebenen Hilfedatei und HelpNavigator ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche Hilfe an.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator.

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

Zeigt vor dem angegebenen Objekt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol und der Standardschaltfläche an.Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, and default button.

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

Zeigt vor dem angegebenen Objekt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen und dem angegebenen Symbol an.Displays a message box in front of the specified object and with the specified text, caption, buttons, and icon.

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

Zeigt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, dem angegebenen Symbol und der Standardschaltfläche an.Displays a message box with the specified text, caption, buttons, icon, and default button.

Show(IWin32Window, String, String, MessageBoxButtons)

Zeigt vor dem angegebenen Objekt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung und den angegebenen Schaltflächen an.Displays a message box in front of the specified object and with the specified text, caption, and buttons.

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Zeigt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen und dem angegebenen Symbol an.Displays a message box with specified text, caption, buttons, and icon.

Show(IWin32Window, String, String)

Zeigt vor dem angegebenen Objekt ein Meldungsfeld mit dem angegebenen Text und der angegebenen Beschriftung an.Displays a message box in front of the specified object and with the specified text and caption.

Show(String, String, MessageBoxButtons)

Zeigt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung und den angegebenen Schaltflächen an.Displays a message box with specified text, caption, and buttons.

Show(IWin32Window, String)

Zeigt vor dem angegebenen Objekt ein Meldungsfeld mit dem angegebenen Text an.Displays a message box in front of the specified object and with the specified text.

Show(String, String)

Zeigt ein Meldungsfeld mit dem angegebenen Text und der angegebenen Beschriftung an.Displays a message box with specified text and caption.

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

Zeigt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, dem angegebenen Symbol, der Standardschaltfläche und Optionen an.Displays a message box with the specified text, caption, buttons, icon, default button, and options.

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

Zeigt mithilfe der angegebenen Hilfedatei, HelpNavigator und des angegebenen Hilfethemas ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche Hilfe an.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic.

Show(String)

Zeigt ein Meldungsfeld mit angegebenem Text an.Displays a message box with specified text.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text);
public static System.Windows.Forms.DialogResult Show (string text);
static member Show : string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String) As DialogResult

Parameter

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Beispiele

Im folgenden Codebeispiel wird ein einfaches Meldungs Feld angezeigt.The following code example displays a simple message box.

private void DisplayMessageBoxText()
{
         MessageBox.Show("Hello, world.");
}

Private Sub DisplayMessageBoxText()

    MessageBox.Show("Hello, world.")
End Sub

Hinweise

Standardmäßig wird im Meldungs Feld die Schaltfläche OK angezeigt.By default, the message box displays an OK button. Das Meldungs Feld enthält keine Beschriftung im Titel.The message box does not contain a caption in the title.

Sicherheit

UIPermission
für sichere Unterfenster, um diese Eigenschaft festzulegen.for safe subwindows to set this property. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

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

Zeigt mithilfe der angegebenen Hilfedatei und des angegebenen Hilfeschlüsselworts ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche Hilfe an.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.An implementation of IWin32Window that will own the modal dialog box.

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfeld angezeigt werden soll.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfeld angibt.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfeld angibt.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.You may pass in 0 if you wish to use the defaults.

helpFilePath
String

Pfad und Name der Hilfedatei, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche Hilfe klickt.The path and name of the Help file to display when the user clicks the Help button.

keyword
String

Das Hilfeschlüsselwort, das angezeigt wird, wenn der Benutzer auf die Schaltfläche Hilfe klickt.The Help keyword to display when the user clicks the Help button.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- oder --or- icon ist kein Member von MessageBoxIcon.icon is not a member of MessageBoxIcon.

- oder --or- Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Dies wird durch die UserInteractive-Eigenschaft angegeben.This is specified by the UserInteractive property.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.options specified both DefaultDesktopOnly and ServiceNotification.

- oder --or- buttons gab eine ungültige Kombination von MessageBoxButtons an.buttons specified an invalid combination of MessageBoxButtons.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Meldungs Feld angezeigt wird, das dem Hauptfenster übergeordnet ist.The following code example demonstrates how to show a message box parented to the main window. Im Meldungs Feld wird eine Hilfe Schaltfläche angezeigt.The message box displays a Help button. Wenn der Benutzer auf die Schaltfläche "Hilfe Mspaint.chm " klickt, wird die Hilfedatei geöffnet, und mspaint.chm::/paint_brush.htm das durch das-Schlüsselwort identifizierte Thema wird angezeigt.When the user clicks the Help button, the Mspaint.chm Help file is opened and the topic identified by the mspaint.chm::/paint_brush.htm keyword is displayed. Das Beispiel setzt voraus, Mspaint.chm dass die Hilfedatei installiert ist.The example requires that the Mspaint.chm Help file is installed.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
System::Windows::Forms::DialogResult r8 = MessageBox::Show( this, "Message with Help file and keyword.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", "mspaint.chm::/paint_brush.htm" );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r8 = MessageBox.Show (this, "Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");
' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file, 
' and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
' associated topic.
Dim r8 As DialogResult = MessageBox.Show(Me, "Message with Help file and keyword.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, 0, _
                                   "mspaint.chm", _
                                   "mspaint.chm::/paint_brush.htm")

Hinweise

Ein Meldungs Feld ist ein modales Dialogfeld. Dies bedeutet, dass keine Eingabe (Tastatur oder Mausklick) mit Ausnahme von Objekten auf dem modalen Formular auftreten kann.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. Das Programm muss ein modales Formular (in der Regel als Reaktion auf eine Benutzeraktion) ausblenden oder schließen, bevor Eingaben in ein anderes Formular auftreten können.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. Sie können den owner -Parameter verwenden, um ein bestimmtes-Objekt anzugeben, IWin32Window das die-Schnittstelle implementiert, die als Besitzer der obersten Ebene des Dialog Felds fungiert.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level owner.

Wenn der Benutzer auf die Schaltfläche "Hilfe" klickt, wird die helpFilePath im-Parameter angegebene Hilfedatei geöffnet, und das durch keyword den-Parameter identifizierte Hilfe schlüsselwortthema wird angezeigt.When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help keyword topic identified by the keyword parameter is displayed. Das Formular, das das Meldungs Feld besitzt (oder das aktive Formular), HelpRequested empfängt auch das Ereignis.The form that owns the message box (or the active form) also receives the HelpRequested event.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
für den Zugriff auf eine HTML-Hilfedatei über eine HTTP-Anforderung.to access a HTML help file through a HTTP request. Zugehörige Enumeration:ConnectAssociated enumeration: Connect

SecurityPermission
der Zugriff auf eine HTML-Hilfedatei, die von einem HTTP-Server nicht bereitgestellt wirdto access a HTML help file not served from a HTTP server. Zugehörige Enumeration:UnmanagedCodeAssociated enumeration: UnmanagedCode

Siehe auch

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

Zeigt mithilfe der angegebenen Hilfedatei, HelpNavigator und des angegebenen Hilfethemas ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche Hilfe an.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

Parameter

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfeld angezeigt werden soll.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfeld angibt.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfeld angibt.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.You may pass in 0 if you wish to use the defaults.

helpFilePath
String

Pfad und Name der Hilfedatei, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche Hilfe klickt.The path and name of the Help file to display when the user clicks the Help button.

navigator
HelpNavigator

Einer der HelpNavigator-Werte.One of the HelpNavigator values.

param
Object

Die numerische ID des Hilfethemas, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche Hilfe klickt.The numeric ID of the Help topic to display when the user clicks the Help button.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- oder --or- icon ist kein Member von MessageBoxIcon.icon is not a member of MessageBoxIcon.

- oder --or- Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Dies wird durch die UserInteractive-Eigenschaft angegeben.This is specified by the UserInteractive property.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.options specified both DefaultDesktopOnly and ServiceNotification.

- oder --or- buttons gab eine ungültige Kombination von MessageBoxButtons an.buttons specified an invalid combination of MessageBoxButtons.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Meldungs Feld mit einer Schaltfläche "Hilfe" angezeigt wird.The following code example demonstrates how to show a message box with a Help button. Wenn der Benutzer auf die Schaltfläche "Hilfe Mspaint.chm " klickt, wird die Hilfedatei geöffnet, und die Registerkarte "Hilfe ovals Index" und das durch das-Schlüsselwort identifizierte Thema werden angezeigt.When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab and the topic identified by the ovals keyword are displayed. Das Beispiel setzt voraus, Mspaint.chm dass die Hilfedatei installiert ist.The example requires that the Mspaint.chm Help file is installed.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
System::Windows::Forms::DialogResult r5 = MessageBox::Show( "Message with Help file and Help navigator with additional parameter.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::KeywordIndex, "ovals" );
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r5 = MessageBox.Show ("Message with Help file and Help navigator with additional parameter.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.KeywordIndex, "ovals");

' Display a message box. The Help button opens the Mspaint.chm Help file, 
' shows index with the "ovals" keyword selected, and displays the
' associated topic.
Dim r5 As DialogResult = MessageBox.Show("Message with Help file and Help navigator with additional parameter.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.KeywordIndex, "ovals")

Hinweise

Ein Meldungs Feld ist ein modales Dialogfeld. Dies bedeutet, dass keine Eingabe (Tastatur oder Mausklick) mit Ausnahme von Objekten auf dem modalen Formular auftreten kann.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. Das Programm muss ein modales Formular (in der Regel als Reaktion auf eine Benutzeraktion) ausblenden oder schließen, bevor Eingaben in ein anderes Formular auftreten können.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Wenn der Benutzer auf die Schaltfläche "Hilfe" klickt, wird die helpFilePath im-Parameter angegebene Hilfedatei geöffnet, und der navigator durch den-Parameter identifizierte Hilfe Inhalt wird angezeigt.When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. Das Formular, das das Meldungs Feld besitzt (oder das aktive Formular), HelpRequested empfängt auch das Ereignis.The form that owns the message box (or the active form) also receives the HelpRequested event.

Kompilierte Hilfedateien stellen Inhaltsverzeichnis, Index-, Such-und Schlüsselwort Verknüpfungen auf Seiten bereit.Compiled help files provide table of contents, index, search, and keyword links in pages. Folgende Werte navigatorkönnen für verwendet werden: TableOfContents, Find, Indexoder Topic.You can use the following values for navigator: TableOfContents, Find, Index, or Topic.

Sie können verwenden param , um den Topic Befehl weiter zu verfeinern.You can use param to provide further refinement of the Topic command. Wenn der navigator im-Parameter angegebene Wert, TableOfContents Indexoder Findist, sollte dieser Wert lauten null.If the value specified in the navigator parameter is TableOfContents, Index, or Find, this value should be null. Wenn der navigator Parameter auf Topicverweist, sollte dieser Wert auf ein Objekt verweisen, das den numerischen Wert des anzuzeigenden Themas enthält.If the navigator parameter references Topic, this value should reference an object that contains the numeric value of the topic to display.

Der helpFilePath -Parameter kann die Form "c:\path\sample.chm" oder "/Folder/file.htm" aufweisen.The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
für den Zugriff auf eine HTML-Hilfedatei über eine HTTP-Anforderung.to access a HTML help file through a HTTP request. Zugehörige Enumeration:ConnectAssociated enumeration: Connect

SecurityPermission
der Zugriff auf eine HTML-Hilfedatei, die von einem HTTP-Server nicht bereitgestellt wirdto access a HTML help file not served from a HTTP server. Zugehörige Enumeration:UnmanagedCodeAssociated enumeration: UnmanagedCode

Siehe auch

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

Zeigt unter Verwendung der angegebenen Hilfedatei ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche Hilfe an.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.An implementation of IWin32Window that will own the modal dialog box.

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfeld angezeigt werden soll.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfeld angibt.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfeld angibt.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.You may pass in 0 if you wish to use the defaults.

helpFilePath
String

Pfad und Name der Hilfedatei, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche Hilfe klickt.The path and name of the Help file to display when the user clicks the Help button.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- oder --or- icon ist kein Member von MessageBoxIcon.icon is not a member of MessageBoxIcon.

- oder --or- Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Dies wird durch die UserInteractive-Eigenschaft angegeben.This is specified by the UserInteractive property.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.options specified both DefaultDesktopOnly and ServiceNotification.

- oder --or- buttons gab eine ungültige Kombination von MessageBoxButtons an.buttons specified an invalid combination of MessageBoxButtons.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Meldungs Feld angezeigt wird, das dem Hauptformular übergeordnet ist.The following code example demonstrates how to show a message box that parented to the main form. Im Meldungs Feld wird eine Hilfe Schaltfläche angezeigt.The message box displays a Help button. Wenn der Benutzer auf die Schaltfläche "Hilfe Mspaint.chm " klickt, wird die Hilfedatei geöffnet.When the user clicks the Help button, the Mspaint.chm Help file is opened. Das Beispiel setzt voraus, Mspaint.chm dass die Hilfedatei installiert ist.The example requires that the Mspaint.chm Help file is installed.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
System::Windows::Forms::DialogResult r2 = MessageBox::Show( this, "Message with Help file.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm" );
// Display a message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r2 = MessageBox.Show (this, "Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");
' Display a message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file.
Dim r2 As DialogResult = MessageBox.Show(Me, "Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

Hinweise

Ein Meldungs Feld ist ein modales Dialogfeld. Dies bedeutet, dass keine Eingabe (Tastatur oder Mausklick) mit Ausnahme von Objekten auf dem modalen Formular auftreten kann.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. Das Programm muss ein modales Formular (in der Regel als Reaktion auf eine Benutzeraktion) ausblenden oder schließen, bevor Eingaben in ein anderes Formular auftreten können.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. Sie können den owner -Parameter verwenden, um ein bestimmtes-Objekt anzugeben, IWin32Window das die-Schnittstelle implementiert, die als Fenster der obersten Ebene des Dialog Felds und als Besitzer fungiert.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner.

Wenn der Benutzer auf die Schaltfläche "Hilfe" klickt, wird die helpFilePath im-Parameter angegebene Hilfedatei geöffnet.When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened. Das Formular, das das Meldungs Feld besitzt (oder das aktive Formular), HelpRequested empfängt auch das Ereignis.The form that owns the message box (or the active form) also receives the HelpRequested event.

Der helpFilePath -Parameter kann die Form "c:\path\sample.chm" oder "/Folder/file.htm" aufweisen.The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
für den Zugriff auf eine HTML-Hilfedatei über eine HTTP-Anforderung.to access a HTML help file through a HTTP request. Zugehörige Enumeration:ConnectAssociated enumeration: Connect

SecurityPermission
der Zugriff auf eine HTML-Hilfedatei, die von einem HTTP-Server nicht bereitgestellt wirdto access a HTML help file not served from a HTTP server. Zugehörige Enumeration:UnmanagedCodeAssociated enumeration: UnmanagedCode

Siehe auch

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

Zeigt mithilfe der angegebenen Hilfedatei und HelpNavigator ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche Hilfe an.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

Parameter

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfeld angezeigt werden soll.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfeld angibt.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfeld angibt.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.You may pass in 0 if you wish to use the defaults.

helpFilePath
String

Pfad und Name der Hilfedatei, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche Hilfe klickt.The path and name of the Help file to display when the user clicks the Help button.

navigator
HelpNavigator

Einer der HelpNavigator-Werte.One of the HelpNavigator values.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- oder --or- icon ist kein Member von MessageBoxIcon.icon is not a member of MessageBoxIcon.

- oder --or- Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Dies wird durch die UserInteractive-Eigenschaft angegeben.This is specified by the UserInteractive property.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.options specified both DefaultDesktopOnly and ServiceNotification.

- oder --or- buttons gab eine ungültige Kombination von MessageBoxButtons an.buttons specified an invalid combination of MessageBoxButtons.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Meldungs Feld mit einer Schaltfläche "Hilfe" angezeigt wird.The following code example demonstrates how to show a message box with a Help button. Wenn der Benutzer auf die Schaltfläche "Hilfe Mspaint.chm " klickt, wird die Hilfedatei geöffnet, und die Registerkarte "Hilfe Index" wird angezeigt.When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab is displayed. Das Beispiel setzt voraus, Mspaint.chm dass die Hilfedatei installiert ist.The example requires that the Mspaint.chm Help file is installed.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens 
// the Mspaint.chm Help file and shows the Help contents 
// on the Index tab.
System::Windows::Forms::DialogResult r3 = MessageBox::Show( "Message with Help file and Help navigator.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::Index );
// Display a message box. The Help button opens 
// the Mspaint.chm Help file and shows the Help contents 
// on the Index tab.
DialogResult r3 = MessageBox.Show ("Message with Help file and Help navigator.", 
                                   "Help Caption", MessageBoxButtons.OK,
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.Index);

' Display a message box. The Help button opens 
' the Mspaint.chm Help file and shows the Help contents 
' on the Index tab.
Dim r3 As DialogResult = MessageBox.Show("Message with Help file and Help navigator.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.Index)

Hinweise

Ein Meldungs Feld ist ein modales Dialogfeld. Dies bedeutet, dass keine Eingabe (Tastatur oder Mausklick) mit Ausnahme von Objekten auf dem modalen Formular auftreten kann.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. Das Programm muss ein modales Formular (in der Regel als Reaktion auf eine Benutzeraktion) ausblenden oder schließen, bevor Eingaben in ein anderes Formular auftreten können.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Wenn der Benutzer auf die Schaltfläche "Hilfe" klickt, wird die helpFilePath im-Parameter angegebene Hilfedatei geöffnet, und der navigator durch den-Parameter identifizierte Hilfe Inhalt wird angezeigt.When the user clicks the Help button, the help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. Das Formular, das das Meldungs Feld besitzt (oder das aktive Formular), HelpRequested empfängt auch das Ereignis.The form that owns the message box (or the active form) also receives the HelpRequested event.

Kompilierte Hilfedateien stellen Inhaltsverzeichnis, Index-, Such-und Schlüsselwort Verknüpfungen auf Seiten bereit.Compiled Help files provide table of contents, index, search, and keyword links in pages. Folgende Werte navigatorkönnen für verwendet werden: TableOfContents, Find, Indexoder Topic.You can use the following values for navigator: TableOfContents, Find, Index, or Topic.

Der helpFilePath -Parameter kann die Form "c:\path\sample.chm" oder "/Folder/file.htm" aufweisen.The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
für den Zugriff auf eine HTML-Hilfedatei über eine HTTP-Anforderung.to access a HTML help file through a HTTP request. Zugehörige Enumeration:ConnectAssociated enumeration: Connect

SecurityPermission
der Zugriff auf eine HTML-Hilfedatei, die von einem HTTP-Server nicht bereitgestellt wirdto access a HTML help file not served from a HTTP server. Zugehörige Enumeration:UnmanagedCodeAssociated enumeration: UnmanagedCode

Siehe auch

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

Zeigt mithilfe der angegebenen Hilfedatei und des angegebenen Hilfeschlüsselworts ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche Hilfe an.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and Help keyword.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::String ^ keyword);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, string keyword);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, keyword As String) As DialogResult

Parameter

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfeld angezeigt werden soll.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfeld angibt.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfeld angibt.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.You may pass in 0 if you wish to use the defaults.

helpFilePath
String

Pfad und Name der Hilfedatei, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche Hilfe klickt.The path and name of the Help file to display when the user clicks the Help button.

keyword
String

Das Hilfeschlüsselwort, das angezeigt wird, wenn der Benutzer auf die Schaltfläche Hilfe klickt.The Help keyword to display when the user clicks the Help button.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- oder --or- icon ist kein Member von MessageBoxIcon.icon is not a member of MessageBoxIcon.

- oder --or- Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Dies wird durch die UserInteractive-Eigenschaft angegeben.This is specified by the UserInteractive property.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.options specified both DefaultDesktopOnly and ServiceNotification.

- oder --or- buttons gab eine ungültige Kombination von MessageBoxButtons an.buttons specified an invalid combination of MessageBoxButtons.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Meldungs Feld mit einer Schaltfläche "Hilfe" angezeigt wird.The following code example demonstrates how to show a message box with a Help button. Wenn der Benutzer auf die Schaltfläche "Hilfe Mspaint.chm " klickt, wird die Hilfedatei geöffnet, und mspaint.chm::/paint_brush.htm das durch das-Schlüsselwort identifizierte Thema wird angezeigt.When the user clicks the Help button, the Mspaint.chm Help file is opened and the topic identified by the mspaint.chm::/paint_brush.htm keyword is displayed. Das Beispiel setzt voraus, Mspaint.chm dass die Hilfedatei installiert ist.The example requires that the Mspaint.chm Help file is installed.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
System::Windows::Forms::DialogResult r7 = MessageBox::Show( "Message with Help file and keyword.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", "mspaint.chm::/paint_brush.htm" );
// Display a message box. The Help button opens the Mspaint.chm Help file, 
// and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
// associated topic.
DialogResult r7 = MessageBox.Show ("Message with Help file and keyword.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 0, 
                                   "mspaint.chm", 
                                   "mspaint.chm::/paint_brush.htm");
' Display a message box. The Help button opens the Mspaint.chm Help file, 
' and the "mspaint.chm::/paint_brush.htm" Help keyword shows the 
' associated topic.
Dim r7 As DialogResult = MessageBox.Show("Message with Help file and keyword.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, 0, _
                                   "mspaint.chm", _
                                   "mspaint.chm::/paint_brush.htm")

Hinweise

Ein Meldungs Feld ist ein modales Dialogfeld. Dies bedeutet, dass keine Eingabe (Tastatur oder Mausklick) mit Ausnahme von Objekten auf dem modalen Formular auftreten kann.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. Das Programm muss ein modales Formular (in der Regel als Reaktion auf eine Benutzeraktion) ausblenden oder schließen, bevor Eingaben in ein anderes Formular auftreten können.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Wenn der Benutzer auf die Schaltfläche "Hilfe" klickt, wird die helpFilePath im-Parameter angegebene Hilfedatei geöffnet, und das durch keyword den-Parameter identifizierte Hilfe schlüsselwortthema wird angezeigt.When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help keyword topic identified by the keyword parameter is displayed. Das Formular, das das Meldungs Feld besitzt (oder das aktive Formular), HelpRequested empfängt auch das Ereignis.The form that owns the message box (or the active form) also receives the HelpRequested event.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
für den Zugriff auf eine HTML-Hilfedatei über eine HTTP-Anforderung.to access a HTML help file through a HTTP request. Zugehörige Enumeration:ConnectAssociated enumeration: Connect

SecurityPermission
der Zugriff auf eine HTML-Hilfedatei, die von einem HTTP-Server nicht bereitgestellt wirdto access a HTML help file not served from a HTTP server. Zugehörige Enumeration:UnmanagedCodeAssociated enumeration: UnmanagedCode

Siehe auch

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

Zeigt vor dem angegebenen Objekt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der Standardschaltfläche und Optionen an.Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, default button, and options.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.An implementation of IWin32Window that will own the modal dialog box.

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfeld angezeigt werden soll.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfeld angibt.One of the MessageBoxDefaultButton values the specifies the default button for the message box.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfeld angibt.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.You may pass in 0 if you wish to use the defaults.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- oder --or- icon ist kein Member von MessageBoxIcon.icon is not a member of MessageBoxIcon.

- oder --or- defaultButton ist kein Member von MessageBoxDefaultButton.defaultButton is not a member of MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Dies wird durch die UserInteractive-Eigenschaft angegeben.This is specified by the UserInteractive property.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.options specified both DefaultDesktopOnly and ServiceNotification.

- oder --or- In options wurde DefaultDesktopOnly oder ServiceNotification angegeben, und es war ein Wert im owner-Parameter angegeben.options specified DefaultDesktopOnly or ServiceNotification and specified a value in the owner parameter. Diese beiden Optionen sollten nur verwendet werden, wenn Sie die Version dieser Methode aufrufen, die ohne den owner-Parameter auskommt.These two options should be used only if you invoke the version of this method that does not take an owner parameter.

- oder --or- buttons gab eine ungültige Kombination von MessageBoxButtons an.buttons specified an invalid combination of MessageBoxButtons.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein MessageBox mit den Optionen angezeigt wird, die von Showdieser Überladung unterstützt werden.The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. Nachdem Sie überprüft haben, dass eine ServerNameZeichen folgen Variable,, leer ist, MessageBoxwird im Beispiel ein angezeigt, das dem Benutzer die Möglichkeit bietet, den Vorgang abzubrechen.After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. Wenn der Show Rückgabewert der Methode als ausgewertet Yeswird, wird das Formular, MessageBox in dem angezeigt wird, geschlossen.If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

private:
   void validateUserEntry2()
   {
      // 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, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // 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;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();

        }

    }

}

Private Sub ValidateUserEntry2()


    ' 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 = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' 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

Hinweise

Sie können den owner -Parameter verwenden, um ein bestimmtes-Objekt anzugeben, IWin32Window das die-Schnittstelle implementiert, die als Fenster der obersten Ebene des Dialog Felds und als Besitzer fungiert.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. Ein Meldungs Feld ist ein modales Dialogfeld. Dies bedeutet, dass keine Eingabe (Tastatur oder Mausklick) mit Ausnahme von Objekten auf dem modalen Formular auftreten kann.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. Das Programm muss ein modales Formular (in der Regel als Reaktion auf eine Benutzeraktion) ausblenden oder schließen, bevor Eingaben in ein anderes Formular auftreten können.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Es können maximal drei Schaltflächen im Meldungs Feld angezeigt werden.You can have a maximum of three buttons on the message box.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

Siehe auch

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

Zeigt unter Verwendung der angegebenen Hilfedatei ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche Hilfe an.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String) As DialogResult

Parameter

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfeld angezeigt werden soll.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfeld angibt.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfeld angibt.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.You may pass in 0 if you wish to use the defaults.

helpFilePath
String

Pfad und Name der Hilfedatei, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche Hilfe klickt.The path and name of the Help file to display when the user clicks the Help button.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- oder --or- icon ist kein Member von MessageBoxIcon.icon is not a member of MessageBoxIcon.

- oder --or- Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Dies wird durch die UserInteractive-Eigenschaft angegeben.This is specified by the UserInteractive property.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.options specified both DefaultDesktopOnly and ServiceNotification.

- oder --or- buttons gab eine ungültige Kombination von MessageBoxButtons an.buttons specified an invalid combination of MessageBoxButtons.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Meldungs Feld mit einer Schaltfläche "Hilfe" angezeigt wird.The following code example demonstrates how to show a message box with a Help button. Wenn der Benutzer auf die Schaltfläche "Hilfe Mspaint.chm " klickt, wird die Hilfedatei geöffnet.When the user clicks the Help button, the Mspaint.chm Help file is opened. Das Beispiel setzt voraus, Mspaint.chm dass die Hilfedatei installiert ist.The example requires that the Mspaint.chm Help file is installed.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box with a help button. 
// The Help button opens the Mspaint.chm Help file.
System::Windows::Forms::DialogResult r1 = MessageBox::Show( "Message with Help file.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm" );
// Display a message box with a help button. 
// The Help button opens the Mspaint.chm Help file.
DialogResult r1 = MessageBox.Show ("Message with Help file.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, 
                                   "mspaint.chm");
' Display a message box with a help button. 
' The Help button opens the Mspaint.chm Help file.
Dim r1 As DialogResult = MessageBox.Show("Message with Help file.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, _
                                   "mspaint.chm")

Hinweise

Ein Meldungs Feld ist ein modales Dialogfeld. Dies bedeutet, dass keine Eingabe (Tastatur oder Mausklick) mit Ausnahme von Objekten auf dem modalen Formular auftreten kann.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. Das Programm muss ein modales Formular (in der Regel als Reaktion auf eine Benutzeraktion) ausblenden oder schließen, bevor Eingaben in ein anderes Formular auftreten können.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Wenn der Benutzer auf die Schaltfläche "Hilfe" klickt, wird helpFilePath die im-Parameter angegebene Hilfedatei geöffnet.When the user clicks Help button, the Help file specified in the helpFilePath parameter is opened. Das Formular, das das Meldungs Feld besitzt (oder das aktive Formular), HelpRequested empfängt auch das Ereignis.The form that owns the message box (or the active form) also receives the HelpRequested event.

Der helpFilePath -Parameter kann die Form "c:\path\sample.chm" oder "/Folder/file.htm" aufweisen.The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
für den Zugriff auf eine HTML-Hilfedatei über eine HTTP-Anforderung.to access a HTML help file through a HTTP request. Zugehörige Enumeration:ConnectAssociated enumeration: Connect

SecurityPermission
der Zugriff auf eine HTML-Hilfedatei, die von einem HTTP-Server nicht bereitgestellt wirdto access a HTML help file not served from a HTTP server. Zugehörige Enumeration:UnmanagedCodeAssociated enumeration: UnmanagedCode

Siehe auch

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

Zeigt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche Hilfe an.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, bool displayHelpButton);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, bool displayHelpButton);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * bool -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, displayHelpButton As Boolean) As DialogResult

Parameter

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfeld angezeigt werden soll.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfeld angibt.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfeld angibt.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.You may pass in 0 if you wish to use the defaults.

displayHelpButton
Boolean

true, um die Schaltfläche Hilfe anzuzeigen, andernfalls false.true to show the Help button; otherwise, false. Die Standardeinstellung ist false.The default is false.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- oder --or- icon ist kein Member von MessageBoxIcon.icon is not a member of MessageBoxIcon.

- oder --or- Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Dies wird durch die UserInteractive-Eigenschaft angegeben.This is specified by the UserInteractive property.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.options specified both DefaultDesktopOnly and ServiceNotification.

- oder --or- buttons gab eine ungültige Kombination von MessageBoxButtons an.buttons specified an invalid combination of MessageBoxButtons.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Meldungs Feld mit der Schaltfläche Hilfe angezeigt Control.HelpRequested wird, wie das-Ereignis behandelt wird und wie ein benutzerdefiniertes Hilfefenster als Reaktion auf das-Ereignis angezeigt wird.The following code example demonstrates how to show a message box with a Help button, handle the Control.HelpRequested event, and show a custom help window in response to the event.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
System::Windows::Forms::DialogResult AlertMessageWithCustomHelpWindow()
{
   
   // Handle the HelpRequested event for the following message.
   this->HelpRequested += gcnew System::Windows::Forms::HelpEventHandler( this, &Form1::Form1_HelpRequested );
   this->Tag = "Message with Help button.";
   
   // Show a message box with OK and Help buttons.
   System::Windows::Forms::DialogResult r = MessageBox::Show( "Message with Help button.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, true );
   
   // Remove the HelpRequested event handler to keep the event
   // from being handled for other message boxes.
   this->HelpRequested -= gcnew System::Windows::Forms::HelpEventHandler( this, &Form1::Form1_HelpRequested );
   
   // Return the dialog box result.
   return r;
}

void Form1_HelpRequested( System::Object^ sender, System::Windows::Forms::HelpEventArgs^ hlpevent )
{
   
   // Create a custom Help window in response to the HelpRequested event.
   Form^ helpForm = gcnew Form;
   
   // Set up the form position, size, and title caption.
   helpForm->StartPosition = FormStartPosition::Manual;
   helpForm->Size = System::Drawing::Size( 200, 400 );
   helpForm->DesktopLocation = Point(this->DesktopBounds.X + this->Size.Width,this->DesktopBounds.Top);
   helpForm->Text = "Help Form";
   
   // Create a label to contain the Help text.
   Label^ helpLabel = gcnew Label;
   
   // Add the label to the form and set its text.
   helpForm->Controls->Add( helpLabel );
   helpLabel->Dock = DockStyle::Fill;
   
   // Use the sender parameter to identify the context of the Help request.
   // The parameter must be cast to the Control type to get the Tag property.
   Control^ senderControl = dynamic_cast<Control^>(sender);
   helpLabel->Text = String::Format( "Help information shown in response to user action on the '{0}' message.", dynamic_cast<String^>(senderControl->Tag) );
   
   // Set the Help form to be owned by the main form. This helps
   // to ensure that the Help form is disposed of.
   this->AddOwnedForm( helpForm );
   
   // Show the custom Help window.
   helpForm->Show();
   
   // Indicate that the HelpRequested event is handled.
   hlpevent->Handled = true;
}
// Display a message box with a Help button. Show a custom Help window
// by handling the HelpRequested event.
private DialogResult AlertMessageWithCustomHelpWindow ()
{
    // Handle the HelpRequested event for the following message.
    this.HelpRequested += new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

    this.Tag = "Message with Help button.";

    // Show a message box with OK and Help buttons.
    DialogResult r = MessageBox.Show ("Message with Help button.", 
                                      "Help Caption", MessageBoxButtons.OK, 
                                      MessageBoxIcon.Question, 
                                      MessageBoxDefaultButton.Button1, 
                                      0, true);

    // Remove the HelpRequested event handler to keep the event
    // from being handled for other message boxes.
    this.HelpRequested -= new System.Windows.Forms.HelpEventHandler (this.Form1_HelpRequested);

    // Return the dialog box result.
    return r;
}

private void Form1_HelpRequested (System.Object sender, System.Windows.Forms.HelpEventArgs hlpevent)
{
    // Create a custom Help window in response to the HelpRequested event.
    Form helpForm = new Form ();

    // Set up the form position, size, and title caption.
    helpForm.StartPosition = FormStartPosition.Manual;
    helpForm.Size = new Size (200, 400);
    helpForm.DesktopLocation = new Point (this.DesktopBounds.X + 
                                          this.Size.Width, 
                                          this.DesktopBounds.Top);
    helpForm.Text = "Help Form";

    // Create a label to contain the Help text.
    Label helpLabel = new Label ();

    // Add the label to the form and set its text.
    helpForm.Controls.Add (helpLabel);
    helpLabel.Dock = DockStyle.Fill;

    // Use the sender parameter to identify the context of the Help request.
    // The parameter must be cast to the Control type to get the Tag property.
    Control senderControl = sender as Control;

    helpLabel.Text = "Help information shown in response to user action on the '" + 
                      (string)senderControl.Tag + "' message.";

    // Set the Help form to be owned by the main form. This helps
    // to ensure that the Help form is disposed of.
    this.AddOwnedForm (helpForm);

    // Show the custom Help window.
    helpForm.Show ();

    // Indicate that the HelpRequested event is handled.
    hlpevent.Handled = true;
}
' Display a message box with a Help button. Show a custom Help window
' by handling the HelpRequested event.
Private Function AlertMessageWithCustomHelpWindow() As DialogResult

    ' Handle the HelpRequested event for the following message.
    AddHandler Me.HelpRequested, AddressOf Me.Form1_HelpRequested

    Me.Tag = "Message with Help button."

    ' Show a message box with OK and Help buttons.
    Dim r As DialogResult = MessageBox.Show("Message with Help button.", _
                                          "Help Caption", MessageBoxButtons.OK, _
                                          MessageBoxIcon.Question, _
                                          MessageBoxDefaultButton.Button1, _
                                          0, True)

    ' Remove the HelpRequested event handler to keep the event
    ' from being handled for other message boxes.
    RemoveHandler Me.HelpRequested, AddressOf Me.Form1_HelpRequested

    ' Return the dialog box result.
    Return r
End Function

Private Sub Form1_HelpRequested(ByVal sender As System.Object, ByVal hlpevent As System.Windows.Forms.HelpEventArgs)

    ' Create a custom Help window in response to the HelpRequested event.
    Dim helpForm As Form = New Form

    ' Set up the form position, size, and title caption.
    With helpForm
        .StartPosition = FormStartPosition.Manual
        .Size = New Size(200, 400)
        .DesktopLocation = New Point(Me.DesktopBounds.X + _
                                     Me.Size.Width, Me.DesktopBounds.Top)
        .Text = "Help Form"
    End With

    ' Create a label to contain the Help text.
    Dim helpLabel As Label = New Label

    ' Add the label to the form and set its text.
    helpForm.Controls.Add(helpLabel)
    helpLabel.Dock = DockStyle.Fill

    ' Use the sender parameter to identify the context of the Help request.
    ' The parameter must be cast to the Control type to get the Tag property.
    Dim senderControl As Control = CType(sender, Control)

    helpLabel.Text = "Help information shown in response to user action on the '" & _
                      CStr(senderControl.Tag) & "' message."

    ' Set the Help form to be owned by the main form. This helps
    ' to ensure that the Help form is disposed of.
    Me.AddOwnedForm(helpForm)

    ' Show the custom Help window.
    helpForm.Show()

    ' Indicate that the HelpRequested event is handled.
    hlpevent.Handled = True
End Sub

Hinweise

Ein Meldungs Feld ist ein modales Dialogfeld. Dies bedeutet, dass keine Eingabe (Tastatur oder Mausklick) mit Ausnahme von Objekten auf dem modalen Formular auftreten kann.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. Das Programm muss ein modales Formular (in der Regel als Reaktion auf eine Benutzeraktion) ausblenden oder schließen, bevor Eingaben in ein anderes Formular auftreten können.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Wenn der Benutzer auf die Schaltfläche "Hilfe" klickt, empfängt das Formular, das das Meldungs Feld (oder HelpRequested das aktive Formular) besitzt, das Ereignis.When the user clicks the Help button, the form that owns the message box (or the active form) receives the HelpRequested event. Behandeln Sie HelpRequested das-Ereignis, um benutzerdefinierte Hilfe Aktionen auszuführen.Handle the HelpRequested event to perform custom Help actions.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

Siehe auch

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

Zeigt mithilfe der angegebenen Hilfedatei und HelpNavigator ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche Hilfe an.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file and HelpNavigator.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.An implementation of IWin32Window that will own the modal dialog box.

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfeld angezeigt werden soll.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfeld angibt.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfeld angibt.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.You may pass in 0 if you wish to use the defaults.

helpFilePath
String

Pfad und Name der Hilfedatei, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche Hilfe klickt.The path and name of the Help file to display when the user clicks the Help button.

navigator
HelpNavigator

Einer der HelpNavigator-Werte.One of the HelpNavigator values.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- oder --or- icon ist kein Member von MessageBoxIcon.icon is not a member of MessageBoxIcon.

- oder --or- Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Dies wird durch die UserInteractive-Eigenschaft angegeben.This is specified by the UserInteractive property.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.options specified both DefaultDesktopOnly and ServiceNotification.

- oder --or- buttons gab eine ungültige Kombination von MessageBoxButtons an.buttons specified an invalid combination of MessageBoxButtons.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Meldungs Feld angezeigt wird, das dem Hauptfenster übergeordnet ist.The following code example demonstrates how to show a message box parented to the main window. Im Meldungs Feld wird eine Hilfe Schaltfläche angezeigt.The message box displays a Help button. Wenn der Benutzer auf die Schaltfläche "Hilfe Mspaint.chm " klickt, wird die Hilfedatei geöffnet, und die Registerkarte "Hilfe Index" wird angezeigt.When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab is displayed. Das Beispiel setzt voraus, Mspaint.chm dass die Hilfedatei installiert ist.The example requires that the Mspaint.chm Help file is installed.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file
// and shows the Help contents on the Index tab.
System::Windows::Forms::DialogResult r4 = MessageBox::Show( this, "Message with Help file and Help navigator.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::Index );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file
// and shows the Help contents on the Index tab.
DialogResult r4 = MessageBox.Show (this, 
                                   "Message with Help file and Help navigator.", 
                                   "Help Caption", MessageBoxButtons.OK,
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.Index);

' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file
' and shows the Help contents on the Index tab.
Dim r4 As DialogResult = MessageBox.Show(Me, _
                                      "Message with Help file and Help navigator.", _
                                      "Help Caption", MessageBoxButtons.OK, _
                                      MessageBoxIcon.Question, _
                                      MessageBoxDefaultButton.Button1, _
                                      0, "mspaint.chm", _
                                      HelpNavigator.Index)

Hinweise

Ein Meldungs Feld ist ein modales Dialogfeld. Dies bedeutet, dass keine Eingabe (Tastatur oder Mausklick) mit Ausnahme von Objekten auf dem modalen Formular auftreten kann.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. Das Programm muss ein modales Formular (in der Regel als Reaktion auf eine Benutzeraktion) ausblenden oder schließen, bevor Eingaben in ein anderes Formular auftreten können.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. Sie können den owner -Parameter verwenden, um ein bestimmtes-Objekt anzugeben, IWin32Window das die-Schnittstelle implementiert, die als Fenster der obersten Ebene des Dialog Felds und als Besitzer fungiert.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner.

Wenn der Benutzer auf die Schaltfläche "Hilfe" klickt, wird die helpFilePath im-Parameter angegebene Hilfedatei geöffnet, und der navigator durch den-Parameter identifizierte Hilfe Inhalt wird angezeigt.When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. Das Formular, das das Meldungs Feld besitzt (oder das aktive Formular), HelpRequested empfängt auch das Ereignis.The form that owns the message box (or the active form) also receives the HelpRequested event.

Kompilierte Hilfedateien stellen Inhaltsverzeichnis, Index-, Such-und Schlüsselwort Verknüpfungen auf Seiten bereit.Compiled Help files provide table of contents, index, search, and keyword links in pages. Folgende Werte navigatorkönnen für verwendet werden: TableOfContents, Find, Indexoder Topic.You can use the following values for navigator: TableOfContents, Find, Index, or Topic.

Der helpFilePath -Parameter kann die Form "c:\path\sample.chm" oder "/Folder/file.htm" aufweisen.The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
für den Zugriff auf eine HTML-Hilfedatei über eine HTTP-Anforderung.to access a HTML help file through a HTTP request. Zugehörige Enumeration:ConnectAssociated enumeration: Connect

SecurityPermission
der Zugriff auf eine HTML-Hilfedatei, die von einem HTTP-Server nicht bereitgestellt wirdto access a HTML help file not served from a HTTP server. Zugehörige Enumeration:UnmanagedCodeAssociated enumeration: UnmanagedCode

Siehe auch

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

Zeigt vor dem angegebenen Objekt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol und der Standardschaltfläche an.Displays a message box in front of the specified object and with the specified text, caption, buttons, icon, and default button.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.An implementation of IWin32Window that will own the modal dialog box.

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfeld angezeigt werden soll.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfeld angibt.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- oder --or- icon ist kein Member von MessageBoxIcon.icon is not a member of MessageBoxIcon.

- oder --or- defaultButton ist kein Member von MessageBoxDefaultButton.defaultButton is not a member of MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Dies wird durch die UserInteractive-Eigenschaft angegeben.This is specified by the UserInteractive property.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein MessageBox mit den Optionen angezeigt wird, die von Showdieser Überladung unterstützt werden.The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. Nachdem Sie überprüft haben, dass eine ServerNameZeichen folgen Variable,, leer ist, MessageBoxwird im Beispiel ein angezeigt, das dem Benutzer die Möglichkeit bietet, den Vorgang abzubrechen.After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. Wenn der Show Rückgabewert der Methode als ausgewertet Yeswird, wird das Formular, MessageBox in dem angezeigt wird, geschlossen.If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

private:
   void validateUserEntry2()
   {
      // 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, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // 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;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();

        }

    }

}

Private Sub ValidateUserEntry2()


    ' 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 = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' 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

Hinweise

Sie können den owner -Parameter verwenden, um ein bestimmtes-Objekt anzugeben, IWin32Window das die-Schnittstelle implementiert, die als Fenster der obersten Ebene des Dialog Felds und als Besitzer fungiert.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. Ein Meldungs Feld ist ein modales Dialogfeld. Dies bedeutet, dass keine Eingabe (Tastatur oder Mausklick) mit Ausnahme von Objekten auf dem modalen Formular auftreten kann.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. Das Programm muss ein modales Formular (in der Regel als Reaktion auf eine Benutzeraktion) ausblenden oder schließen, bevor Eingaben in ein anderes Formular auftreten können.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Es können maximal drei Schaltflächen im Meldungs Feld angezeigt werden.You can have a maximum of three buttons on the message box.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

Siehe auch

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

Zeigt vor dem angegebenen Objekt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen und dem angegebenen Symbol an.Displays a message box in front of the specified object and with the specified text, caption, buttons, and icon.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.An implementation of IWin32Window that will own the modal dialog box.

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfeld angezeigt werden soll.One of the MessageBoxIcon values that specifies which icon to display in the message box.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- oder --or- icon ist kein Member von MessageBoxIcon.icon is not a member of MessageBoxIcon.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Dies wird durch die UserInteractive-Eigenschaft angegeben.This is specified by the UserInteractive property.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein MessageBox mit den Optionen angezeigt wird, die von Showdieser Überladung unterstützt werden.The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. Nachdem Sie überprüft haben, dass eine ServerNameZeichen folgen Variable,, leer ist, MessageBoxwird im Beispiel ein angezeigt, das dem Benutzer die Möglichkeit bietet, den Vorgang abzubrechen.After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. Wenn der Show Rückgabewert der Methode als ausgewertet Yeswird, wird das Formular, MessageBox in dem angezeigt wird, geschlossen.If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

private:
   void validateUserEntry4()
   {
      // 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, MessageBoxIcon::Question );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry4()
{

    // 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;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();

        }

    }

}
Private Sub ValidateUserEntry4()

    ' 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 = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, MessageBoxIcon.Question)

        ' 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

Hinweise

Sie können den owner -Parameter verwenden, um ein bestimmtes-Objekt anzugeben, IWin32Window das die-Schnittstelle implementiert, die als Fenster der obersten Ebene des Dialog Felds und als Besitzer fungiert.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. Ein Meldungs Feld ist ein modales Dialogfeld. Dies bedeutet, dass keine Eingabe (Tastatur oder Mausklick) mit Ausnahme von Objekten auf dem modalen Formular auftreten kann.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. Das Programm muss ein modales Formular (in der Regel als Reaktion auf eine Benutzeraktion) ausblenden oder schließen, bevor Eingaben in ein anderes Formular auftreten können.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Es können maximal drei Schaltflächen im Meldungs Feld angezeigt werden.You can have a maximum of three buttons on the message box.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

Siehe auch

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

Zeigt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, dem angegebenen Symbol und der Standardschaltfläche an.Displays a message box with the specified text, caption, buttons, icon, and default button.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult

Parameter

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfeld angezeigt werden soll.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfeld angibt.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- oder --or- icon ist kein Member von MessageBoxIcon.icon is not a member of MessageBoxIcon.

- oder --or- defaultButton ist kein Member von MessageBoxDefaultButton.defaultButton is not a member of MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Dies wird durch die UserInteractive-Eigenschaft angegeben.This is specified by the UserInteractive property.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein MessageBox mit den Optionen angezeigt wird, die von Showdieser Überladung unterstützt werden.The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. Nachdem Sie überprüft haben, dass eine ServerNameZeichen folgen Variable,, leer ist, MessageBox zeigt das Beispiel ein-Symbol mit einem Frage Feldsymbol an, das dem Benutzer die Möglichkeit bietet, den Vorgang abzubrechen.After verifying that a string variable, ServerName, is empty, the example displays a MessageBox with a question box icon, offering the user the option to cancel the operation. Wenn der Show Rückgabewert der Methode als ausgewertet Yeswird, wird das Formular, MessageBox in dem angezeigt wird, geschlossen.If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

private:
   void validateUserEntry3()
   {
      // 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, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1 );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }
private void validateUserEntry3()
{

    // 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;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
        MessageBoxIcon.Question, MessageBoxDefaultButton.Button1);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();

        }

    }

}

Private Sub ValidateUserEntry3()

    ' 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 = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, MessageBoxIcon.Question, _
            MessageBoxDefaultButton.Button1)

        ' 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

Hinweise

Es können maximal drei Schaltflächen im Meldungs Feld angezeigt werden.You can have a maximum of three buttons on the message box.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

Siehe auch

Show(IWin32Window, String, String, MessageBoxButtons)

Zeigt vor dem angegebenen Objekt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung und den angegebenen Schaltflächen an.Displays a message box in front of the specified object and with the specified text, caption, and buttons.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.An implementation of IWin32Window that will own the modal dialog box.

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.buttons is not a member of MessageBoxButtons.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Dies wird durch die UserInteractive-Eigenschaft angegeben.This is specified by the UserInteractive property.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein MessageBox mit den Optionen angezeigt wird, die von Showdieser Überladung unterstützt werden.The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. Nachdem Sie überprüft haben, dass eine ServerNameZeichen folgen Variable,, leer ist, MessageBoxwird im Beispiel ein angezeigt, das dem Benutzer die Möglichkeit bietet, den Vorgang abzubrechen.After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. Wenn der Show Rückgabewert der Methode als ausgewertet Yeswird, wird das Formular, MessageBox in dem angezeigt wird, geschlossen.If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

private:
   void validateUserEntry5()
   {
      // 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 validateUserEntry5()
{

    // 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;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();

        }

    }

}
Private Sub ValidateUserEntry5()

    ' 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 = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo)

        ' 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

Hinweise

Sie können den owner -Parameter verwenden, um ein bestimmtes-Objekt anzugeben, IWin32Window das die-Schnittstelle implementiert, die als Fenster der obersten Ebene des Dialog Felds und als Besitzer fungiert.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. Ein Meldungs Feld ist ein modales Dialogfeld. Dies bedeutet, dass keine Eingabe (Tastatur oder Mausklick) mit Ausnahme von Objekten auf dem modalen Formular auftreten kann.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. Das Programm muss ein modales Formular (in der Regel als Reaktion auf eine Benutzeraktion) ausblenden oder schließen, bevor Eingaben in ein anderes Formular auftreten können.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Es können maximal drei Schaltflächen im Meldungs Feld angezeigt werden.You can have a maximum of three buttons on the message box.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

Siehe auch

Show(String, String, MessageBoxButtons, MessageBoxIcon)

Zeigt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen und dem angegebenen Symbol an.Displays a message box with specified text, caption, buttons, and icon.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon) As DialogResult

Parameter

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfeld angezeigt werden soll.One of the MessageBoxIcon values that specifies which icon to display in the message box.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Ausnahmen

Der angegebene buttons-Parameter ist kein Member von MessageBoxButtons.The buttons parameter specified is not a member of MessageBoxButtons.

- oder --or- Der angegebene icon-Parameter ist kein Member von MessageBoxIcon.The icon parameter specified is not a member of MessageBoxIcon.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Dies wird durch die UserInteractive-Eigenschaft angegeben.This is specified by the UserInteractive property.

Beispiele

Im folgenden Codebeispiel wird eine der- Show Methoden für die Behandlung ComboBox.DropDown des-Ereignisses veranschaulicht.The following code example demonstrates one of the Show methods when handling the ComboBox.DropDown event. Um das Beispiel auszuführen, fügen Sie den folgenden Code in ein Formular ein, InitializeComboBox und nennen Sie die-Methode aus dem Load Konstruktor oder der-Methode des Formulars.To run the example, paste the following code in a form and call the InitializeComboBox method from the form's constructor or Load method.

internal:
   // Declare ComboBox1
   System::Windows::Forms::ComboBox^ ComboBox1;

private:
   // Initialize ComboBox1.
   void InitializeComboBox()
   {
      this->ComboBox1 = gcnew ComboBox;
      this->ComboBox1->Location = System::Drawing::Point( 128, 48 );
      this->ComboBox1->Name = "ComboBox1";
      this->ComboBox1->Size = System::Drawing::Size( 100, 21 );
      this->ComboBox1->TabIndex = 0;
      this->ComboBox1->Text = "Typical";
      array<String^>^ installs = {"Typical","Compact","Custom"};
      ComboBox1->Items->AddRange( installs );
      this->Controls->Add( this->ComboBox1 );
      
      // Hook up the event handler.
      this->ComboBox1->DropDown += gcnew System::EventHandler(
         this, &Form1::ComboBox1_DropDown );
   }

   // Handles the ComboBox1 DropDown event. If the user expands the  
   // drop-down box, a message box will appear, recommending the
   // typical installation.
   void ComboBox1_DropDown( Object^ sender, System::EventArgs^ e )
   {
      MessageBox::Show( "Typical installation is strongly recommended.",
         "Install information", MessageBoxButtons::OK,
         MessageBoxIcon::Information );
   }

// Declare ComboBox1.
internal System.Windows.Forms.ComboBox ComboBox1;

// Initialize ComboBox1.
private void InitializeComboBox()
{
    this.ComboBox1 = new ComboBox();
    this.ComboBox1.Location = new System.Drawing.Point(128, 48);
    this.ComboBox1.Name = "ComboBox1";
    this.ComboBox1.Size = new System.Drawing.Size(100, 21);
    this.ComboBox1.TabIndex = 0;
    this.ComboBox1.Text	= "Typical";
    string[] installs = new string[]{"Typical", "Compact", "Custom"};
    ComboBox1.Items.AddRange(installs);
    this.Controls.Add(this.ComboBox1);
    
    // Hook up the event handler.
    this.ComboBox1.DropDown +=  
        new System.EventHandler(ComboBox1_DropDown);
}

// Handles the ComboBox1 DropDown event. If the user expands the  
// drop-down box, a message box will appear, recommending the
// typical installation.
private void ComboBox1_DropDown(object sender, System.EventArgs e)
{
    MessageBox.Show("Typical installation is strongly recommended.", 
    "Install information", MessageBoxButtons.OK, 
        MessageBoxIcon.Information);
}

' Declare ComboBox1.
Friend WithEvents ComboBox1 As System.Windows.Forms.ComboBox

' Initialize ComboBox1.
Private Sub InitializeComboBox()
    Me.ComboBox1 = New ComboBox
    Me.ComboBox1.Location = New System.Drawing.Point(128, 48)
    Me.ComboBox1.Name = "ComboBox1"
    Me.ComboBox1.Size = New System.Drawing.Size(100, 21)
    Me.ComboBox1.TabIndex = 0
    Me.ComboBox1.Text = "Typical"
    Dim installs() As String = New String() _
        {"Typical", "Compact", "Custom"}
    ComboBox1.Items.AddRange(installs)
    Me.Controls.Add(Me.ComboBox1)
End Sub

' Handles the ComboBox1 DropDown event. If the user expands the  
' drop-down box, a message box will appear, recommending the
' typical installation.
Private Sub ComboBox1_DropDown _ 
    (ByVal sender As Object, ByVal e As System.EventArgs) _ 
    Handles ComboBox1.DropDown
    MessageBox.Show("Typical installation is strongly recommended.", _
    "Install information", MessageBoxButtons.OK, MessageBoxIcon.Information)
End Sub

Hinweise

Es können maximal drei Schaltflächen im Meldungs Feld angezeigt werden.You can have a maximum of three buttons on the message box.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

Siehe auch

Show(IWin32Window, String, String)

Zeigt vor dem angegebenen Objekt ein Meldungsfeld mit dem angegebenen Text und der angegebenen Beschriftung an.Displays a message box in front of the specified object and with the specified text and caption.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption);
static member Show : System.Windows.Forms.IWin32Window * string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.An implementation of IWin32Window that will own the modal dialog box.

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Hinweise

Sie können den owner -Parameter verwenden, um ein bestimmtes-Objekt anzugeben, IWin32Window das die-Schnittstelle implementiert, die als Fenster der obersten Ebene des Dialog Felds und als Besitzer fungiert.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. Ein Meldungs Feld ist ein modales Dialogfeld. Dies bedeutet, dass keine Eingabe (Tastatur oder Mausklick) mit Ausnahme von Objekten auf dem modalen Formular auftreten kann.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. Das Programm muss ein modales Formular (in der Regel als Reaktion auf eine Benutzeraktion) ausblenden oder schließen, bevor Eingaben in ein anderes Formular auftreten können.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Standardmäßig wird im Meldungs Feld die Schaltfläche OK angezeigt.By default, the message box displays an OK button.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

Show(String, String, MessageBoxButtons)

Zeigt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung und den angegebenen Schaltflächen an.Displays a message box with specified text, caption, and buttons.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons) As DialogResult

Parameter

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Ausnahmen

Der angegebene buttons-Parameter ist kein Member von MessageBoxButtons.The buttons parameter specified is not a member of MessageBoxButtons.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Dies wird durch die UserInteractive-Eigenschaft angegeben.This is specified by the UserInteractive property.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein MessageBox mit den Optionen angezeigt wird, die von Showdieser Überladung unterstützt werden.The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. Nachdem Sie überprüft haben, dass eine ServerNameZeichen folgen Variable,, leer ist, MessageBoxwird im Beispiel ein angezeigt, das dem Benutzer die Möglichkeit bietet, den Vorgang abzubrechen.After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. Wenn der Show Rückgabewert der Methode als ausgewertet Yeswird, wird das Formular, MessageBox in dem angezeigt wird, geschlossen.If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

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

Hinweise

Es können maximal drei Schaltflächen im Meldungs Feld angezeigt werden.You can have a maximum of three buttons on the message box.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

Siehe auch

Show(IWin32Window, String)

Zeigt vor dem angegebenen Objekt ein Meldungsfeld mit dem angegebenen Text an.Displays a message box in front of the specified object and with the specified text.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text);
static member Show : System.Windows.Forms.IWin32Window * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.An implementation of IWin32Window that will own the modal dialog box.

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Hinweise

Sie können den owner -Parameter verwenden, um ein bestimmtes-Objekt anzugeben, IWin32Window das die-Schnittstelle implementiert, die als Fenster der obersten Ebene des Dialog Felds und als Besitzer fungiert.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner. Ein Meldungs Feld ist ein modales Dialogfeld. Dies bedeutet, dass keine Eingabe (Tastatur oder Mausklick) mit Ausnahme von Objekten auf dem modalen Formular auftreten kann.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. Das Programm muss ein modales Formular (in der Regel als Reaktion auf eine Benutzeraktion) ausblenden oder schließen, bevor Eingaben in ein anderes Formular auftreten können.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur.

Standardmäßig wird im Meldungs Feld die Schaltfläche OK angezeigt.By default, the message box displays an OK button. Das Meldungs Feld enthält keine Beschriftung im Titel.The message box does not contain a caption in the title.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

Show(String, String)

Zeigt ein Meldungsfeld mit dem angegebenen Text und der angegebenen Beschriftung an.Displays a message box with specified text and caption.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption);
public static System.Windows.Forms.DialogResult Show (string text, string caption);
static member Show : string * string -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String) As DialogResult

Parameter

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Hinweise

Standardmäßig wird im Meldungs Feld die Schaltfläche OK angezeigt.By default, the message box displays an OK button.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

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

Zeigt ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, dem angegebenen Symbol, der Standardschaltfläche und Optionen an.Displays a message box with the specified text, caption, buttons, icon, default button, and options.

public:
 static System::Windows::Forms::DialogResult Show(System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options);
public static System.Windows.Forms.DialogResult Show (string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options);
static member Show : string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions -> System.Windows.Forms.DialogResult
Public Shared Function Show (text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions) As DialogResult

Parameter

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfeld angezeigt werden soll.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfeld angibt.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfeld angibt.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.You may pass in 0 if you wish to use the defaults.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- oder --or- icon ist kein Member von MessageBoxIcon.icon is not a member of MessageBoxIcon.

- oder --or- Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Dies wird durch die UserInteractive-Eigenschaft angegeben.This is specified by the UserInteractive property.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.options specified both DefaultDesktopOnly and ServiceNotification.

- oder --or- buttons gab eine ungültige Kombination von MessageBoxButtons an.buttons specified an invalid combination of MessageBoxButtons.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein MessageBox mit den Optionen angezeigt wird, die von Showdieser Überladung unterstützt werden.The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. Nachdem Sie überprüft haben, dass eine ServerNameZeichen folgen Variable,, leer ist, MessageBox zeigt das Beispiel ein-Symbol mit einem Frage Feldsymbol an, das dem Benutzer die Möglichkeit bietet, den Vorgang abzubrechen.After verifying that a string variable, ServerName, is empty, the example displays a MessageBox with a question box icon, offering the user the option to cancel the operation. Das Beispiel verwendet den RightAlign Member MessageBoxOptions der-Enumeration, um den Text an der rechten Kante des Dialog Felds auszurichten.The example uses the RightAlign member of the MessageBoxOptions enumeration to align the text to the right edge of the dialog box. Wenn der Show Rückgabewert der Methode als ausgewertet Yeswird, wird das Formular, MessageBox in dem angezeigt wird, geschlossen.If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.

private:
   void validateUserEntry2()
   {
      // 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, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, MessageBoxOptions::RightAlign );
         if ( result == ::DialogResult::Yes )
         {
            // Closes the parent form.
            this->Close();
         }
      }
   }

private void validateUserEntry2()
{

    // 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;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons,
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, 
            MessageBoxOptions.RightAlign);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();

        }

    }

}

Private Sub ValidateUserEntry2()


    ' 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 = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo, _
            MessageBoxIcon.Question, MessageBoxDefaultButton.Button1, MessageBoxOptions.RightAlign)


        ' 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

Hinweise

Es können maximal drei Schaltflächen im Meldungs Feld angezeigt werden.You can have a maximum of three buttons on the message box.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

Siehe auch

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

Zeigt mithilfe der angegebenen Hilfedatei, HelpNavigator und des angegebenen Hilfethemas ein Meldungsfeld mit dem angegebenen Text, der angegebenen Beschriftung, den angegebenen Schaltflächen, dem angegebenen Symbol, der angegebenen Standardschaltfläche, den angegebenen Optionen und der Schaltfläche Hilfe an.Displays a message box with the specified text, caption, buttons, icon, default button, options, and Help button, using the specified Help file, HelpNavigator, and Help topic.

public:
 static System::Windows::Forms::DialogResult Show(System::Windows::Forms::IWin32Window ^ owner, System::String ^ text, System::String ^ caption, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton, System::Windows::Forms::MessageBoxOptions options, System::String ^ helpFilePath, System::Windows::Forms::HelpNavigator navigator, System::Object ^ param);
public static System.Windows.Forms.DialogResult Show (System.Windows.Forms.IWin32Window owner, string text, string caption, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton, System.Windows.Forms.MessageBoxOptions options, string helpFilePath, System.Windows.Forms.HelpNavigator navigator, object param);
static member Show : System.Windows.Forms.IWin32Window * string * string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton * System.Windows.Forms.MessageBoxOptions * string * System.Windows.Forms.HelpNavigator * obj -> System.Windows.Forms.DialogResult
Public Shared Function Show (owner As IWin32Window, text As String, caption As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton, options As MessageBoxOptions, helpFilePath As String, navigator As HelpNavigator, param As Object) As DialogResult

Parameter

owner
IWin32Window

Eine Implementierung von IWin32Window, die Besitzer des modalen Dialogfelds wird.An implementation of IWin32Window that will own the modal dialog box.

text
String

Der im Meldungsfeld anzuzeigende Text.The text to display in the message box.

caption
String

Der in der Titelleiste des Meldungsfelds anzuzeigende Text.The text to display in the title bar of the message box.

buttons
MessageBoxButtons

Ein MessageBoxButtons-Wert, der angibt, welche Schaltflächen im Meldungsfeld angezeigt werden sollen.One of the MessageBoxButtons values that specifies which buttons to display in the message box.

icon
MessageBoxIcon

Einer der MessageBoxIcon-Werte, der angibt, welches Symbol im Meldungsfeld angezeigt werden soll.One of the MessageBoxIcon values that specifies which icon to display in the message box.

defaultButton
MessageBoxDefaultButton

Einer der MessageBoxDefaultButton-Werte, der die Standardschaltfläche für das Meldungsfeld angibt.One of the MessageBoxDefaultButton values that specifies the default button for the message box.

options
MessageBoxOptions

Einer der MessageBoxOptions-Werte, der die Anzeige- und Zuordnungsoptionen für das Meldungsfeld angibt.One of the MessageBoxOptions values that specifies which display and association options will be used for the message box. Sie können 0 (null) übergeben, wenn Sie die Standardwerte verwenden möchten.You may pass in 0 if you wish to use the defaults.

helpFilePath
String

Pfad und Name der Hilfedatei, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche Hilfe klickt.The path and name of the Help file to display when the user clicks the Help button.

navigator
HelpNavigator

Einer der HelpNavigator-Werte.One of the HelpNavigator values.

param
Object

Die numerische ID des Hilfethemas, die angezeigt werden soll, wenn der Benutzer auf die Schaltfläche Hilfe klickt.The numeric ID of the Help topic to display when the user clicks the Help button.

Gibt zurück

Einer der DialogResult-Werte.One of the DialogResult values.

Ausnahmen

buttons ist kein Member von MessageBoxButtons.buttons is not a member of MessageBoxButtons.

- oder --or- icon ist kein Member von MessageBoxIcon.icon is not a member of MessageBoxIcon.

- oder --or- Der angegebene defaultButton ist kein Member von MessageBoxDefaultButton.The defaultButton specified is not a member of MessageBoxDefaultButton.

Es wurde versucht, die MessageBox in einem Prozess anzuzeigen, der nicht im UserInteractive-Modus ausgeführt wird.An attempt was made to display the MessageBox in a process that is not running in User Interactive mode. Dies wird durch die UserInteractive-Eigenschaft angegeben.This is specified by the UserInteractive property.

options gab sowohl DefaultDesktopOnly als auch ServiceNotification an.options specified both DefaultDesktopOnly and ServiceNotification.

- oder --or- buttons gab eine ungültige Kombination von MessageBoxButtons an.buttons specified an invalid combination of MessageBoxButtons.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Meldungs Feld angezeigt wird, das dem Hauptfenster übergeordnet ist.The following code example demonstrates how to show a message box parented to the main window. Im Meldungs Feld wird eine Hilfe Schaltfläche angezeigt.The message box displays a Help button. Wenn der Benutzer auf die Schaltfläche "Hilfe Mspaint.chm " klickt, wird die Hilfedatei geöffnet, und die Registerkarte "Hilfe ovals Index" und das durch das-Schlüsselwort identifizierte Thema werden angezeigt.When the user clicks the Help button, the Mspaint.chm Help file is opened and the Help index tab and the topic identified by the ovals keyword are displayed. Das Beispiel setzt voraus, Mspaint.chm dass die Hilfedatei installiert ist.The example requires that the Mspaint.chm Help file is installed.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::ComponentModel;
using namespace System::Windows::Forms;

using System;
using System.Drawing;
using System.ComponentModel;
using System.Windows.Forms;
Imports System.Drawing
Imports System.ComponentModel
Imports System.Windows.Forms
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
System::Windows::Forms::DialogResult r6 = MessageBox::Show( this, "Message with Help file and Help navigator with additional parameter.", "Help Caption", MessageBoxButtons::OK, MessageBoxIcon::Question, MessageBoxDefaultButton::Button1, (MessageBoxOptions)0, "mspaint.chm", HelpNavigator::KeywordIndex, "ovals" );
// Display message box parented to the main form. 
// The Help button opens the Mspaint.chm Help file, 
// shows index with the "ovals" keyword selected, and displays the
// associated topic.
DialogResult r6 = MessageBox.Show (this, 
                                   "Message with Help file and Help navigator with additional parameter.", 
                                   "Help Caption", MessageBoxButtons.OK, 
                                   MessageBoxIcon.Question, 
                                   MessageBoxDefaultButton.Button1, 
                                   0, "mspaint.chm", 
                                   HelpNavigator.KeywordIndex, "ovals");

' Display message box parented to the main form. 
' The Help button opens the Mspaint.chm Help file, 
' shows index with the "ovals" keyword selected, and displays the
' associated topic.
Dim r6 As DialogResult = MessageBox.Show(Me, _
                                   "Message with Help file and Help navigator with additional parameter.", _
                                   "Help Caption", MessageBoxButtons.OK, _
                                   MessageBoxIcon.Question, _
                                   MessageBoxDefaultButton.Button1, _
                                   0, "mspaint.chm", _
                                   HelpNavigator.KeywordIndex, "ovals")

Hinweise

Ein Meldungs Feld ist ein modales Dialogfeld. Dies bedeutet, dass keine Eingabe (Tastatur oder Mausklick) mit Ausnahme von Objekten auf dem modalen Formular auftreten kann.A message box is a modal dialog box, which means no input (keyboard or mouse click) can occur except to objects on the modal form. Das Programm muss ein modales Formular (in der Regel als Reaktion auf eine Benutzeraktion) ausblenden oder schließen, bevor Eingaben in ein anderes Formular auftreten können.The program must hide or close a modal form (typically in response to some user action) before input to another form can occur. Sie können den owner -Parameter verwenden, um ein bestimmtes-Objekt anzugeben, IWin32Window das die-Schnittstelle implementiert, die als Fenster der obersten Ebene des Dialog Felds und als Besitzer fungiert.You can use the owner parameter to specify a particular object, which implements the IWin32Window interface, that will serve as the dialog box's top-level window and owner.

Wenn der Benutzer auf die Schaltfläche "Hilfe" klickt, wird die helpFilePath im-Parameter angegebene Hilfedatei geöffnet, und der navigator durch den-Parameter identifizierte Hilfe Inhalt wird angezeigt.When the user clicks the Help button, the Help file specified in the helpFilePath parameter is opened and the Help content identified by the navigator parameter is displayed. Das Formular, das das Meldungs Feld besitzt (oder das aktive Formular), HelpRequested empfängt auch das Ereignis.The form that owns the message box (or the active form) also receives the HelpRequested event.

Kompilierte Hilfedateien stellen Inhaltsverzeichnis, Index-, Such-und Schlüsselwort Verknüpfungen auf Seiten bereit.Compiled help files provide table of contents, index, search, and keyword links in pages. Folgende Werte navigatorkönnen für verwendet werden: TableOfContents, Find, Indexoder Topic.You can use the following values for navigator: TableOfContents, Find, Index, or Topic.

Sie können verwenden param , um den Topic Befehl weiter zu verfeinern.You can use param to provide further refinement of the Topic command. Wenn der navigator im-Parameter angegebene Wert, TableOfContents Indexoder Findist, sollte dieser Wert lauten null.If the value specified in the navigator parameter is TableOfContents, Index, or Find, this value should be null. Wenn der navigator Parameter auf Topicverweist, sollte dieser Wert auf ein Objekt verweisen, das den numerischen Wert des anzuzeigenden Themas enthält.If the navigator parameter references Topic, this value should reference an object that contains the numeric value of the topic to display.

Der helpFilePath -Parameter kann die Form "c:\path\sample.chm" oder "/Folder/file.htm" aufweisen.The helpFilePath parameter can be of the form C:\path\sample.chm or /folder/file.htm.

Sicherheit

UIPermission
für sichere untergeordnete Fenster, um diese Methode aufzurufen.for safe subwindows to call this method. Zugehörige Enumeration:SafeSubWindowsAssociated enumeration: SafeSubWindows

WebPermission
für den Zugriff auf eine HTML-Hilfedatei über eine HTTP-Anforderung.to access a HTML help file through a HTTP request. Zugehörige Enumeration:ConnectAssociated enumeration: Connect

SecurityPermission
der Zugriff auf eine HTML-Hilfedatei, die von einem HTTP-Server nicht bereitgestellt wirdto access a HTML help file not served from a HTTP server. Zugehörige Enumeration:UnmanagedCodeAssociated enumeration: UnmanagedCode

Siehe auch

Gilt für: