Application.Run Método

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

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);

public int Run (System.Windows.Window window);

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

Int32

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

InvalidOperationException

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:

• Declarativamente, definindo StartupUri.

• Programaticamente, tratando Startup.

Confira também

• Shutdown()
• Shutdown(Int32)

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

Int32

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

InvalidOperationException

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

• Run(Window)
• Shutdown(Int32)
• Exit