Share via

RoamingStates Enum

Definition

Namespace:
Windows.Networking.Connectivity
Edit

Defines the roaming states.

This enumeration supports a bitwise combination of its member values.

public enum class RoamingStates
/// [System.Flags]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class RoamingStates
[System.Flags]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum RoamingStates
var value = Windows.Networking.Connectivity.RoamingStates.none
Public Enum RoamingStates
Inheritance
Enum
RoamingStates
Attributes
FlagsAttribute ContractVersionAttribute

Windows requirements

Device family
Windows 10 (introduced in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v1.0)

Fields

Name Value Description
None 0

No roaming information.
NotRoaming 1

The connection is not currently roaming.
Roaming 2

The connection is currently roaming.

Examples

Skip non-essential background sync while roaming (C#):

using Windows.Networking.Connectivity;

var profile = NetworkInformation.GetInternetConnectionProfile();
var cost = profile?.GetConnectionCost();
if (cost?.Roaming == true)
{
    // App-specific: defer scheduled uploads or prompt the user.
}

Remarks

RoamingStates values appear on ConnectionCost.Roaming. The flag indicates whether the current connection is incurring roaming fees. Treat Roaming as a warning signal rather than an automatic off switch; a user might consciously continue foreground work even when roaming.

Apps should pair the roaming state with NetworkCostType and the various ConnectionCost limit indicators to decide how aggressively to sync data.

Applies to