Application.Run Метод

Определение

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

Перегрузки

Run()

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

Run(Window)

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

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

Код выхода 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 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)

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

public:
 int Run(System::Windows::Window ^ 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
[<System.Security.SecurityCritical>]
member this.Run : System.Windows.Window -> int
Public Function Run (window As Window) As Integer

Параметры

window
Window

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

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

Int32

Код выхода 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 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.

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

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