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(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
Gibt zurück
Der Int32 Anwendungsendecode, der beim Herunterfahren der Anwendung an das Betriebssystem zurückgegeben wird. Standardmäßig ist der Ausgangscodewert 0.
- Attribute
Ausnahmen
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
Der Int32 Anwendungsendecode, der beim Herunterfahren der Anwendung an das Betriebssystem zurückgegeben wird. Standardmäßig ist der Ausgangscodewert 0.
Ausnahmen
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:
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