Application.Run Метод

Определение

Пространство имен:

System.Windows

Сборка:

PresentationFramework.dll

Запускает приложение Windows Presentation Foundation.

Перегрузки

Run()	Запускает приложение Windows Presentation Foundation.
Run(Window)	Запускает приложение Windows Presentation Foundation с открытием указанного окна.

Run()

Запускает приложение Windows Presentation Foundation.

public:
 int Run();

public int Run ();

member this.Run : unit -> int

Public Function Run () As Integer

Возвращаемое значение

Int32

Код выхода Int32, возвращаемый приложением в операционную систему при завершении работы приложения. По умолчанию, код выхода равен 0.

Исключения

InvalidOperationException

Run() вызывается из приложения, размещенного в браузере (например, приложения браузера XAML (XBAP)).

Примеры

В следующем примере показано приложение, которое использует пользовательский Application и поэтому должно явно вызывать 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

Комментарии

Run вызывается для запуска приложения WPF. При определении используемой Application разметки или разметки и кода программной части Run будет вызываться неявно. Однако при определении Application кода с помощью необходимо явно вызвать Run.

При Run вызове Application метода подключает новый Dispatcher экземпляр к потоку пользовательского интерфейса. Dispatcher Затем вызывается метод объекта Run , который запускает конвейер сообщений для обработки сообщений Windows. Наконец, Dispatcher объект вызывает Application метод объекта для OnStartup вызова Startup события . Следовательно, модель выполнения приложения была установлена к моменту обработки Startup, в этот момент приложение считается запущенным.

Приложение останавливается при Shutdown вызове; значение ShutdownMode свойства определяет, когда Shutdown вызывается, и происходит ли это автоматически или необходимо явно вызвать его.

Run может вызываться только из потока, создающего Application объект . Кроме того, Run не может вызываться из XBAP.

См. также раздел

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

Run(Window)

Запускает приложение Windows Presentation Foundation с открытием указанного окна.

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

Параметры

window

Window

Window, открывающееся автоматически при запуске приложения.

Возвращаемое значение

Int32

Код выхода Int32, возвращаемый приложением в операционную систему при завершении работы приложения. По умолчанию, код выхода равен 0.

Исключения

InvalidOperationException

Run() вызывается из приложения, размещенного в браузере (например, приложения браузера XAML (XBAP)).

Примеры

В следующем примере показано приложение с созданным вручную методом статической точки входа, который создает Applicationэкземпляр перед вызовом 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

Комментарии

Эта перегрузка Run расширяет метод для открытия указанного окна после запуска приложения.

Если вы определяете код Application , открывающий окно при запуске, вы явным образом вызываете Run.

Если вы создаете Application с помощью разметки или разметки и кода программной части, вы можете автоматически открыть окно при использовании любого из следующих методов:

• Декларативно, задав .StartupUri

• Программным способом, обрабатывая Startup.

См. также раздел

• Shutdown()
• Shutdown(Int32)