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.