Application.Startup Händelse
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Inträffar när Run() -metoden för Application objektet anropas.
public:
event System::Windows::StartupEventHandler ^ Startup;
public event System.Windows.StartupEventHandler Startup;
member this.Startup : System.Windows.StartupEventHandler
Public Custom Event Startup As StartupEventHandler
Händelsetyp
Exempel
I följande exempel visas hur du hämtar och bearbetar kommandoradsalternativ från ett fristående program. Om kommandoradsparametern /StartMinimized angavs öppnar programmet huvudfönstret i ett minimerat tillstånd.
<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
XAML-webbläsarprogram (XBAPs) kan inte hämta och bearbeta kommandoradsargument eftersom de startas med ClickOnce-distribution (se Distribuera ett WPF-program (WPF)). De kan dock hämta och bearbeta frågesträngsparametrar från de URL:er som används för att starta dem.
Kommentarer
Ett typiskt Windows Presentation Foundation program kan utföra en mängd olika initieringsuppgifter när det startas, inklusive:
Bearbeta kommandoradsparametrar.
Öppnar huvudfönstret.
Initierar programomfattningsresurser.
Initierar egenskaper för programomfattning.
Du kan deklarativt ange huvudfönstret och programomfattningsresurserna med XAML (StartupUriResourcesrespektive ). Ibland kan dock resurserna eller huvudfönstret i ditt program endast fastställas programmatiskt vid körning. Dessutom kan egenskaper för programomfattning och kommandoradsparametrar endast användas programmatiskt. Programmatisk initiering kan utföras genom att hantera Startup händelsen, inklusive följande:
Hämta och bearbeta kommandoradsparametrar som är tillgängliga från Args egenskapen för klassen StartupEventArgs som skickas till Startup händelsehanteraren.
Initiera programomfattningsresurser med hjälp Resources av egenskapen .
Initiera egenskaper för programomfattning med hjälp av egenskapen Properties .
Instansiera och visa ett (eller flera) fönster.
Note
Kommandoradsparametrar kan också hämtas genom att anropa objektets GetCommandLineArgs statiska Environment metod. Kräver dock GetCommandLineArgs fullständigt förtroende för att köras.
Om du anger StartupUri med XAML är huvudfönstret som skapas inte tillgängligt från antingen egenskapen MainWindow eller egenskapen Windows för objektet Application tills händelsen Startup har bearbetats. Om du behöver åtkomst till huvudfönstret under starten måste du manuellt skapa ett nytt fönsterobjekt från händelsehanteraren Startup .
Note
Om ditt program använder CredentialPolicy för att ange en princip för autentiseringsuppgifter måste du ange CredentialPolicy efter att Startup har aktiverats. annars anger WPF den till en intern standardprincip direkt efter att händelsen Startup har skapats.
Kommandoradsargumenten som skickas till Startup händelsehanteraren är inte samma som url-frågesträngsparametrarna som skickas till ett XAML-webbläsarprogram (XBAP).