Application.Startup Evento

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

Si verifica quando viene chiamato il metodo Run() dell'oggetto Application.

public:
 event System::Windows::StartupEventHandler ^ Startup;

public event System.Windows.StartupEventHandler Startup;

member this.Startup : System.Windows.StartupEventHandler 

Public Custom Event Startup As StartupEventHandler 

Tipo evento

StartupEventHandler

Esempio

Nell'esempio seguente viene illustrato come acquisire ed elaborare le opzioni della riga di comando da un'applicazione autonoma. Se è stato specificato il parametro della riga di comando /StartMinimized , l'applicazione apre la finestra principale in uno stato ridotto al minimo.

<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 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

Le applicazioni del browser XAML (XBAP) non possono recuperare ed elaborare gli argomenti della riga di comando perché vengono avviati con la distribuzione ClickOnce (vedere Distribuzione di un'applicazione WPF). Tuttavia, possono recuperare ed elaborare parametri della stringa di query dagli URL usati per avviarle.

Commenti

Un'applicazione tipica Windows Presentation Foundation può eseguire diverse attività di inizializzazione all'avvio, tra cui:

• Elaborazione dei parametri della riga di comando.

• Apertura della finestra principale.

• Inizializzazione delle risorse dell'ambito dell'applicazione.

• Inizializzazione delle proprietà dell'ambito dell'applicazione.

È possibile specificare rispettivamente la finestra principale e le risorse dell'ambito dell'applicazione usando XAML (StartupUri e Resources, ). A volte, tuttavia, le risorse o la finestra principale dell'applicazione possono essere determinate solo a livello di codice in fase di esecuzione. Inoltre, le proprietà dell'ambito dell'applicazione e i parametri della riga di comando possono essere usati solo a livello di codice. L'inizializzazione a livello di codice può essere eseguita gestendo l'evento Startup , incluso quanto segue:

• Acquisire e elaborare i parametri della riga di comando, disponibili dalla Args proprietà della StartupEventArgs classe passata al Startup gestore eventi.

• Inizializzare le risorse dell'ambito dell'applicazione usando la Resources proprietà .

• Inizializzare le proprietà dell'ambito dell'applicazione usando la Properties proprietà .

• Creare un'istanza e visualizzare una o più finestre.

Nota

I parametri della riga di comando possono essere acquisiti chiamando anche il metodo statico GetCommandLineArgs dell'oggetto Environment . Tuttavia, GetCommandLineArgs è necessario eseguire l'attendibilità completa.

Se si imposta StartupUri l'uso di XAML, la finestra principale creata non è disponibile dalla MainWindow proprietà o dalla Windows proprietà dell'oggetto fino a quando non viene elaborato l'evento ApplicationStartup . Se è necessario accedere alla finestra principale durante l'avvio, è necessario creare manualmente un nuovo oggetto finestra dal Startup gestore eventi.

Nota

Se l'applicazione usa CredentialPolicy per specificare un criterio di credenziali, è necessario impostare CredentialPolicy dopo Startup l'generazione. In caso contrario, WPF lo imposta su un criterio interno predefinito direttamente dopo che l'evento Startup è stato generato.

Gli argomenti della riga di comando passati al gestore eventi non sono uguali ai Startup parametri delle stringhe di query URL passati a un'applicazione browser XAML (XBAP).

Vedi anche

• OnStartup(StartupEventArgs)
• Exit