Application.Run Method (Window) (System.Windows)

Run Method (Window)

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

Application..::.Run Method (Window)

Starts a Windows Presentation Foundation (WPF) application and opens the specified window.

Namespace: System.Windows
Assembly: PresentationFramework (in PresentationFramework.dll)

Syntax

Visual Basic (Declaration)

Public Function Run ( _
    window As Window _
) As Integer

Visual Basic (Usage)

Dim instance As Application
Dim window As Window
Dim returnValue As Integer

returnValue = instance.Run(window)

public int Run(
    Window window
)

Visual C++

public:
int Run(
    Window^ window
)

JScript

public function Run(
    window : Window
) : int

XAML

You cannot use methods in XAML.

Parameters

window: Type: System.Windows..::.Window
A Window that opens automatically when an application starts.

Return Value

Type: System..::.Int32
The Int32 application exit code that is returned to the operating system when the application shuts down. By default, the exit code value is 0.

Exceptions

Exception	Condition
InvalidOperationException	Run is called from a browser-hosted application (for example, an XAML browser application (XBAP)).

Remarks

This overload extends the Run method to open the specified window after an application starts running.

If you define a code Application that opens a window when it starts running, you explicitly call Run.

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:

Declaratively, by setting StartupUri.
Programmatically, by handling Startup.

Examples

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

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0

Reference

Application Class

Application Members

Run Overload

System.Windows Namespace

Shutdown