Application.Run Metoda

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Uruchamia aplikację Windows Presentation Foundation.

Przeciążenia

Run(Window)	Uruchamia aplikację Windows Presentation Foundation i otwiera określone okno.
Run()	Uruchamia aplikację Windows Presentation Foundation.

Run(Window)

Uruchamia aplikację Windows Presentation Foundation i otwiera określone 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, który zostanie otwarty automatycznie po uruchomieniu aplikacji.

Zwraca

Int32

Kod zakończenia aplikacji Int32, który jest zwracany do systemu operacyjnego po zamknięciu aplikacji. Domyślnie wartość kodu zakończenia to 0.

Wyjątki

InvalidOperationException

Run() jest wywoływana z aplikacji hostowanej w przeglądarce (na przykład aplikacji przeglądarki XAML (XBAP)).

Przykłady

W poniższym przykładzie pokazano aplikację z ręcznie utworzoną statyczną metodą punktu wejścia, która tworzy wystąpienie Application, przed wywołaniem 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

Uwagi

To przeciążenie rozszerza metodę Run, aby otworzyć określone okno po uruchomieniu aplikacji.

Jeśli zdefiniujesz kod Application, który otwiera okno po uruchomieniu, jawnie wywołasz Run.

Jeśli tworzysz Application przy użyciu znaczników lub znaczników i kodu w tle, możesz automatycznie otworzyć okno podczas korzystania z jednej z następujących technik:

• Deklaratywnie, ustawiając StartupUri.

• Programowo, obsługując Startup.

Zobacz też

• Shutdown()
• Shutdown(Int32)

Run()

Uruchamia aplikację Windows Presentation Foundation.

public:
 int Run();

public int Run ();

member this.Run : unit -> int

Public Function Run () As Integer

Zwraca

Int32

Kod zakończenia aplikacji Int32, który jest zwracany do systemu operacyjnego po zamknięciu aplikacji. Domyślnie wartość kodu zakończenia to 0.

Wyjątki

InvalidOperationException

Run() jest wywoływana z aplikacji hostowanej w przeglądarce (na przykład aplikacji przeglądarki XAML (XBAP)).

Przykłady

W poniższym przykładzie pokazano aplikację, która używa niestandardowego Application i dlatego musi jawnie wywołać 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

Uwagi

Run jest wywoływana w celu uruchomienia aplikacji WPF. Jeśli zdefiniujesz Application przy użyciu znaczników lub znaczników i kodu za pomocą kodu, Run będą wywoływane niejawnie. Jeśli jednak zdefiniujesz Application przy użyciu kodu, musisz jawnie wywołać Run.

Po wywołaniu RunApplication dołącza nowe wystąpienie Dispatcher do wątku interfejsu użytkownika. Następnie wywoływana jest metoda Run obiektu Dispatcher, która uruchamia pompę komunikatów w celu przetwarzania komunikatów okien. Na koniec obiekt Dispatcher wywołuje obiekt Application metodę OnStartup w celu wywołania zdarzenia Startup. W związku z tym model wykonywania aplikacji został ustanowiony przez czas obsługi Startup, w którym momencie aplikacja jest uważana za uruchomioną.

Aplikacja przestaje działać po wywołaniu Shutdown; wartość właściwości ShutdownMode określa, kiedy jest wywoływana Shutdown i czy ma ona miejsce automatycznie, czy też trzeba ją jawnie wywołać.

Run można wywołać tylko z wątku, który tworzy obiekt Application. Ponadto nie można wywołać Run z XBAP.

Zobacz też

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