Application.Run Método

Definição

Inicia um aplicativo do Windows Presentation Foundation.

Sobrecargas

Run(Window)

Inicia um aplicativo do Windows Presentation Foundation e abre a janela especificada.

Run()

Inicia um aplicativo do Windows Presentation Foundation.

Run(Window)

Inicia um aplicativo do 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);
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

Parâmetros

window
Window

Um Window que é aberto automaticamente quando um aplicativo é iniciado.

Retornos

O código de saída do aplicativo Int32 que é retornado ao sistema operacional quando o aplicativo é desligado. Por padrão, o valor do código de saída é 0.

Atributos

Exceções

Run() é chamado de um aplicativo hospedado pelo navegador (por exemplo, um aplicativo do navegador XAML (XBAP)).

Exemplos

O exemplo a seguir mostra um aplicativo com um método de ponto de entrada estático criado manualmente que cria uma instância 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

Comentários

Essa sobrecarga estende o método Run para abrir a janela especificada depois que um aplicativo começa a ser executado.

Se você definir um código Application que abre uma janela quando ele começa a ser executado, você chama explicitamente Run.

Se você criar seu Application usando marcação, marcação e code-behind, você poderá abrir automaticamente uma janela durante o uso de qualquer uma das seguintes técnicas:

Confira também

Aplica-se a

Run()

Inicia um aplicativo do Windows Presentation Foundation.

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

Retornos

O código de saída do aplicativo Int32 que é retornado ao sistema operacional quando o aplicativo é desligado. Por padrão, o valor do código de saída é 0.

Exceções

Run() é chamado de um aplicativo hospedado pelo navegador (por exemplo, um aplicativo do navegador XAML (XBAP)).

Exemplos

O exemplo a seguir mostra um aplicativo que usa um Application personalizado e, portanto, deve chamar explicitamente 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

Comentários

Run é chamado para iniciar um aplicativo WPF. Se você definir seu Application usando marcação ou marcação e code-behind, Run será chamado implicitamente. No entanto, se você definir seu Application usando código, precisará chamar explicitamente Run.

Quando Run é chamado, Application anexa uma nova instância Dispatcher ao thread da interface do usuário. Em seguida, o método Run do objeto Dispatcher é chamado, que inicia uma bomba de mensagem para processar mensagens do Windows. Por fim, o objeto Dispatcher chama o método OnStartup do objeto Application para gerar o evento Startup. Consequentemente, o modelo de execução do aplicativo foi estabelecido no momento em que você lida com Startup, momento em que o aplicativo é considerado em execução.

Um aplicativo para de ser executado quando Shutdown é chamado; o valor da propriedade ShutdownMode determina quando Shutdown é chamado e se ele acontece automaticamente ou você precisa chamá-la explicitamente.

Run pode ser chamado somente do thread que cria o objeto Application. Além disso, Run não pode ser chamado de um XBAP.

Confira também

Aplica-se a