IPInterfaceProperties.AnycastAddresses Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets the anycast IP addresses assigned to this interface.

Namespace:   System.Net.NetworkInformation
Assembly:  System (in System.dll)

public abstract IPAddressInformationCollection AnycastAddresses { get; }

Property Value

Type: System.Net.NetworkInformation.IPAddressInformationCollection

An IPAddressInformationCollection that contains the anycast addresses for this interface.

An anycast address identifies multiple computers. Packets sent to an anycast address are sent to one of the computers identified by the address. Anycast addressing is an IPv6 feature used to update router tables for a group of hosts.

The following code example displays the anycast addresses for the network interfaces on the local computer.

public static void DisplayAnycastAddresses()
{
    int count = 0;

    Console.WriteLine("Anycast Addresses");
    NetworkInterface[] adapters  = NetworkInterface.GetAllNetworkInterfaces();
    foreach (NetworkInterface adapter in adapters)
    {
        IPInterfaceProperties adapterProperties = adapter.GetIPProperties();
        IPAddressInformationCollection anyCast = adapterProperties.AnycastAddresses;
        if (anyCast.Count >0)
        {

            Console.WriteLine(adapter.Description);
            foreach (IPAddressInformation any in anyCast)
            {
                Console.WriteLine("  Anycast Address .......................... : {0} {1} {2}", 
                    any.Address,
                    any.IsTransient ? "Transient" : "", 
                    any.IsDnsEligible ? "DNS Eligible" : ""
                );
                count++;
            }
            Console.WriteLine();
        }
    }
    if (count == 0)
    {
        Console.WriteLine("  No anycast addressses were found.");
        Console.WriteLine();
    }
}

.NET Framework
Available since 2.0
Return to top
Show: