• Article

Application.IsRunningOutOfBrowser Property

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

Gets a value that indicates whether the application was launched from the out-of-browser state.

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

Syntax

'Declaration
Public ReadOnly Property IsRunningOutOfBrowser As Boolean

public bool IsRunningOutOfBrowser { get; }

Property Value

Type: System.Boolean
true if the application was launched from the out-of-browser state; false if the application was launched from within its host Web page.

Remarks

This property enables you to modify the behavior of your application when it runs outside the browser. For example, when running outside the browser, you can check for network availability and use alternate code paths to support offline mode.

For more information, see Out-of-Browser Support.

Examples

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

Private Sub App_InstallStateChanged(ByVal sender As Object, _
    ByVal e As EventArgs) Handles app.InstallStateChanged

    UpdateUI()

End Sub

Private Sub UpdateUI()

    UpdateNetworkIndicator()

    installButton.Visibility = If(
        app.InstallState = InstallState.NotInstalled,
        Visibility.Visible, Visibility.Collapsed)

    updateButton.Visibility = If(app.IsRunningOutOfBrowser,
        Visibility.Visible, Visibility.Collapsed)

    isRunningOutOfBrowserTextBlock.Text = _
        app.IsRunningOutOfBrowser.ToString()

    installStateTextBlock.Text = app.InstallState.ToString()

End Sub

Private Sub UpdateNetworkIndicator()

    If app.IsRunningOutOfBrowser Then
        networkIndicator.Visibility = Visibility.Visible
    Else
        networkIndicator.Visibility = Visibility.Collapsed
    End If



    Dim online As Boolean = NetworkInterface.GetIsNetworkAvailable()


    If online Then
        networkIndicator.Text = "ONLINE" 

        updateButton.Visibility = Visibility.Visible
    Else
        networkIndicator.Text = "OFFLINE"
        updateButton.Visibility = Visibility.Collapsed
    End If

End Sub

private void UpdateUI()
{
    UpdateNetworkIndicator();

    installButton.Visibility =
        app.InstallState == InstallState.NotInstalled ?
        Visibility.Visible : Visibility.Collapsed;

    updateButton.Visibility =
        app.IsRunningOutOfBrowser ? 
        Visibility.Visible : Visibility.Collapsed;

    isRunningOutOfBrowserTextBlock.Text = 
        app.IsRunningOutOfBrowser.ToString();

    installStateTextBlock.Text = app.InstallState.ToString();
}

private void UpdateNetworkIndicator()
{
    networkIndicator.Visibility =
        app.IsRunningOutOfBrowser ?
        Visibility.Visible : Visibility.Collapsed;

    bool online = NetworkInterface.GetIsNetworkAvailable();

    networkIndicator.Text = online ?
        "ONLINE" : "OFFLINE";

    updateButton.Visibility = online ?
        Visibility.Visible : Visibility.Collapsed;
}

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.