Application.Run Método

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

Inicia una aplicación de Windows Presentation Foundation.

Sobrecargas

Run(Window)	Inicia una aplicación de Windows Presentation Foundation y abre la ventana especificada.
Run()	Inicia una aplicación de Windows Presentation Foundation.

Run(Window)

Inicia una aplicación de Windows Presentation Foundation y abre la ventana 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

Un Window que se abre automáticamente cuando se inicia una aplicación.

Devoluciones

Int32

El Int32 código de salida de la aplicación que se devuelve al sistema operativo cuando se cierra la aplicación. De forma predeterminada, el valor del código de salida es 0.

Excepciones

InvalidOperationException

Run() se llama desde una aplicación hospedada por el explorador (por ejemplo, una aplicación de explorador XAML (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.

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 extiende el método Run para abrir la ventana especificada después de que una aplicación empiece a ejecutarse.

Si define un código Application que abre una ventana cuando comienza a ejecutarse, llame explícitamente a 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:

• Mediante declaración, estableciendo StartupUri.

• Mediante programación, controlando Startup.

Consulte también

• Shutdown()
• Shutdown(Int32)

Run()

Inicia una aplicación de Windows Presentation Foundation.

public:
 int Run();

public int Run ();

member this.Run : unit -> int

Public Function Run () As Integer

Devoluciones

Int32

El Int32 código de salida de la aplicación que se devuelve al sistema operativo cuando se cierra la aplicación. De forma predeterminada, el valor del código de salida es 0.

Excepciones

InvalidOperationException

Run() se llama desde una aplicación hospedada por el explorador (por ejemplo, una aplicación de explorador XAML (XBAP)).

Ejemplos

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

Comentarios

se llama a Run para iniciar una aplicación WPF. Si define el Application mediante marcado o marcado y código subyacente, se llamará a Run implícitamente. Sin embargo, si define el Application mediante código, deberá llamar explícitamente a Run.

Cuando se llama a Run, Application adjunta una nueva instancia de Dispatcher al subproceso de interfaz de usuario. A continuación, se llama al método Run del objeto Dispatcher, que inicia una bomba de mensajes para procesar mensajes de ventanas. Por último, el objeto Dispatcher llama al objeto Application el método OnStartup para generar el evento Startup. Por lo tanto, el modelo de ejecución de la aplicación se ha establecido en el momento en que controla Startup, en cuyo momento se considera que la aplicación se está ejecutando.

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 necesita llamarlo explícitamente.

Run solo se puede llamar desde el subproceso que crea el objeto Application. Además, no se puede llamar a Run desde un XBAP.

Consulte también

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