Application.Run Metodo

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationFramework.dll

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.

public:
 int Run(System::Windows::Window ^ window);

public int Run (System.Windows.Window window);

member this.Run : System.Windows.Window -> int

Public Function Run (window As Window) As Integer

Parametri

window

Window

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

Restituisce

Int32

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

InvalidOperationException

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());
        }
    }
}

Imports System.Windows

Namespace VisualBasic
    Public Class EntryPoint
        ' All WPF applications should execute on a single-threaded apartment (STA) thread
        <STAThread()>
              Public Shared Sub Main()
            Dim app As New Application()
            app.Run(New Window())
        End Sub
    End Class
End Namespace

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:

• Impostando in modo dichiarativo StartupUri.

• A livello di codice, gestendo Startup.

Vedi anche

• Shutdown()
• Shutdown(Int32)

Run()

Avvia un'applicazione Windows Presentation Foundation.

public:
 int Run();

public int Run ();

member this.Run : unit -> int

Public Function Run () As Integer

Restituisce

Int32

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

InvalidOperationException

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();
        }
    }
}

Imports System.Windows

Namespace VisualBasic
    Public Class EntryPoint
        ' All WPF applications should execute on a single-threaded apartment (STA) thread
        <STAThread()>
              Public Shared Sub Main()
            Dim app As New CustomApplication()
            app.Run()
        End Sub
    End Class

    Public Class CustomApplication
        Inherits Application
        Protected Overrides Sub OnStartup(ByVal e As StartupEventArgs)
            MyBase.OnStartup(e)

            Dim window As New Window()
            window.Show()
        End Sub
    End Class
End Namespace

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

• Run(Window)
• Shutdown(Int32)
• Exit