Application.Run Application.Run Application.Run Application.Run Method

Definition

Startet eine Windows Presentation Foundation-Anwendung.Starts a Windows Presentation Foundation application.

Überlädt

Run() Run() Run() Run()

Startet eine Windows Presentation Foundation-Anwendung.Starts a Windows Presentation Foundation application.

Run(Window) Run(Window) Run(Window)

Startet eine Windows Presentation Foundation-Anwendung und öffnet das angegebene Fenster.Starts a Windows Presentation Foundation application and opens the specified window.

Run() Run() Run() Run()

Startet eine Windows Presentation Foundation-Anwendung.Starts a Windows Presentation Foundation application.

public:
 int Run();
public int Run ();
member this.Run : unit -> int
Public Function Run () As Integer

Gibt zurück

Der Exitcode der Int32-Anwendung, der beim Herunterfahren der Anwendung an das Betriebssystem zurückgegeben wird.The Int32 application exit code that is returned to the operating system when the application shuts down. In der Standardeinstellung ist der Exitcode 0 (null).By default, the exit code value is 0.

Ausnahmen

Run() wird von einer im Browser gehosteten Anwendung (z. B. einem XAML-Browseranwendung (XBAP)XAML browser application (XBAP)) aufgerufen.Run() is called from a browser-hosted application (for example, an XAML-Browseranwendung (XBAP)XAML browser application (XBAP)).

Beispiele

Das folgende Beispiel zeigt eine Anwendung, die einen Benutzer Application definierten verwendet und daher explizit Runaufruft.The following example shows an application that uses a custom Application and must therefore explicitly call Run.

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()
        {
            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

Runwird aufgerufen, um eine WPFWPF -Anwendung zu starten.Run is called to start a WPFWPF application. Wenn Sie Application mit Markup oder Markup und Code Behind definieren, Run wird implizit aufgerufen.If you define your Application using markup, or markup and code-behind, Run will be called implicitly. Wenn Sie jedoch den Application mit Code definieren, müssen Sie explizit aufzurufen. RunHowever, if you define your Application using code, you will need to explicitly call Run.

Wenn Run aufgerufen wird, Application wird eine neue Dispatcher -Instanz an den UI-Thread angefügt.When Run is called, Application attaches a new Dispatcher instance to the UI thread. Anschließend wird die Dispatcher -Methode Run des-Objekts aufgerufen, die ein nachrichtenpump startet, um Windows-Meldungen zu verarbeiten.Next, the Dispatcher object's Run method is called, which starts a message pump to process windows messages. Zum Schluss Dispatcher OnStartup Ruft das-Objekt die-Methode des- Startup Objektsauf,umdas-Ereigniszuerhöhen.ApplicationFinally, the Dispatcher object calls the Application object's the OnStartup method to raise the Startup event. Folglich wurde das Anwendungs Ausführungs Modell von dem Zeitpunkt festgelegt, zu dem StartupSie es verarbeitet haben. zu diesem Zeitpunkt wird die Anwendung als ausgeführt betrachtet.Consequently, the application execution model has been established by the time you handle Startup, at which point the application is considered to be running.

Die Ausführung einer Anwendung wird Shutdown beendet, wenn aufgerufen wird. der ShutdownMode Wert der- Shutdown Eigenschaft bestimmt, wann aufgerufen wird und ob Sie automatisch erfolgt oder explizit aufgerufen werden muss.An application stops running when Shutdown is called; the value of the ShutdownMode property determines when Shutdown is called, and whether it happens automatically or you need to explicitly call it.

Runkann nur von dem Thread aufgerufen werden, der das Application -Objekt erstellt.Run can be called only from the thread that creates the Application object. Kann auch nicht von einem XBAPXBAPaufgerufen werden. RunAlso, Run cannot be called from a XBAPXBAP.

Siehe auch

Run(Window) Run(Window) Run(Window)

Startet eine Windows Presentation Foundation-Anwendung und öffnet das angegebene Fenster.Starts a Windows Presentation Foundation application and opens the specified window.

public:
 int Run(System::Windows::Window ^ window);
[System.Security.SecurityCritical]
public int Run (System.Windows.Window window);
member this.Run : System.Windows.Window -> int

Parameter

window
Window Window Window Window

Ein Window, das beim Start einer Anwendung automatisch geöffnet wird.A Window that opens automatically when an application starts.

Gibt zurück

Der Exitcode der Int32-Anwendung, der beim Herunterfahren der Anwendung an das Betriebssystem zurückgegeben wird.The Int32 application exit code that is returned to the operating system when the application shuts down. In der Standardeinstellung ist der Exitcode 0 (null).By default, the exit code value is 0.

Ausnahmen

Run() wird von einer im Browser gehosteten Anwendung (z. B. einem XAML-Browseranwendung (XBAP)XAML browser application (XBAP)) aufgerufen.Run() is called from a browser-hosted application (for example, an XAML-Browseranwendung (XBAP)XAML browser application (XBAP)).

Beispiele

Das folgende Beispiel zeigt eine Anwendung mit einer manuell erstellten statischen Einstiegspunkt Methode, die vor dem Aufruf Application Runvon instanziiert.The following example shows an application with a manually-created static entry point method that instantiates Application, before calling Run.

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 Run die-Methode, um das angegebene Fenster zu öffnen, nachdem eine Anwendung gestartet wurde.This overload extends the Run method to open the specified window after an application starts running.

Wenn Sie einen Code Application definieren, der ein Fenster öffnet, wenn er gestartet wird, wird explizit aufgerufen. RunIf you define a code Application that opens a window when it starts running, you explicitly call Run.

Wenn Sie Application mit Markup oder Markup und Code Behind erstellen, können Sie mit einer der folgenden Techniken automatisch ein Fenster öffnen:If you create your Application using markup, or markup and code-behind, you can automatically open a window during using either of the following techniques:

Siehe auch

Gilt für: