Application.Run Метод

Определение

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

System.Windows

Сборка:

PresentationFramework.dll

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

Перегрузки

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

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)

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