Application.Run Método

Definición

Inicia una aplicación para Windows Presentation Foundation.Starts a Windows Presentation Foundation application.

Sobrecargas

Run()

Inicia una aplicación para Windows Presentation Foundation.Starts a Windows Presentation Foundation application.

Run(Window)

Inicie una aplicación de Windows Presentation Foundation y abre la ventana especificada.Starts a Windows Presentation Foundation application and opens the specified window.

Run()

Inicia una aplicación para 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

Devoluciones

Código de salida Int32 que se devuelve al sistema cuando la aplicación se cierra.The Int32 application exit code that is returned to the operating system when the application shuts down. De forma predeterminada, el valor del código de salida es 0.By default, the exit code value is 0.

Excepciones

Se llama al método Run() desde una aplicación hospedada en el explorador (por ejemplo, una Aplicación del explorador XAML (XBAP)XAML browser application (XBAP)).Run() is called from a browser-hosted application (for example, an Aplicación del explorador XAML (XBAP)XAML browser application (XBAP)).

Ejemplos

En el ejemplo siguiente se muestra una aplicación que utiliza una Application personalizada y, por consiguiente, debe llamar explícitamente a 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

Comentarios

se llama a Run para iniciar una aplicación WPFWPF.Run is called to start a WPFWPF application. Si define el Application mediante marcado, o marcado y código subyacente, se llamará implícitamente a Run.If you define your Application using markup, or markup and code-behind, Run will be called implicitly. Sin embargo, si define el Application mediante código, deberá llamar explícitamente a Run.However, if you define your Application using code, you will need to explicitly call Run.

Cuando se llama a Run, Application asocia una nueva instancia de Dispatcher al subproceso de la interfaz de usuario.When Run is called, Application attaches a new Dispatcher instance to the UI thread. A continuación, se llama al método Run del objeto Dispatcher, que inicia un bombeo de mensajes para procesar los mensajes de Windows.Next, the Dispatcher object's Run method is called, which starts a message pump to process windows messages. Por último, el objeto Dispatcher llama al método OnStartup del objeto Application para generar el evento Startup.Finally, the Dispatcher object calls the Application object's the OnStartup method to raise the Startup event. Por consiguiente, el modelo de ejecución de la aplicación se ha establecido en el momento en que se controla Startup, momento en el que se considera que la aplicación está en ejecución.Consequently, the application execution model has been established by the time you handle Startup, at which point the application is considered to be running.

Una aplicación deja de ejecutarse cuando se llama a Shutdown; el valor de la propiedad ShutdownMode determina cuándo se llama a Shutdown, y si se produce automáticamente o si es necesario llamarlo explícitamente.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.

solo se puede llamar a Run desde el subproceso que crea el objeto Application.Run can be called only from the thread that creates the Application object. Además, no se puede llamar a Run desde un XBAPXBAP.Also, Run cannot be called from a XBAPXBAP.

Consulte también:

Run(Window)

Inicie una aplicación de Windows Presentation Foundation y abre la ventana especificada.Starts a Windows Presentation Foundation application and opens the specified 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

Parámetros

window
Window

Window que se abre automáticamente cuando se inicia una aplicación.A Window that opens automatically when an application starts.

Devoluciones

Código de salida Int32 que se devuelve al sistema cuando la aplicación se cierra.The Int32 application exit code that is returned to the operating system when the application shuts down. De forma predeterminada, el valor del código de salida es 0.By default, the exit code value is 0.

Atributos

Excepciones

Se llama al método Run() desde una aplicación hospedada en el explorador (por ejemplo, una Aplicación del explorador XAML (XBAP)XAML browser application (XBAP)).Run() is called from a browser-hosted application (for example, an Aplicación del explorador XAML (XBAP)XAML browser application (XBAP)).

Ejemplos

En el ejemplo siguiente se muestra una aplicación con un método de punto de entrada estático creado manualmente que crea instancias de Application, antes de llamar a 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

Comentarios

Esta sobrecarga amplía el método Run para abrir la ventana especificada después de que se inicie la ejecución de una aplicación.This overload extends the Run method to open the specified window after an application starts running.

Si define un Application de código que abre una ventana cuando empieza a ejecutarse, se llama explícitamente a Run.If you define a code Application that opens a window when it starts running, you explicitly call Run.

Si crea el Application mediante marcado, o marcado y código subyacente, puede abrir automáticamente una ventana durante el uso de cualquiera de las técnicas siguientes: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:

  • Mediante declaración, estableciendo StartupUri.Declaratively, by setting StartupUri.

  • Mediante programación, mediante el control de Startup.Programmatically, by handling Startup.

Consulte también:

Se aplica a