Application.Run Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Startet eine Windows Presentation Foundation-Anwendung.
Überlädt
Run() |
Startet eine Windows Presentation Foundation-Anwendung. |
Run(Window) |
Startet eine Windows Presentation Foundation-Anwendung und öffnet das angegebene Fenster. |
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
Der Exitcode der Int32-Anwendung, der beim Herunterfahren der Anwendung an das Betriebssystem zurückgegeben wird. In der Standardeinstellung ist der Exitcode 0 (null).
Ausnahmen
Run() wird von einer im Browser gehosteten Anwendung aufgerufen (z. B. einer XAML-Browseranwendung (XBAP)).
Beispiele
Das folgende Beispiel zeigt eine Anwendung, die eine benutzerdefinierte Application 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 Ihre Application mithilfe von Markup oder Markup und CodeBehind definieren, Run wird implizit aufgerufen. Wenn Sie ihren Application code jedoch definieren, müssen Sie explizit aufrufen Run.
Wenn Run aufgerufen wird, Application fügt eine neue Dispatcher instance an den UI-Thread an. 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 Application -Methode des OnStartup Objekts auf, um das Ereignis auszulösen Startup . Folglich wurde das Anwendungsausführungsmodell zum Zeitpunkt der Verarbeitung Startupvon festgelegt, zu dem die Anwendung als ausgeführt betrachtet wird.
Eine Anwendung wird nicht mehr ausgeführt, wenn Shutdown aufgerufen wird. Der Wert der ShutdownMode Eigenschaft bestimmt, wann Shutdown aufgerufen wird und ob dies automatisch erfolgt oder sie explizit aufgerufen werden muss.
Run kann nur aus dem Thread aufgerufen werden, der das Application -Objekt erstellt. Run Kann auch nicht von einem XBAP aufgerufen werden.
Weitere Informationen
Gilt für:
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
Gibt zurück
Der Exitcode der Int32-Anwendung, der beim Herunterfahren der Anwendung an das Betriebssystem zurückgegeben wird. In der Standardeinstellung ist der Exitcode 0 (null).
- Attribute
Ausnahmen
Run() wird von einer im Browser gehosteten Anwendung aufgerufen (z. B. einer XAML-Browseranwendung (XBAP)).
Beispiele
Das folgende Beispiel zeigt eine Anwendung mit einer manuell erstellten statischen Einstiegspunktmethode, die instanziiert Application, bevor aufgerufen wird 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 die Run -Methode, um das angegebene Fenster zu öffnen, nachdem die Ausführung einer Anwendung gestartet wurde.
Wenn Sie einen Code Application definieren, der beim Start der Ausführung ein Fenster öffnet, rufen Sie explizit auf Run.
Wenn Sie Ihre Application mithilfe von Markup oder Markup und CodeBehind erstellen, können Sie automatisch ein Fenster öffnen, während Sie eine der folgenden Techniken verwenden:
Deklarativ durch Festlegen StartupUrivon .
Programmgesteuert durch Behandeln Startupvon .
Weitere Informationen
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für