windows-networking.md

uid
Uno.Features.WNetworking

Networking

Tip

This article covers Uno-specific information for the Windows.Networking namespace. For a full description of the feature and instructions on using it, see Windows.Networking Namespace.

• The Windows.Networking namespace provides classes for accessing and managing network connections from your app.

Supported features

Feature	Windows	Android	iOS	Web (WASM)	macOS	Linux (Skia)	Win 7 (Skia)
GetInternetConnectionProfile	✔	✔	✔	✔	✔	✔	✔
NetworkStatusChanged	✔	✔	✔	✔	✔	✔	✔

Checking Network Connectivity in Uno

For more detailed guidance on network connectivity, watch our video tutorial:

[!Video https://www.youtube-nocookie.com/embed/sK9IbkBAXIo]

Platform-specific

Android

Android can recognize all values of NetworkConnectivityLevel. iOS, macOS, and WASM return either None or InternetAccess.

The android.permission.ACCESS_NETWORK_STATE permission is required. It can be added to the application manifest or with the following attribute in the Android platform head:

[assembly: UsesPermission("android.permission.ACCESS_NETWORK_STATE")]

iOS/macOS reachability host name

On iOS and macOS, an actual 'ping' request is necessary to verify internet connectivity. The default domain that is checked is www.example.com, but you can change this to be any other domain by setting the WinRTFeatureConfiguration.NetworkInformation.ReachabilityHostname property.

Example

Checking for internet connectivity

You can use the following snippet to check for internet connectivity level in a cross-platform manner:

var profile = NetworkInformation.GetInternetConnectionProfile();
if (profile == null)
{
    // No connection
}
else
{
    var level = profile.GetNetworkConnectivityLevel();
    // level is a value of NetworkConnectivityLevel enum
}

Observing changes in connectivity

You can use the following snippet to observe changes in connectivity:

NetworkInformation.NetworkStatusChanged += NetworkInformation_NetworkStatusChanged;

private void NetworkInformation_NetworkStatusChanged(object sender)
{
    // Your implementation here
}

Unsubscribing from the changes

NetworkInformation.NetworkStatusChanged -= NetworkInformation_NetworkStatusChanged;