Class NetworkService

Provides network management services to manage and perform network-related operations.

Inheritance

object

ServiceFactoryEx<NetworkService, object, object, object, object, object, object, object, object, object>

ServiceFactoryEx<NetworkService>

NetworkService

Implements

IDisposable

INetworkService

Inherited Members

ServiceFactoryEx<NetworkService, object, object, object, object, object, object, object, object, object>.CreateServiceFactory(Action<IHostBuilder>)

ServiceFactoryEx<NetworkService, object, object, object, object, object, object, object, object, object>.CreateServiceFactory(Action<IServiceCollection>)

ServiceFactoryEx<NetworkService, object, object, object, object, object, object, object, object, object>.CreateServiceFactory(Action<IServiceCollection>, Action<ILoggingBuilder>, Action<IHostBuilder>)

ServiceFactoryEx<NetworkService, object, object, object, object, object, object, object, object, object>.CreateServiceFactory()

ServiceFactoryEx<NetworkService, object, object, object, object, object, object, object, object, object>.CreateServiceFactory(LogLevel)

ServiceFactoryEx<NetworkService, object, object, object, object, object, object, object, object, object>.Dispose()

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Namespace: Coree.NETStandard.Services.NetworkManagement

Assembly: Coree.NETStandard.dll

Syntax

public class NetworkService : ServiceFactoryEx<NetworkService>, IDisposable, INetworkService

Constructors

NetworkService(ILogger<NetworkService>?)

Initializes a new instance of the NetworkService with optional logging.

Declaration

public NetworkService(ILogger<NetworkService>? logger = null)

Parameters

Type	Name	Description
ILogger<NetworkService>	logger	The logger used to log service activity and errors, if any.

Remarks

Logging can help with diagnosing issues in network operations and service management. If no logger is provided, the service will operate without logging.

Methods

GetNetworkInterfaceDetails()

Retrieves detailed information about network interfaces on the local machine, including IP address details and DNS suffixes.

Declaration

public List<NetworkService.NetworkInterfaceDetail> GetNetworkInterfaceDetails()

Returns

Type	Description
List<NetworkService.NetworkInterfaceDetail>	A list of NetworkService.NetworkInterfaceDetail objects, each containing details about a single network interface, such as associated IP addresses and their properties.

Remarks

This method identifies all network interfaces available on the local machine and gathers extensive details such as IP addresses, subnet masks, DNS eligibility, and DNS suffixes. It handles both IPv4 and IPv6 addresses and includes special handling to identify if an address is associated with the local machine itself.

Examples

var networkDetails = GetNetworkInterfaceDetails();
foreach (var detail in networkDetails)
{
    Console.WriteLine(detail.NetworkInterface.Description);
    foreach (var ipInfo in detail.IpAdressHostNames)
    {
        Console.WriteLine($"IP: {ipInfo.IPAddress}, Subnet: {ipInfo.SubnetMask}");
    }
}

GetNetworkInterfaceDetailsUpDhcpDnsGateway()

Retrieves a list of network interfaces that are operational and configured with DHCP, DNS, and gateway addresses.

Declaration

public List<NetworkService.NetworkInterfaceDetail> GetNetworkInterfaceDetailsUpDhcpDnsGateway()

Returns

Type	Description
List<NetworkService.NetworkInterfaceDetail>	A list of NetworkService.NetworkInterfaceDetail objects, each representing a network interface that meets the specified criteria of being operational with DHCP, DNS, and gateway configurations.

Remarks

This method filters network interfaces to include only those that are "Up" (operational) and have configured DHCP server addresses, DNS addresses, and gateway addresses. It relies on the GetNetworkInterfaceDetails() method to initially fetch all network interfaces and their details.

Examples

var detailedInterfaces = GetNetworkInterfaceDetailsUpDhcpDnsGateway();
foreach (var interfaceDetail in detailedInterfaces)
{
    Console.WriteLine($"Interface: {interfaceDetail.NetworkInterface.Name}");
    Console.WriteLine($"DHCP: {interfaceDetail.IPInterfaceProperties.DhcpServerAddresses.Count}");
    Console.WriteLine($"DNS: {interfaceDetail.IPInterfaceProperties.DnsAddresses.Count}");
    Console.WriteLine($"Gateway: {interfaceDetail.IPInterfaceProperties.GatewayAddresses.Count}");
}

GetNetworkIpAdressUpDhcpDnsGateway()

Retrieves IP address information for network interfaces that are operational, have DHCP and DNS configured, and include a gateway address.

Declaration

public List<NetworkService.IpAdressInformation> GetNetworkIpAdressUpDhcpDnsGateway()

Returns

Type	Description
List<NetworkService.IpAdressInformation>	A list of NetworkService.IpAdressInformation objects, each containing IP address details for interfaces that meet the specified conditions.

Remarks

This method selects network interfaces that are in an operational state with configured DHCP, DNS, and gateway addresses, and then gathers all related IP address information. It filters for IP addresses that have a corresponding host entry hostname, indicating valid DNS resolution.

Examples

var ipInfos = GetNetworkIpAdressUpDhcpDnsGateway();
foreach (var ipInfo in ipInfos)
{
    Console.WriteLine($"IP Address: {ipInfo.IPAddress} - Hostname: {ipInfo.HostEntryHostName}");
}

Implements

IDisposable

INetworkService