• Article

Application.RootVisual Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets or sets the main application UI.

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

Syntax

'Declaration
Public Property RootVisual As UIElement

public UIElement RootVisual { get; set; }

Property Value

Type: System.Windows.UIElement
A UIElement that is the main application UI.

Exceptions

Exception Condition
InvalidOperationException

When setting this property, the specified value is not an instance of a class that derives from UIElement.

Remarks

You can set the value of the RootVisual property only one time from code, although you get its value any number of times.

Examples

The following code example demonstrates how an application can use a Startup event handler to set the RootVisual property.

Partial Public Class App
    Inherits Application

    public Sub New()
        InitializeComponent()
    End Sub

    Private Sub Application_Startup(ByVal o As Object, _
        ByVal e As StartupEventArgs) Handles Me.Startup

        Me.RootVisual = New Page()

    End Sub


End Class

using System.Windows; // Application, StartupEventArgs

namespace SilverlightApplication
{
    public partial class App : Application
    {
        public App()
        {
            InitializeComponent();
        }

        private void Application_Startup(object sender, StartupEventArgs e)
        {
            // Specify the main application UI
            this.RootVisual = new Page();
        }
    }
}

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.