War diese Seite hilfreich?
Ihr Feedback ist uns wichtig. Teilen Sie uns Ihre Meinung mit.
Weiteres Feedback?
1500 verbleibende Zeichen
Exportieren (0) Drucken
Alle erweitern

Window.DialogResult-Eigenschaft

Aktualisiert: November 2007

Ruft den Ergebniswert des Dialogfelds ab, d. h. den von der ShowDialog-Methode zurückgegebenen Wert, oder legt diesen fest.

Namespace:  System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

[TypeConverterAttribute(typeof(DialogResultConverter))]
public Nullable<bool> DialogResult { get; set; }
/** @property */
/** @attribute TypeConverterAttribute(DialogResultConverter) */
public Nullable<boolean> get_DialogResult()
/** @property */
/** @attribute TypeConverterAttribute(DialogResultConverter) */
public  void set_DialogResult(Nullable<boolean> value)

public function get DialogResult () : Nullable<boolean>
public function set DialogResult (value : Nullable<boolean>)
Sie können diese Eigenschaft nicht in XAML festlegen.

Eigenschaftenwert

Typ: System.Nullable<Boolean>
Ein Nullable<T>-Wert vom Typ Boolean. Der Standardwert ist false.

AusnahmeBedingung
InvalidOperationException

DialogResult wird festgelegt, bevor ein Fenster durch Aufrufen von ShowDialog oder Aufrufen von Show geöffnet wird.

DialogResult kann in dem Code verwendet werden, über den ein Dialogfeld angezeigt wurde, um zu bestimmen, ob ein Benutzer das Dialogfeld bestätigt (true) oder abgebrochen (false) hat. Wenn ein Dialogfeld bestätigt wurde, gibt dies dem Code, über den das Dialogfeld geöffnet wurde, an, die vom Benutzer erfassten Daten abzurufen und zu verarbeiten. Wenn ein Dialogfeld abgebrochen wurde, gibt dies hingegen an, dass aufrufender Code die weitere Verarbeitung beenden soll.

Standardmäßig wird ein Dialogfeld abgebrochen, wenn ein Benutzer eine der folgenden Aktionen ausführt:

  • Drücken vonALT+F4.

  • Klicken auf die Schaltfläche Schließen.

  • Auswählen von Schließen im Systemmenü.

In all diesen Fällen ist DialogResult standardmäßig false.

Ein Dialogfeld stellt meist eine spezielle Schaltfläche zum Abbrechen des Dialogfelds bereit, d. h. eine Schaltfläche, deren IsCancel-Eigenschaft auf true festgelegt ist. Über eine auf diese Weise konfigurierte Schaltfläche wird ein Fenster automatisch geschlossen, wenn auf diese geklickt oder aber ESC gedrückt wird. In beiden Fällen behält DialogResult den Wert false bei.

Ein Dialogfeld stellt meist auch eine Schaltfläche zum Bestätigen bereit, d. h. eine Schaltfläche, deren IsDefault-Eigenschaft auf true festgelegt ist. Eine auf diese Weise konfigurierte Schaltfläche löst das zugehörige Click-Ereignis aus, wenn auf diese geklickt oder aber die EINGABETASTE gedrückt wird. Dadurch wird das Dialogfeld jedoch nicht automatisch geschlossen, und DialogResult wird nicht auf true festgelegt. Diesen Code müssen Sie manuell schreiben, üblicherweise über den Click-Ereignishandler für die Standardschaltfläche.

Wenn ein Dialogfeld geschlossen wurde, können Sie das Dialogfeldergebnis von dem von der ShowDialog-Methode zurückgegebenen Wert oder durch Überprüfen der DialogResult-Eigenschaft abrufen.

DialogResult kann nur festgelegt werden, wenn ein Window durch Aufrufen der zugehörigen ShowDialog-Methode geöffnet wird.

ms588776.alert_note(de-de,VS.90).gifHinweis:

Sie können diese Eigenschaft nicht festlegen oder abrufen, wenn ein Fenster in einem Browser gehostet wird.

Im folgenden Beispiel wird veranschaulicht, wie eine Schaltfläche OK und eine Schaltfläche Abbrechen für das Zurückgeben des entsprechenden DialogResult konfiguriert werden.

<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;
        }
    }
}


Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0

Community-Beiträge

HINZUFÜGEN
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?
Anzeigen:
© 2015 Microsoft