Application.Run Methode

  • Referenz

Definition

Namespace:
System.Windows
Assembly:
PresentationFramework.dll

Startet eine Windows Presentation Foundation-Anwendung.

Überlädt

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);
[System.Security.SecurityCritical]
public int Run (System.Windows.Window window);
public int Run (System.Windows.Window window);
[<System.Security.SecurityCritical>]
member this.Run : System.Windows.Window -> int
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 Anwendungsendecode, der beim Herunterfahren der Anwendung an das Betriebssystem zurückgegeben wird. Standardmäßig ist der Ausgangscodewert 0.

Attribute
SecurityCriticalAttribute

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 Applicationinstanziiert, bevor Runaufgerufen wird.

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 nach dem Start einer Anwendung zu öffnen.

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

Wenn Sie Ihre Application mithilfe von 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 von Startup.

Weitere Informationen

Gilt für:

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 Anwendungsendecode, 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 verwendet und daher explizit Runaufrufen muss.

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 Ihre Application mithilfe von Markup oder Markup und CodeBehind definieren, wird Run implizit aufgerufen. Wenn Sie ihre Application jedoch mithilfe von Code definieren, müssen Sie Runexplizit aufrufen.

Wenn Run aufgerufen wird, fügt Application eine neue Dispatcher Instanz an den UI-Thread an. Als Nächstes wird die Run-Methode des Dispatcher Objekts aufgerufen, die eine Meldungspumpe zum Verarbeiten von Fenstermeldungen 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 der Verarbeitung Startupeingerichtet, zu dem die Anwendung als ausgeführt betrachtet wird.

Eine Anwendung wird beendet, wenn Shutdown aufgerufen wird; der Wert der ShutdownMode-Eigenschaft bestimmt, wann Shutdown aufgerufen wird und ob er automatisch erfolgt oder sie explizit aufgerufen werden muss.

Run kann nur über den Thread aufgerufen werden, der das Application-Objekt erstellt. Außerdem kann Run nicht von einem XBAP aufgerufen werden.

Weitere Informationen

Gilt für: