• Article

Application.Install Method

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

Attempts to install the application so that it can run outside the browser.

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

Syntax

'Declaration
<SecuritySafeCriticalAttribute> _
Public Function Install As Boolean

[SecuritySafeCriticalAttribute]
public bool Install()

Return Value

Type: System.Boolean
true if the user gave consent to install the application or the application requires elevated trust; otherwise, false. See Remarks for more information.

Exceptions

Exception Condition
InvalidOperationException

The application is already installed.

-or-

The application is hosted at a URI with a scheme other than http, https, or file.

Remarks

This method works only from within an event handler for a user-initiated event, and only if the application manifest is correctly configured to enable out-of-browser support. If these conditions are not met, this method returns false and the install dialog box is not shown. If the application requires elevated trust, this method returns true before the install dialog box is shown.

Examples

The following code example demonstrates how to use this method. This example is part of a larger example available in How to: Implement Offline Support for Out-of-Browser Applications.

Private Sub installButton_Click(ByVal sender As Object, _
    ByVal e As RoutedEventArgs)

    Try
        app.Install()
    Catch ex As InvalidOperationException
        MessageBox.Show("The application is already installed.")
    End Try

End Sub

private void installButton_Click(object sender, RoutedEventArgs e)
{
    try
    {
        app.Install();
    }
    catch (InvalidOperationException)
    {
        MessageBox.Show("The application is already installed.");
    }
}

Version Information

Silverlight

Supported in: 5, 4, 3

Platforms

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