Application.Startup Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Si verifica quando viene chiamato il Run() metodo 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
Esempio
L'esempio seguente illustra 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 a icona.
<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 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 i parametri della stringa di query dagli URL usati per avviarli.
Commenti
Una tipica applicazione 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 in modo dichiarativo le risorse della finestra principale e dell'ambito dell'applicazione usando rispettivamente XAML (StartupUri e Resources). In alcuni casi, 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 ed 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.
Annotazioni
I parametri della riga di comando possono essere acquisiti anche chiamando il metodo statico GetCommandLineArgs dell'oggetto Environment . Tuttavia, GetCommandLineArgs richiede l'attendibilità totale da eseguire.
Se imposti StartupUri tramite XAML, la finestra principale creata non è disponibile dalla MainWindow proprietà o dalla Windows proprietà dell'oggetto Application fino a quando non viene elaborato l'evento Startup . Se è necessario accedere alla finestra principale durante l'avvio, è necessario creare manualmente un nuovo oggetto finestra dal Startup gestore eventi.
Annotazioni
Se l'applicazione usa CredentialPolicy per specificare un criterio delle credenziali, è necessario impostare CredentialPolicy dopo Startup la generazione. In caso contrario, WPF lo imposta su un criterio interno predefinito direttamente dopo la generazione dell'evento Startup .
Gli argomenti della riga di comando passati al gestore eventi non corrispondono ai Startup parametri della stringa di query URL passati a un'applicazione browser XAML (XBAP).
