Application.Run Metoda

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Uruchamia aplikację Windows Presentation Foundation.

Przeciążenia

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

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 elementu Application i dlatego 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, aby uruchomić aplikację WPF. Jeśli zdefiniujesz użycie Application znaczników lub znaczniki i kod-behind, Run zostanie wywołana niejawnie. Jeśli jednak zdefiniujesz kod Application przy użyciu, musisz jawnie wywołać metodę Run.

Po Run wywołaniu Application 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 metodę Application obiektu OnStartup w celu wywołania Startup zdarzenia. W związku z tym model wykonywania aplikacji został ustanowiony przez czas obsługi Startupmetody , 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ę to automatycznie, czy trzeba ją jawnie wywołać.

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

Zobacz też

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

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 zostanie otwarty 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 znaczniki Application przy użyciu znaczników lub znaczniki i kod-behind, możesz automatycznie otworzyć okno podczas korzystania z jednej z następujących technik:

• Deklaratywnie, ustawiając wartość StartupUri.

• Programowo, obsługując metodę Startup.

Zobacz też

• Shutdown()
• Shutdown(Int32)