Application.Run Metoda

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationFramework.dll

Spustí aplikaci Windows Presentation Foundation.

Přetížení

Run(Window)	Spustí aplikaci Windows Presentation Foundation a otevře zadané okno.
Run()	Spustí aplikaci Windows Presentation Foundation.

Run(Window)

Spustí aplikaci Windows Presentation Foundation a otevře zadané okno.

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

Parametry

window

Window

Window, která se otevře automaticky při spuštění aplikace.

Návraty

Int32

Ukončovací kód aplikace Int32, který se vrátí do operačního systému, když se aplikace vypne. Ve výchozím nastavení je hodnota ukončovacího kódu 0.

Výjimky

InvalidOperationException

Run() se volá z aplikace hostované v prohlížeči (například z aplikace prohlížeče XAML (XBAP)).

Příklady

Následující příklad ukazuje aplikaci s ručně vytvořenou statickou metodou vstupního bodu, která vytvoří instanci Application, před voláním 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

Poznámky

Toto přetížení rozšiřuje Run metodu otevření zadaného okna po spuštění aplikace.

Pokud definujete kód Application, který při spuštění otevře okno, explicitně zavoláte Run.

Pokud vytvoříte Application pomocí značek nebo kódu a kódu, můžete automaticky otevřít okno během některé z následujících technik:

• Deklarativním nastavením StartupUri.

• Programově, zpracování Startup.

Viz také

• Shutdown()
• Shutdown(Int32)

Run()

Spustí aplikaci Windows Presentation Foundation.

public:
 int Run();

public int Run ();

member this.Run : unit -> int

Public Function Run () As Integer

Návraty

Int32

Ukončovací kód aplikace Int32, který se vrátí do operačního systému, když se aplikace vypne. Ve výchozím nastavení je hodnota ukončovacího kódu 0.

Výjimky

InvalidOperationException

Run() se volá z aplikace hostované v prohlížeči (například z aplikace prohlížeče XAML (XBAP)).

Příklady

Následující příklad ukazuje aplikaci, která používá vlastní Application a proto musí explicitně volat 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

Poznámky

Run je volána ke spuštění aplikace WPF. Pokud definujete Application pomocí značek nebo značek a kódu, Run se budou volat implicitně. Pokud však definujete Application pomocí kódu, budete muset explicitně volat Run.

Při zavolání RunApplication připojí k vláknu uživatelského rozhraní novou instanci Dispatcher. Dále je volána metoda Dispatcher objektu Run, která spustí pumpu zpráv pro zpracování zpráv oken. Nakonec Dispatcher objekt volá Application objektu OnStartup metoda pro vyvolání Startup události. V důsledku toho byl model spouštění aplikace vytvořen časem, který zpracováváte Startup, v tomto okamžiku se aplikace považuje za spuštěnou.

Aplikace přestane běžet, když je volána Shutdown; hodnota vlastnosti ShutdownMode určuje, kdy je volána Shutdown, a zda k ní dojde automaticky, nebo ji musíte explicitně volat.

Run lze volat pouze z vlákna, které vytváří objekt Application. Také Run nelze volat z XBAP.

Viz také

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