Application.Run Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Запускает приложение 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, возвращаемый приложением в операционную систему при завершении работы приложения. По умолчанию, код выхода равен 0.
Исключения
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)
Запускает приложение Windows Presentation Foundation с открытием указанного окна.
public:
int Run(System::Windows::Window ^ window);
[System.Security.SecurityCritical]
public int Run (System.Windows.Window window);
public int Run (System.Windows.Window window);
[<System.Security.SecurityCritical>]
member this.Run : System.Windows.Window -> int
member this.Run : System.Windows.Window -> int
Public Function Run (window As Window) As Integer
Параметры
Возвращаемое значение
Код выхода Int32, возвращаемый приложением в операционную систему при завершении работы приложения. По умолчанию, код выхода равен 0.
- Атрибуты
Исключения
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.
См. также раздел
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по