Application.Run Metoda

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Uruchamia aplikację Windows Presentation Foundation.

Przeciążenia

Nazwa	Opis
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

Element Window , który jest otwierany automatycznie po uruchomieniu aplikacji.

Zwraca

Int32

Int32 Kod zakończenia aplikacji, 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 Applicationmetody , przed wywołaniem metody 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 metodę Run.

Jeśli tworzysz Application znaczniki lub znaczniki i kod za pomocą kodu, możesz automatycznie otworzyć okno przy użyciu jednej z następujących technik:

• Deklaratywnie, ustawiając wartość StartupUri.

• Programowo, obsługując Startuppolecenie .

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

Int32 Kod zakończenia aplikacji, 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 elementu i w związku z tym musi jawnie wywołać metodę 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 użycie znaczników lub znaczników i kod-behind, Run zostanie wywołana niejawnie. Jeśli jednak zdefiniujesz kod Application przy użyciu kodu, musisz jawnie wywołać metodę Run.

Po Run wywołaniu Application program dołącza nowe Dispatcher wystąpienie do wątku interfejsu użytkownika. Dispatcher Następnie wywoływana Run jest metoda obiektu, która uruchamia pompę komunikatów w celu przetwarzania komunikatów okien. Dispatcher Na koniec obiekt wywołuje Application metodę OnStartup obiektu w celu wywołania Startup zdarzenia. 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ć, gdy Shutdown jest wywoływana; wartość ShutdownMode właściwości określa, kiedy Shutdown jest wywoływana, i czy odbywa się automatycznie, czy trzeba jawnie ją wywołać.

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

Zobacz też

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