Application.Run Methode

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Startet eine Windows Presentation Foundation-Anwendung.

Überlädt

Name	Beschreibung
Run(Window)	Startet eine Windows Presentation Foundation-Anwendung und öffnet das angegebene Fenster.
Run()	Startet eine Windows Presentation Foundation-Anwendung.

Run(Window)

Startet eine Windows Presentation Foundation-Anwendung und öffnet das angegebene Fenster.

public:
 int Run(System::Windows::Window ^ window);

public int Run(System.Windows.Window window);

member this.Run : System.Windows.Window -> int

Public Function Run (window As Window) As Integer

Parameter

window

Window

Eine Window , die automatisch geöffnet wird, wenn eine Anwendung gestartet wird.

Gibt zurück

Int32

Der Int32 Code zum Beenden der Anwendung, der beim Herunterfahren der Anwendung an das Betriebssystem zurückgegeben wird. Standardmäßig ist der Ausgangscodewert 0.

Ausnahmen

InvalidOperationException

Run() wird von einer vom Browser gehosteten Anwendung aufgerufen (z. B. eine XAML-Browseranwendung (XBAP)).

Beispiele

Das folgende Beispiel zeigt eine Anwendung mit einer manuell erstellten statischen Einstiegspunktmethode, die vor dem Aufrufen RuninstanziiertApplication.

using System;
using System.Windows;

namespace CSharp
{
    public class EntryPoint
    {
        // All WPF applications should execute on a single-threaded apartment (STA) thread
        [STAThread]
        public static void Main()
        {
            Application app = new Application();
            app.Run(new Window());
        }
    }
}

Imports System.Windows

Namespace VisualBasic
    Public Class EntryPoint
        ' All WPF applications should execute on a single-threaded apartment (STA) thread
        <STAThread()>
              Public Shared Sub Main()
            Dim app As New Application()
            app.Run(New Window())
        End Sub
    End Class
End Namespace

Hinweise

Diese Überladung erweitert die Run Methode, um das angegebene Fenster zu öffnen, nachdem eine Anwendung gestartet wurde.

Wenn Sie einen Code Application definieren, der ein Fenster öffnet, wenn es gestartet wird, rufen Sie explizit auf Run.

Wenn Sie Ihr Application Markup oder Markup und CodeBehind erstellen, können Sie während der Verwendung einer der folgenden Techniken automatisch ein Fenster öffnen:

• Deklarativ, durch Festlegen StartupUri.

• Programmgesteuert, durch Behandlung Startup.

Weitere Informationen

• Shutdown()
• Shutdown(Int32)

Run()

Startet eine Windows Presentation Foundation-Anwendung.

public:
 int Run();

public int Run();

member this.Run : unit -> int

Public Function Run () As Integer

Gibt zurück

Int32

Der Int32 Code zum Beenden der Anwendung, der beim Herunterfahren der Anwendung an das Betriebssystem zurückgegeben wird. Standardmäßig ist der Ausgangscodewert 0.

Ausnahmen

InvalidOperationException

Run() wird von einer vom Browser gehosteten Anwendung aufgerufen (z. B. eine XAML-Browseranwendung (XBAP)).

Beispiele

Das folgende Beispiel zeigt eine Anwendung, die eine benutzerdefinierte Application Anwendung verwendet und daher explizit aufrufen Runmuss.

using System;
using System.Windows;

namespace CSharp
{
    public class EntryPoint1
    {
        // All WPF applications should execute on a single-threaded apartment (STA) thread
        [STAThread]
        public static void Main()
        {
            CustomApplication app = new CustomApplication();
            app.Run();
        }
    }

    public class CustomApplication : Application
    {
        protected override void OnStartup(StartupEventArgs e)
        {
            base.OnStartup(e);

            Window window = new Window();
            window.Show();
        }
    }
}

Imports System.Windows

Namespace VisualBasic
    Public Class EntryPoint
        ' All WPF applications should execute on a single-threaded apartment (STA) thread
        <STAThread()>
              Public Shared Sub Main()
            Dim app As New CustomApplication()
            app.Run()
        End Sub
    End Class

    Public Class CustomApplication
        Inherits Application
        Protected Overrides Sub OnStartup(ByVal e As StartupEventArgs)
            MyBase.OnStartup(e)

            Dim window As New Window()
            window.Show()
        End Sub
    End Class
End Namespace

Hinweise

Run wird aufgerufen, um eine WPF-Anwendung zu starten. Wenn Sie Das Application Verwenden von Markup oder Markup und CodeBehind definieren, Run wird implizit aufgerufen. Wenn Sie den code verwendenden Code definieren Application , müssen Sie jedoch explizit aufrufen Run.

Beim Run Aufrufen Application wird eine neue Dispatcher Instanz an den UI-Thread angefügt. Als Nächstes wird die Dispatcher Methode des Run Objekts aufgerufen, die eine Nachrichtenpumpe zum Verarbeiten von Windows-Nachrichten startet. Schließlich ruft das Dispatcher Objekt die OnStartup Methode des Application Objekts auf, um das Startup Ereignis auszuheben. Folglich wurde das Anwendungsausführungsmodell zum Zeitpunkt Startupder Verarbeitung festgelegt, zu dem die Anwendung als ausgeführt betrachtet wird.

Eine Anwendung wird beendet, wenn Shutdown sie aufgerufen wird. Der Wert der ShutdownMode Eigenschaft bestimmt, wann Shutdown sie aufgerufen wird, und ob sie automatisch erfolgt oder Sie sie explizit aufrufen müssen.

Run kann nur über den Thread aufgerufen werden, der das Application Objekt erstellt. Run Auch kann nicht von einer XBAP aufgerufen werden.

Weitere Informationen

• Run(Window)
• Shutdown(Int32)
• Exit