Application.Startup Application.Startup Application.Startup Application.Startup Event

Definition

Tritt auf, wenn die Run()-Methode des Application-Objekts aufgerufen wird.Occurs when the Run() method of the Application object is called.

public:
 event System::Windows::StartupEventHandler ^ Startup;
public event System.Windows.StartupEventHandler Startup;
member this.Startup : System.Windows.StartupEventHandler 
Public Custom Event Startup As StartupEventHandler 

Beispiele

Das folgende Beispiel zeigt die zum Abrufen und Verarbeiten von Optionen der Befehlszeile einer eigenständigen Anwendung.The following example shows how to acquire and process command-line options from a standalone application. Wenn die /StartMinimized -Befehlszeilenparameter angegeben wurde, die Anwendung wird im Hauptfenster geöffnet, in einem minimierten Zustand.If the /StartMinimized command-line parameter was provided, the application opens the main window in a minimized state.

<Application
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="SDKSample.App"
  Startup="App_Startup" />
using System.Windows;

namespace SDKSample
{
    public partial class App : Application
    {
        void App_Startup(object sender, StartupEventArgs e)
        {
            // Application is running
            // Process command line args
            bool startMinimized = false;
            for (int i = 0; i != e.Args.Length; ++i)
            {
                if (e.Args[i] == "/StartMinimized")
                {
                    startMinimized = true;
                }
            }

            // Create main application window, starting minimized if specified
            MainWindow mainWindow = new MainWindow();
            if (startMinimized)
            {
                mainWindow.WindowState = WindowState.Minimized;
            }
            mainWindow.Show();
        }
    }
}

Imports Microsoft.VisualBasic
Imports System.Windows

Namespace SDKSample
	Partial Public Class App
		Inherits Application
		Private Sub App_Startup(ByVal sender As Object, ByVal e As StartupEventArgs)
			' Application is running
			' Process command line args
			Dim startMinimized As Boolean = False
			Dim i As Integer = 0
			Do While i <> e.Args.Length
				If e.Args(i) = "/StartMinimized" Then
					startMinimized = True
				End If
				i += 1
			Loop

			' Create main application window, starting minimized if specified
			Dim mainWindow As New MainWindow()
			If startMinimized Then
				mainWindow.WindowState = WindowState.Minimized
			End If
			mainWindow.Show()
		End Sub
	End Class
End Namespace

XAML-Browseranwendungen (XAML browser applications; XBAPs)XAML browser applications (XBAPs) kann nicht abgerufen werden und Befehlszeilenargumente verarbeiten, da der Start mit ClickOnceClickOnce Bereitstellung (finden Sie unter Bereitstellen einer WPF-Anwendung (WPF)).cannot retrieve and process command-line arguments because they are launched with ClickOnceClickOnce deployment (see Deploying a WPF Application (WPF)). Von den zum Starten verwendeten URLs können jedoch Abfragezeichenfolgenparameter abgerufen und verarbeitet werden.However, they can retrieve and process query string parameters from the URLs that are used to launch them.

Hinweise

Eine typische Windows Presentation Foundation-Anwendung möglicherweise verschiedene Initialisierungsaufgaben ausführen, beim Start, einschließlich:A typical Windows Presentation Foundation application may perform a variety of initialization tasks when it starts up, including:

  • Verarbeiten von Befehlszeilenparametern.Processing command-line parameters.

  • Öffnen das Hauptfenster.Opening the main window.

  • Initialisieren von Anwendungsbereich Ressourcen.Initializing application-scope resources.

  • Initialisieren anwendungsspezifische Eigenschaften.Initializing application-scope properties.

Sie können deklarativ angeben, das Hauptfenster und Anwendungsbereich-Ressourcen mithilfe von XAMLXAML (StartupUri und Resourcesbzw.).You can declaratively specify the main window and application-scope resources using XAMLXAML (StartupUri and Resources, respectively). In einigen Fällen kann jedoch die Ressourcen oder im Hauptfenster der Anwendung nur programmgesteuert zur Laufzeit ermittelt werden.Sometimes, however, the resources or main window of your application can only be determined programmatically at run time. Darüber hinaus können Eigenschaften für den Anwendungsbereich und Befehlszeilenparameter nur programmgesteuert verwendet werden.Additionally, application-scope properties and command-line parameters can only be used programmatically. Die Initialisierung durch Programmierung durch Behandlung erfolgen kann die Startup Ereignis, einschließlich der folgenden:Programmatic initialization can be performed by handling the Startup event, including the following:

  • Abrufen und Verarbeiten von Befehlszeilenparametern, die verfügbar sind die Args Eigenschaft der StartupEventArgs -Klasse, die an die Startup -Ereignishandler.Acquire and process command-line parameters, which are available from the Args property of the StartupEventArgs class that is passed to the Startup event handler.

  • Initialisieren von anwendungsweiten Ressourcen mithilfe der Resources Eigenschaft.Initialize application-scope resources by using the Resources property.

  • Initialisieren Sie anwendungsspezifische Eigenschaften mithilfe der Properties Eigenschaft.Initialize application-scope properties by using the Properties property.

  • Instanziieren und (mindestens) Fenster anzeigen.Instantiate and show one (or more) windows.

Hinweis

Befehlszeilenparameter können auch durch Aufrufen der statischen erworben werden GetCommandLineArgs Methode der Environment Objekt.Command-line parameters can also be acquired by calling the static GetCommandLineArgs method of the Environment object. Allerdings GetCommandLineArgs erfordert volle Vertrauenswürdigkeit ausgeführt.However, GetCommandLineArgs requires full trust to execute.

Setzen Sie StartupUri mit XAMLXAML, das Hauptfenster, die erstellt wurde ist nicht verfügbar ist, entweder der MainWindow Eigenschaft oder die Windows Eigenschaft der Application Objekt bis nach der Startup -Ereignis verarbeitet wird.If you set StartupUri using XAMLXAML, the main window that is created is not available from either the MainWindow property or the Windows property of the Application object until after the Startup event is processed. Wenn Sie Zugriff auf das Hauptfenster während des Starts benötigen, müssen Sie manuell erstellen Sie ein neues Fensterobjekt, aus Ihrem Startup -Ereignishandler.If you need access to the main window during startup, you need to manually create a new window object from your Startup event handler.

Hinweis

Wenn Ihre Anwendung verwendet CredentialPolicy um eine Anmeldeinformationsrichtlinie anzugeben, müssen Sie CredentialPolicy nach Startup ausgelöst ist, andernfalls WPFWPF wird auf eine interne Standardrichtlinie direkt nach der Startup -Ereignis ausgelöst wurde.If your application uses CredentialPolicy to specify a credential policy, you need to set CredentialPolicy after Startup is raised; otherwise, WPFWPF sets it to a default internal policy directly after the Startup event has been raised.

Die Befehlszeilenargumente, die übergeben werden, die Startup Ereignishandler sind nicht identisch mit der URLURL Abfragezeichenfolgenparameter, die übergeben werden, ein XAML-Browseranwendung (XBAP)XAML browser application (XBAP).The command-line arguments that are passed to the Startup event handler are not the same as the URLURL query string parameters that are passed to an XAML-Browseranwendung (XBAP)XAML browser application (XBAP).

Gilt für:

Siehe auch