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.

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

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

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

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

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