Interface INetworkService

Defines the interface for a service that handles network management operations.

Namespace: Coree.NETStandard.Services.NetworkManagement

Assembly: Coree.NETStandard.dll

Syntax

public interface INetworkService

Methods

GetNetworkInterfaceDetails()

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

Declaration

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

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

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}");
}