Application.Startup Kejadian
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Terjadi ketika Run() metode objek dipanggil 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
Jenis Acara
Contoh
Contoh berikut menunjukkan cara memperoleh dan memproses opsi baris perintah dari aplikasi mandiri. Jika parameter baris perintah /StartMinimized disediakan, aplikasi akan membuka jendela utama dalam status diminimalkan.
<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
Aplikasi browser XAML (XBAP) tidak dapat mengambil dan memproses argumen baris perintah karena diluncurkan dengan penyebaran ClickOnce (lihat Menyebarkan Aplikasi WPF (WPF)). Namun, mereka dapat mengambil dan memproses parameter string kueri dari URL yang digunakan untuk meluncurkannya.
Keterangan
Aplikasi Windows Presentation Foundation yang khas dapat melakukan berbagai tugas inisialisasi saat dimulai, termasuk:
Memproses parameter baris perintah.
Membuka jendela utama.
Menginisialisasi sumber daya cakupan aplikasi.
Menginisialisasi properti cakupan aplikasi.
Anda dapat secara deklaratif menentukan jendela utama dan sumber daya cakupan aplikasi menggunakan XAML (StartupUri dan Resources, masing-masing). Namun, terkadang, sumber daya atau jendela utama aplikasi Anda hanya dapat ditentukan secara terprogram pada durasi. Selain itu, properti cakupan aplikasi dan parameter baris perintah hanya dapat digunakan secara terprogram. Inisialisasi terprogram dapat dilakukan dengan menangani Startup peristiwa, termasuk yang berikut ini:
Memperoleh dan memproses parameter baris perintah, yang tersedia dari Args properti StartupEventArgs kelas yang diteruskan ke penanganan Startup aktivitas.
Menginisialisasi sumber daya cakupan aplikasi dengan menggunakan Resources properti .
Menginisialisasi properti cakupan aplikasi dengan menggunakan Properties properti .
Membuat instans dan menampilkan satu (atau beberapa) jendela.
Catatan
Parameter baris perintah juga dapat diperoleh dengan memanggil metode Environment statis GetCommandLineArgs objek. Namun, GetCommandLineArgs membutuhkan kepercayaan penuh untuk dijalankan.
Jika Anda mengatur StartupUri menggunakan XAML, jendela utama yang dibuat tidak tersedia dari MainWindow properti atau Windows properti Application objek hingga setelah Startup peristiwa diproses. Jika Anda memerlukan akses ke jendela utama selama startup, Anda perlu membuat objek jendela baru secara manual dari penanganan aktivitas Anda Startup .
Catatan
Jika aplikasi Anda menggunakan CredentialPolicy untuk menentukan kebijakan kredensial, Anda perlu mengatur CredentialPolicy setelah Startup dinaikkan; jika tidak, WPF mengaturnya ke kebijakan internal default langsung setelah Startup peristiwa dinaikkan.
Argumen baris perintah yang diteruskan ke Startup penanganan aktivitas tidak sama dengan parameter string kueri URL yang diteruskan ke aplikasi browser XAML (XBAP).