Application.Startup Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Se produce cuando se llama al Run() método del Application objeto .
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 de evento
Ejemplos
En el ejemplo siguiente se muestra cómo adquirir y procesar opciones de línea de comandos desde una aplicación independiente. Si se proporcionó el parámetro de línea de comandos /StartMinimized , la aplicación abre la ventana principal en un estado minimizado.
<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
Las aplicaciones del explorador XAML (XBAP) no pueden recuperar y procesar argumentos de línea de comandos porque se inician con la implementación de ClickOnce (vea Deploying a WPF Application (WPF)). Sin embargo, pueden recuperar y procesar parámetros de cadena de consulta de las direcciones URL que se usan para iniciarlos.
Comentarios
Una aplicación típica de Windows Presentation Foundation puede realizar una variedad de tareas de inicialización cuando se inicia, entre las que se incluyen:
Procesamiento de parámetros de línea de comandos.
Abrir la ventana principal.
Inicialización de recursos de ámbito de aplicación.
Inicialización de propiedades de ámbito de aplicación.
Puedes especificar mediante declaración los recursos de ventana principal y ámbito de aplicación mediante XAML (StartupUri y Resources, respectivamente). A veces, sin embargo, los recursos o la ventana principal de la aplicación solo se pueden determinar mediante programación en tiempo de ejecución. Además, las propiedades de ámbito de aplicación y los parámetros de la línea de comandos solo se pueden usar mediante programación. La inicialización mediante programación se puede realizar mediante el control del Startup evento, incluido lo siguiente:
Adquiera y procese parámetros de línea de comandos, que están disponibles en la propiedad de la ArgsStartupEventArgs clase que se pasa al controlador de Startup eventos.
Inicialice los recursos de ámbito de aplicación mediante la Resources propiedad .
Inicialice las propiedades del ámbito de aplicación mediante la Properties propiedad .
Cree una instancia y muestre una (o más) ventanas.
Nota:
Los parámetros de la línea de comandos también se pueden adquirir llamando al método estático GetCommandLineArgs del Environment objeto . Sin embargo, GetCommandLineArgs requiere plena confianza para ejecutarse.
Si estableces StartupUri con XAML, la ventana principal que se crea no está disponible desde la MainWindow propiedad o la Windows propiedad del Application objeto hasta después de procesar el Startup evento. Si necesita acceso a la ventana principal durante el inicio, debe crear manualmente un nuevo objeto de ventana desde el Startup controlador de eventos.
Nota:
Si la aplicación usa CredentialPolicy para especificar una directiva de credenciales, debe establecer CredentialPolicy después Startup de que se genere; de lo contrario, WPF la establece en una directiva interna predeterminada directamente después de que se haya generado el Startup evento.
Los argumentos de la línea de comandos que se pasan al Startup controlador de eventos no son los mismos que los parámetros de cadena de consulta url que se pasan a una aplicación de explorador XAML (XBAP).
