Application.Run Application.Run Application.Run Application.Run Method

Определение

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

Перегрузки

Run() Run() Run() Run()

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

Run(Window) Run(Window) Run(Window)

Запускает приложение Windows Presentation Foundation с открытием указанного окна.Starts a Windows Presentation Foundation application and opens the specified window.

Run() Run() Run() Run()

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

public:
 int Run();
public int Run ();
member this.Run : unit -> int
Public Function Run () As Integer

Возвраты

Код выхода Int32, возвращаемый приложением в операционную систему при завершении работы приложения.The Int32 application exit code that is returned to the operating system when the application shuts down. По умолчанию, код выхода равен 0.By default, the exit code value is 0.

Исключения

Run() вызывается из приложения-владельца браузера (например, Приложение обозревателя XAML (XBAP)XAML browser application (XBAP)).Run() is called from a browser-hosted application (for example, an Приложение обозревателя XAML (XBAP)XAML browser application (XBAP)).

Примеры

В следующем примере показано приложение, использующее пользовательский Application и поэтому явно должна вызывать Run.The following example shows an application that uses a custom Application and must therefore explicitly call 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()
        {
            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 Microsoft.VisualBasic
Imports System
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 вызывается для запуска WPFWPF приложения.Run is called to start a WPFWPF application. Если вы определяете вашей Application с помощью разметки, или разметки и кода программной части, Run будет вызываться неявно.If you define your Application using markup, or markup and code-behind, Run will be called implicitly. Тем не менее если определить ваш Application с помощью кода, необходимо явно вызывать Run.However, if you define your Application using code, you will need to explicitly call Run.

Когда Run вызове Application присоединяет новый Dispatcher экземпляра в поток пользовательского интерфейса.When Run is called, Application attaches a new Dispatcher instance to the UI thread. Далее, Dispatcher объекта Run вызывается метод, который запускает цикл обработки сообщений для обработки сообщений windows.Next, the Dispatcher object's Run method is called, which starts a message pump to process windows messages. Наконец Dispatcher вызывает Application объекта OnStartup метод для вызова Startup событий.Finally, the Dispatcher object calls the Application object's the OnStartup method to raise the Startup event. Следовательно, модель выполнения приложения был установлен обработки Startup, после чего приложение считается работать под управлением.Consequently, the application execution model has been established by the time you handle Startup, at which point the application is considered to be running.

Приложение перестает работать, если Shutdown вызывается; значение ShutdownMode определяется свойством Shutdown вызывается и это происходит автоматически, или вам нужно явно вызывать его.An application stops running when Shutdown is called; the value of the ShutdownMode property determines when Shutdown is called, and whether it happens automatically or you need to explicitly call it.

Run может вызываться только из потока, который создает Application объекта.Run can be called only from the thread that creates the Application object. Кроме того Run нельзя вызывать из XBAPXBAP.Also, Run cannot be called from a XBAPXBAP.

Дополнительно

Run(Window) Run(Window) Run(Window)

Запускает приложение Windows Presentation Foundation с открытием указанного окна.Starts a Windows Presentation Foundation application and opens the specified window.

public:
 int Run(System::Windows::Window ^ window);
[System.Security.SecurityCritical]
public int Run (System.Windows.Window window);
member this.Run : System.Windows.Window -> int

Параметры

window
Window Window Window Window

Window, открывающееся автоматически при запуске приложения.A Window that opens automatically when an application starts.

Возвраты

Код выхода Int32, возвращаемый приложением в операционную систему при завершении работы приложения.The Int32 application exit code that is returned to the operating system when the application shuts down. По умолчанию, код выхода равен 0.By default, the exit code value is 0.

Исключения

Run() вызывается из приложения-владельца браузера (например, Приложение обозревателя XAML (XBAP)XAML browser application (XBAP)).Run() is called from a browser-hosted application (for example, an Приложение обозревателя XAML (XBAP)XAML browser application (XBAP)).

Примеры

В следующем примере показано приложение с помощью метода статическую запись, созданная точка, создающий экземпляр Application, перед вызовом Run.The following example shows an application with a manually-created static entry point method that instantiates Application, before calling 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 Microsoft.VisualBasic
Imports System
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 метод для открытия указанного окна после запуска приложения.This overload extends the Run method to open the specified window after an application starts running.

Если задать код Application , открывает окно при запуске, явным образом вызвать Run.If you define a code Application that opens a window when it starts running, you explicitly call Run.

При создании вашей Application с использованием разметки, разметки и кода, вы можете автоматически открыть окно при использовании одной из следующих способов:If you create your Application using markup, or markup and code-behind, you can automatically open a window during using either of the following techniques:

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

  • Программно, путем обработки Startup.Programmatically, by handling Startup.

Дополнительно

Применяется к