Application.Run Método

Definição

Espaço de Nomes:
System.Windows
Assemblagem:
PresentationFramework.dll

Inicia uma aplicação Windows Presentation Foundation.

Sobrecargas

Name Description
Run()

Inicia uma aplicação Windows Presentation Foundation.
Run(Window)

Inicia uma aplicação Windows Presentation Foundation e abre a janela especificada.

Run()

Inicia uma aplicação Windows Presentation Foundation.

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

Devoluções

Int32

O Int32 código de saída da aplicação que é devolvido ao sistema operativo quando a aplicação é desligada. Por defeito, o valor do código de saída é 0.

Exceções

InvalidOperationException

Run() é chamada a partir de uma aplicação alojada no navegador (por exemplo, uma aplicação de navegador XAML (XBAP)).

Exemplos

O exemplo seguinte mostra uma aplicação que utiliza um personalizado Application e, por isso, deve chamar Runexplicitamente .

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

Observações

Run é chamado para iniciar uma candidatura WPF. Se definires, o teu Application uso de marcação, ou marcação e code-behind, Run será chamado implicitamente. No entanto, se definires o teu Application usando código, terás de chamar Runexplicitamente .

Quando Run é chamado, Application anexa uma nova Dispatcher instância ao thread da interface. De seguida, é chamado o Dispatcher método do Run objeto, que inicia uma mensagem pump para processar mensagens do Windows. Finalmente, o Dispatcher objeto chama aos Application objetos o OnStartup método para levantar o Startup evento. Consequentemente, o modelo de execução da aplicação já foi estabelecido no momento em que se trata Startupde , momento em que a aplicação é considerada a correr.

Uma aplicação para de correr quando Shutdown é chamada; o valor da ShutdownMode propriedade determina quando Shutdown é chamada e se acontece automaticamente ou se é necessário chamá-la explicitamente.

Run pode ser chamado apenas a partir do fio que cria o Application objeto. Além disso, Run não pode ser chamado a partir de um XBAP.

Ver também

Aplica-se a

Run(Window)

Inicia uma aplicação Windows Presentation Foundation e abre a janela especificada.

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

Parâmetros

window
Window

A Window que abre automaticamente quando uma candidatura começa.

Devoluções

Int32

O Int32 código de saída da aplicação que é devolvido ao sistema operativo quando a aplicação é desligada. Por defeito, o valor do código de saída é 0.

Atributos
SecurityCriticalAttribute

Exceções

InvalidOperationException

Run() é chamada a partir de uma aplicação alojada no navegador (por exemplo, uma aplicação de navegador XAML (XBAP)).

Exemplos

O exemplo seguinte mostra uma aplicação com um método de ponto de entrada estático criado manualmente que instancia Application, antes de chamar 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

Observações

Esta sobrecarga prolonga o Run método para abrir a janela especificada após o início da execução da aplicação.

Se defines um código Application que abre uma janela quando começa a correr, chamas Runexplicitamente .

Se criar o seu Application usando marcação, ou marcação e code-behind, pode abrir automaticamente uma janela durante a utilização de qualquer uma das seguintes técnicas:

Ver também

Aplica-se a