Window.DialogResult Window.DialogResult Window.DialogResult Window.DialogResult Property

Definition

Ruft den Ergebniswert des Dialogfelds ab, d. h. den von der ShowDialog()-Methode zurückgegebenen Wert, oder legt diesen fest.Gets or sets the dialog result value, which is the value that is returned from the ShowDialog() method.

public:
 property Nullable<bool> DialogResult { Nullable<bool> get(); void set(Nullable<bool> value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.DialogResultConverter))]
public Nullable<bool> DialogResult { get; set; }
member this.DialogResult : Nullable<bool> with get, set
Public Property DialogResult As Nullable(Of Boolean)

Eigenschaftswert

Ein Nullable<T>-Wert vom Typ Boolean.A Nullable<T> value of type Boolean. Die Standardeinstellung ist false.The default is false.

Ausnahmen

DialogResult wird festgelegt, bevor ein Fenster durch Aufrufen von ShowDialog() geöffnet wird.DialogResult is set before a window is opened by calling ShowDialog().

- oder --or- DialogResult wird in einem Fenster festgelegt, das durch Aufrufen von Show() geöffnet wird.DialogResult is set on a window that is opened by calling Show().

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie eine Schaltfläche OK und eine Schaltfläche Abbrechen zum DialogResultzurückgeben der entsprechenden konfigurieren.The following example shows how to configure an OK button and a Cancel button to return the appropriate DialogResult.

<Button IsDefault="True" Click="acceptButton_Click">OK (IsDefault=True)</Button>
<Button IsCancel="True">Cancel (IsCancel=True)</Button>
using System;
using System.Windows;
using System.Windows.Controls;

namespace CSharp
{
    public partial class DialogBox : Window
    {
        public DialogBox()
        {
            InitializeComponent();
        }

        // The accept button is a button whose IsDefault property is set to true.
        // This event is raised whenever this button is clicked, or the ENTER key
        // is pressed.
        void acceptButton_Click(object sender, RoutedEventArgs e)
        {
            // Accept the dialog and return the dialog result
            this.DialogResult = true;
        }
    }
}

Imports System
Imports System.Windows
Imports System.Windows.Controls

Namespace VisualBasic
    Partial Public Class DialogBox
        Inherits Window
        Public Sub New()
            InitializeComponent()
        End Sub

        ' The accept button is a button whose IsDefault property is set to true.
        ' This event is raised whenever this button is clicked, or the ENTER key
        ' is pressed.
        Private Sub acceptButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
            ' Accept the dialog and return the dialog result
            Me.DialogResult = True
        End Sub
    End Class
End Namespace

Hinweise

DialogResultkann aus dem Code verwendet werden, der ein Dialogfeld anzeigt, um zu bestimmen, obtrueein Benutzer das DialogfalseFeld akzeptiert () oder abgebrochen () hat.DialogResult can be used from the code that showed a dialog box to determine whether a user accepted (true) or canceled (false) the dialog box. Wenn ein Dialogfeld akzeptiert wurde, bedeutet dies für den Code, der das Dialogfeld geöffnet hat, um die vom Benutzer gesammelten Daten abzurufen und zu verarbeiten.If a dialog box was accepted, this signifies to the code that opened the dialog box to retrieve the data that was collected by the user and process it. Wenn ein Dialogfeld abgebrochen wurde, bedeutet dies jedoch, dass der aufrufende Code alle weiteren Verarbeitungsvorgänge abbrechen soll.If a dialog box was canceled, however, this signifies that calling code should stop any further processing.

Standardmäßig wird ein Dialogfeld abgebrochen, wenn ein Benutzer eine der folgenden Aktionen durchführt:By default, a dialog box is canceled when a user does one of the following:

  • Pressesalt + F4.PressesALT+F4.

  • Klickt auf die Schaltfläche Schließen .Clicks the Close button.

  • Wählt Schließen im Menü System aus.Selects Close from the System menu.

In allen diesen Fällen DialogResult ist false standardmäßig.In all of these cases, DialogResult is false by default.

Ein Dialogfeld stellt in der Regel eine spezielle Schaltfläche zum Abbrechen eines Dialogs bereit. dies IsCancel ist die Schaltfläche true, deren-Eigenschaft auf festgelegt ist.A dialog box typically provides a special button to cancel a dialog, which is the button whose IsCancel property is set to true. Eine auf diese Weise konfigurierte Schaltfläche schließt ein Fenster automatisch, wenn es gedrückt wird oder wenn die ESC-Taste gedrückt wird.A button configured this way will automatically close a window when either it is pressed, or when the ESC key is pressed. In jedem dieser Fälle DialogResult bleibt bestehen. falseIn either of these cases, DialogResult remains false.

Ein Dialogfeld stellt in der Regel auch eine Accept-Schaltfläche bereit. IsDefault Dies ist die Schalt trueFläche, deren-Eigenschaft auf festgelegt istA dialog box also typically provides an accept button, which is the button whose IsDefault property is set to true. Eine auf diese Weise Click konfigurierte Schaltfläche gibt das-Ereignis aus, wenn entweder die EINGABETASTE oder die EINGABETASTE gedrückt wird.A button configured this way will raise its Click event when either it or the ENTER key is pressed. Das Dialogfeld wird jedoch nicht automatisch geschlossen, und es wird nicht auf DialogResult truefestgelegt.However, it won't automatically close the dialog box, nor will it set DialogResult to true. Sie müssen diesen Code manuell schreiben, üblicherweise aus Click dem-Ereignishandler für die Standard Schaltfläche.You need to manually write this code, usually from the Click event handler for the default button.

DialogResultgibt null an, wann das Dialogfeld angezeigt wird, aber weder akzeptiert noch abgebrochen wurde.DialogResult is null when the dialog box is shown but neither accepted nor canceled.

Nachdem ein Dialogfeld geschlossen wurde, können Sie das Dialogfeld Ergebnis von dem Wert, ShowDialog der von der-Methode zurückgegeben DialogResult wird, oder durch Überprüfen der-Eigenschaft erhalten.After a dialog box closes, you can get the dialog result from the value returned by ShowDialog method, or by inspecting the DialogResult property.

DialogResultkann nur festgelegt werden, Window wenn eine durch Aufrufen der ShowDialog zugehörigen-Methode geöffnet wird.DialogResult can only be set when a Window is opened by calling its ShowDialog method.

Hinweis

Sie können diese Eigenschaft nicht festlegen oder erhalten, wenn ein Fenster in einem Browser gehostet wird.You cannot set or get this property when a window is hosted in a browser.

Gilt für: