Application.Run Metodo

Definizione

Avvia un'applicazione Windows Presentation Foundation.

Overload

Run(Window)

Avvia un'applicazione Windows Presentation Foundation e apre la finestra specificata.

Run()

Avvia un'applicazione Windows Presentation Foundation.

Run(Window)

Avvia un'applicazione Windows Presentation Foundation e apre la finestra specificata.

[System.Security.SecurityCritical]
public int Run (System.Windows.Window window);
public int Run (System.Windows.Window window);

Parametri

window
Window

Un Window che si apre automaticamente all'avvio di un'applicazione.

Restituisce

Codice di uscita dell'applicazione Int32 restituito al sistema operativo quando l'applicazione viene arrestata. Per impostazione predefinita, il valore del codice di uscita è 0.

Attributi

Eccezioni

Run() viene chiamato da un'applicazione ospitata dal browser, ad esempio un'applicazione browser XAML (XBAP).

Esempio

Nell'esempio seguente viene illustrata un'applicazione con un metodo punto di ingresso statico creato manualmente che crea un'istanza di Application, prima di chiamare Run.

using System;
using System.Windows;

namespace CSharp
{
    public class EntryPoint
    {
        // All WPF applications should execute on a single-threaded apartment (STA) thread
        [STAThread]
        public static void Main()
        {
            Application app = new Application();
            app.Run(new Window());
        }
    }
}

Commenti

Questo overload estende il metodo Run per aprire la finestra specificata dopo l'avvio dell'esecuzione di un'applicazione.

Se si definisce un codice Application che apre una finestra all'avvio dell'esecuzione, chiamare in modo esplicito Run.

Se si crea il Application usando markup o markup e code-behind, è possibile aprire automaticamente una finestra durante l'uso di una delle tecniche seguenti:

Vedi anche

Si applica a

.NET Framework 4.8.1 e altre versioni
Prodotto Versioni
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Run()

Avvia un'applicazione Windows Presentation Foundation.

public int Run ();

Restituisce

Codice di uscita dell'applicazione Int32 restituito al sistema operativo quando l'applicazione viene arrestata. Per impostazione predefinita, il valore del codice di uscita è 0.

Eccezioni

Run() viene chiamato da un'applicazione ospitata dal browser, ad esempio un'applicazione browser XAML (XBAP).

Esempio

Nell'esempio seguente viene illustrata un'applicazione che usa un Application personalizzato e deve quindi chiamare in modo esplicito Run.

using System;
using System.Windows;

namespace CSharp
{
    public class EntryPoint1
    {
        // All WPF applications should execute on a single-threaded apartment (STA) thread
        [STAThread]
        public static void Main()
        {
            CustomApplication app = new CustomApplication();
            app.Run();
        }
    }

    public class CustomApplication : Application
    {
        protected override void OnStartup(StartupEventArgs e)
        {
            base.OnStartup(e);

            Window window = new Window();
            window.Show();
        }
    }
}

Commenti

Run viene chiamato per avviare un'applicazione WPF. Se si definiscono i Application usando markup o markup e code-behind, Run verrà chiamato in modo implicito. Tuttavia, se si definisce il Application usando il codice, sarà necessario chiamare in modo esplicito Run.

Quando viene chiamato Run, Application collega una nuova istanza di Dispatcher al thread dell'interfaccia utente. Viene quindi chiamato il metodo Run dell'oggetto Dispatcher, che avvia un message pump per elaborare i messaggi di Windows. Infine, l'oggetto Dispatcher chiama il metodo OnStartup dell'oggetto Application per generare l'evento Startup. Di conseguenza, il modello di esecuzione dell'applicazione è stato stabilito dal momento in cui si gestisce Startup, a questo punto l'applicazione viene considerata in esecuzione.

Un'applicazione smette di funzionare quando viene chiamato Shutdown; il valore della proprietà ShutdownMode determina quando viene chiamato Shutdown e se si verifica automaticamente o se è necessario chiamarlo in modo esplicito.

Run può essere chiamato solo dal thread che crea l'oggetto Application. Inoltre, non è possibile chiamare Run da un XBAP.

Vedi anche

Si applica a

.NET Framework 4.8.1 e altre versioni
Prodotto Versioni
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9