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