• Article

IPAddress.IPv6None Field

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Provides an IPv6 address that indicates that no network interface should be used. This property is read-only.

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

Syntax

'Declaration
Public Shared ReadOnly IPv6None As IPAddress

public static readonly IPAddress IPv6None

Remarks

The IPv6None field is equivalent to 0:0:0:0:0:0:0:0 in colon-hexadecimal notation, or to ::0 in compact notation.

The IPv6None field is defined even when the Socket.OSSupportsIPv6 property is false.

Examples

The following code example displays the value of the current host's IPv6 None address in standard compact notation.

' This sample prints the value of the current host's None address in  
' standard compressed format. The None address is used by the host to disable
' listening to client activities on all the interfaces.
   Try

      ' Get the None address.
      Dim none As IPAddress = IPAddress.IPv6None

      ' Transform the None address to a string using the overloaded
      ' ToString() method. Note that the resulting string is in the compact 
      ' form: "::".
      Dim ipv6None As String = none.ToString()

      outputBlock.Text &= "The IPv6 None address is: "
      outputBlock.Text &= ipv6None
      outputBlock.Text &= vbCrLf
   Catch e As Exception
      outputBlock.Text &= "Exception: "
      outputBlock.Text &= e.ToString()
      outputBlock.Text &= vbCrLf
   End Try

// This method displays the value of the current host's None address in  
// standard compressed format. The None address is used by the host to disable
// listening to client activities on all the interfaces.
try
{

  // Get the None address.
  IPAddress none  = IPAddress.IPv6None;

  // Transform the None address to a string using the overloaded
  // ToString() method. Note that the resulting string is in the compact 
  // form: "::".
  string ipv6None = none.ToString();

  outputBlock.Text += "The IPv6 None address is: ";
  outputBlock.Text += ipv6None;
  outputBlock.Text += "\n";
}
catch (Exception e) 
{
  outputBlock.Text += "Exception: ";
  outputBlock.Text += e.ToString();
  outputBlock.Text += "\n";
}

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.