Class ConnectionManager

Definition

Namespace:
Tizen.Network.Connection
Assembly:
Tizen.Network.Connection.dll

This is the ConnectionManager class. It provides functions to manage data connections.

public static class ConnectionManager
Inheritance
object
ConnectionManager

Properties

View Source

BluetoothState

The state of the Bluetooth connection.

Declaration
public static ConnectionState BluetoothState { get; }
Property Value
Type Description
ConnectionState

Bluetooth connection state.
View Source

CellularState

The state of the cellular connection.

Declaration
public static CellularState CellularState { get; }
Property Value
Type Description
CellularState

Cellular network state.
View Source

CurrentConnection

The type and state of the current profile for data connection.

Declaration
public static ConnectionItem CurrentConnection { get; }
Property Value
Type Description
ConnectionItem

Instance of ConnectionItem.
View Source

EthernetCableState

Checks if the ethernet cable is attached or not.

Declaration
public static EthernetCableState EthernetCableState { get; }
Property Value
Type Description
EthernetCableState

Ethernet cable state.
View Source

EthernetState

The Ethernet connection state.

Declaration
public static ConnectionState EthernetState { get; }
Property Value
Type Description
ConnectionState

Ethernet connection state.
View Source

WiFiState

The state of the Wi-Fi connection.

Declaration
public static ConnectionState WiFiState { get; }
Property Value
Type Description
ConnectionState

WiFi connection state.

Methods

View Source

AddRoute(AddressFamily, string, IPAddress, IPAddress)

Adds a route to the routing table.

Declaration
public static void AddRoute(AddressFamily family, string interfaceName, IPAddress hostAddress, IPAddress gateway)
Parameters
Type Name Description
AddressFamily family

The address family.
string interfaceName

The name of the network interface.
System.Net.IPAddress hostAddress

The IP address of the host.
System.Net.IPAddress gateway

The gateway address.
Exceptions
Type Condition
System.NotSupportedException

Thrown when a feature is not supported.
System.UnauthorizedAccessException

Thrown when a permission is denied.
System.ArgumentException

Thrown when a value is an invalid parameter.
System.ArgumentNullException

Thrown when an interfaceName or a hostAddress or a gateway is null.
System.OutOfMemoryException

Thrown when memory is not enough to continue execution.
System.InvalidOperationException

Thrown when a connection instance is invalid or when a method fails due to an invalid operation.
View Source

CreateCellularProfile(ConnectionProfileType, string)

Creates a cellular profile handle.

Declaration
public static CellularProfile CreateCellularProfile(ConnectionProfileType type, string keyword)
Parameters
Type Name Description
ConnectionProfileType type

The type of profile. Cellular profile type is supported.
string keyword

The keyword included in profile name.
Returns
Type Description
CellularProfile

CellularProfile object.
Exceptions
Type Condition
System.NotSupportedException

Thrown when a feature is not supported.
System.UnauthorizedAccessException

Thrown when a permission is denied.
System.ArgumentException

Thrown when a value is an invalid parameter.
System.ArgumentNullException

Thrown when a keyword value is null.
System.InvalidOperationException

Thrown when a method fails due to invalid operation.
View Source

GetAllIPv6Addresses(ConnectionType)

Gets all the IPv6 addresses of the current connection.

Declaration
public static IEnumerable<IPAddress> GetAllIPv6Addresses(ConnectionType type)
Parameters
Type Name Description
ConnectionType type

The type of current network connection.
Returns
Type Description
System.Collections.Generic.IEnumerable<T><System.Net.IPAddress>

A list of IPv6 addresses of the connection.
Exceptions
Type Condition
System.NotSupportedException

Thrown when a feature is not supported.
System.UnauthorizedAccessException

Thrown when a permission is denied.
System.ArgumentException

Thrown when a value is an invalid parameter.
System.OutOfMemoryException

Thrown when memory is not enough to continue execution.
System.InvalidOperationException

Thrown when a connection instance is invalid or when a method fails due to an invalid operation.
View Source

GetIPAddress(AddressFamily)

Gets the IP address of the current connection.

Declaration
public static IPAddress GetIPAddress(AddressFamily family)
Parameters
Type Name Description
AddressFamily family

The address family.
Returns
Type Description
System.Net.IPAddress

IP address of the connection (global address in case of IPv6).
Exceptions
Type Condition
System.NotSupportedException

Thrown when a feature is not supported.
System.UnauthorizedAccessException

Thrown when a permission is denied.
System.ArgumentException

Thrown when a value is an invalid parameter.
System.OutOfMemoryException

Thrown when memory is not enough to continue execution.
System.InvalidOperationException

Thrown when a connection instance is invalid or when a method fails due to an invalid operation.
View Source

GetMacAddress(ConnectionType)

Gets the MAC address of the Wi-Fi or ethernet.

Declaration
public static string GetMacAddress(ConnectionType type)
Parameters
Type Name Description
ConnectionType type

The type of current network connection.
Returns
Type Description
string

MAC address of the Wi-Fi or ethernet.
Exceptions
Type Condition
System.NotSupportedException

Thrown when a feature is not supported.
System.UnauthorizedAccessException

Thrown when a permission is denied.
System.ArgumentException

Thrown when value is an invalid parameter.
System.OutOfMemoryException

Thrown when memory is not enough to continue execution.
System.InvalidOperationException

Thrown when a connection instance is invalid or when a method fails due to an invalid operation.
View Source

GetProxy(AddressFamily)

Gets the proxy address of the current connection.

Declaration
public static string GetProxy(AddressFamily family)
Parameters
Type Name Description
AddressFamily family

The address family.
Returns
Type Description
string

Proxy address of the connection.
Exceptions
Type Condition
System.NotSupportedException

Thrown when a feature is not supported.
System.UnauthorizedAccessException

Thrown when a permission is denied.
System.ArgumentException

Thrown when a value is an invalid parameter.
System.OutOfMemoryException

Thrown when memory is not enough to continue execution.
System.InvalidOperationException

Thrown when a connection instance is invalid or when a method fails due to an invalid operation.
View Source

GetStatistics(ConnectionType, StatisticsType)

Gets the statistics information.

Declaration
public static long GetStatistics(ConnectionType connectionType, StatisticsType statisticsType)
Parameters
Type Name Description
ConnectionType connectionType

The type of connection (only WiFi and Cellular are supported).
StatisticsType statisticsType

The type of statistics.
Returns
Type Description
long

The statistics information associated with statisticsType.
Exceptions
Type Condition
System.NotSupportedException

Thrown when a feature is not supported.
System.UnauthorizedAccessException

Thrown when a permission is denied.
System.ArgumentException

Thrown when value is an invalid parameter.
System.OutOfMemoryException

Thrown when memory is not enough to continue execution.
System.InvalidOperationException

Thrown when a connection instance is invalid or when a method fails due to invalid operation.
View Source

RemoveRoute(AddressFamily, string, IPAddress, IPAddress)

Removes a route from the routing table.

Declaration
public static void RemoveRoute(AddressFamily family, string interfaceName, IPAddress hostAddress, IPAddress gateway)
Parameters
Type Name Description
AddressFamily family

The address family.
string interfaceName

The name of network interface.
System.Net.IPAddress hostAddress

The IP address of the host.
System.Net.IPAddress gateway

The gateway address.
Exceptions
Type Condition
System.NotSupportedException

Thrown when a feature is not supported.
System.UnauthorizedAccessException

Thrown when a permission is denied.
System.ArgumentException

Thrown when a value is an invalid parameter.
System.ArgumentNullException

Thrown when an interfaceName or a hostAddress or a gateway is null.
System.OutOfMemoryException

Thrown when memory is not enough to continue execution.
System.InvalidOperationException

Thrown when a connection instance is invalid or when a method fails due to an invalid operation.
View Source

ResetStatistics(ConnectionType, StatisticsType)

Resets the statistics information.

Declaration
public static void ResetStatistics(ConnectionType connectionType, StatisticsType statisticsType)
Parameters
Type Name Description
ConnectionType connectionType

The type of connection (only WiFi and Cellular are supported).
StatisticsType statisticsType

The type of statistics.
Exceptions
Type Condition
System.NotSupportedException

Thrown when a feature is not supported.
System.UnauthorizedAccessException

Thrown when a permission is denied.
System.ArgumentException

Thrown when a value is an invalid parameter.
System.OutOfMemoryException

Thrown when memory is not enough to continue execution.
System.InvalidOperationException

Thrown when a connection instance is invalid or when a method fails due to an invalid operation.

Events

View Source

ConnectionTypeChanged

An event is called when the type of the current connection is changed.

Declaration
public static event EventHandler<ConnectionTypeEventArgs> ConnectionTypeChanged
Event Type
Type Description
System.EventHandler<TEventArgs><ConnectionTypeEventArgs>
Exceptions
Type Condition
System.NotSupportedException

Thrown when a feature is not supported.
System.UnauthorizedAccessException

Thrown when a permission is denied.
View Source

EthernetCableStateChanged

An event for the ethernet cable is plugged [in/out] event.

Declaration
public static event EventHandler<EthernetCableStateEventArgs> EthernetCableStateChanged
Event Type
Type Description
System.EventHandler<TEventArgs><EthernetCableStateEventArgs>
Exceptions
Type Condition
System.NotSupportedException

Thrown when a feature is not supported.
System.UnauthorizedAccessException

Thrown when a permission is denied.
View Source

IPAddressChanged

An event is called when the IP address is changed.

Declaration
public static event EventHandler<AddressEventArgs> IPAddressChanged
Event Type
Type Description
System.EventHandler<TEventArgs><AddressEventArgs>
Exceptions
Type Condition
System.NotSupportedException

Thrown when a feature is not supported.
System.UnauthorizedAccessException

Thrown when a permission is denied.
View Source

ProxyAddressChanged

An event is called when the proxy address is changed.

Declaration
public static event EventHandler<AddressEventArgs> ProxyAddressChanged
Event Type
Type Description
System.EventHandler<TEventArgs><AddressEventArgs>
Exceptions
Type Condition
System.NotSupportedException

Thrown when a feature is not supported.
System.UnauthorizedAccessException

Thrown when a permission is denied.