Application.Startup Evento

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

Se produce cuando se llama al método Run() del objeto 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 de evento

StartupEventHandler

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 (XBAPs) no pueden recuperar ni procesar argumentos de línea de comandos porque se inician con la implementación de ClickOnce (consulte Deploying a WPF Application (WPF)). En cambio, pueden recuperar y procesar los parámetros de las cadenas de consulta de las direcciones URL que se usan para iniciarlas.

Comentarios

Una aplicación de Windows Presentation Foundation típica 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 del á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 Args propiedad de la StartupEventArgs clase que se pasa al Startup controlador de eventos.

• Inicialice los recursos de ámbito de aplicación mediante la Resources propiedad .

• Inicialice las propiedades de ámbito de aplicación mediante la Properties propiedad .

• Cree una instancia y muestre una (o varias) 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 de dirección URL que se pasan a una aplicación del explorador XAML (XBAP).

Consulte también

• OnStartup(StartupEventArgs)
• Exit