IPAddress.Parse Método

Definição

Namespace:

System.Net

Assemblies:

netstandard.dll, System.Net.Primitives.dll

Sobrecargas

Parse(String)	Converte uma cadeia de caracteres de endereços IP em uma instância IPAddress.
Parse(ReadOnlySpan<Char>)	Converte um endereço IP representado como um intervalo de caracteres em uma instância de IPAddress.

Parse(String)

Origem:

IPAddress.cs

Converte uma cadeia de caracteres de endereços IP em uma instância IPAddress.

C#

public static System.Net.IPAddress Parse(string ipString);

Parâmetros

ipString

String

Uma cadeia de caracteres que contém um endereço IP em notação quádrupla com pontos para IPv4 e em notação hexadecimal com dois-pontos para IPv6.

Retornos

IPAddress

Uma instância IPAddress.

Exceções

ArgumentNullException

ipString é null.

FormatException

ipString não é um endereço IP válido.

Exemplos

O código a seguir converte uma cadeia de caracteres que contém um endereço IP, em notação dotted-quad para IPv4 ou em notação hexadecimal de dois-pontos para IPv6, em uma instância da IPAddress classe . Em seguida, ele usa o método sobrecarregado ToString para exibir o endereço na notação padrão.

C#

using System;
using System.Net;

class ParseAddress
{

  private static void Main(string[] args)
  {
    string IPaddress;

    if (args.Length == 0)
    {
      Console.WriteLine("Please enter an IP address.");
      Console.WriteLine("Usage:   >cs_parse any IPv4 or IPv6 address.");
      Console.WriteLine("Example: >cs_parse 127.0.0.1");
      Console.WriteLine("Example: >cs_parse 0:0:0:0:0:0:0:1");
      return;
    }
    else
        {
            IPaddress = args[0];
        }

        // Get the list of the IPv6 addresses associated with the requested host.
        Parse(IPaddress);
  }

  // This method calls the IPAddress.Parse method to check the ipAddress
  // input string. If the ipAddress argument represents a syntatically correct IPv4 or
  // IPv6 address, the method displays the Parse output into quad-notation or
  // colon-hexadecimal notation, respectively. Otherwise, it displays an
  // error message.
  private static void Parse(string ipAddress)
  {
    try
    {
      // Create an instance of IPAddress for the specified address string (in
      // dotted-quad, or colon-hexadecimal notation).
      IPAddress address = IPAddress.Parse(ipAddress);

      // Display the address in standard notation.
      Console.WriteLine("Parsing your input string: " + "\"" + ipAddress + "\"" + " produces this address (shown in its standard notation): "+ address.ToString());
    }

    catch(ArgumentNullException e)
    {
      Console.WriteLine("ArgumentNullException caught!!!");
      Console.WriteLine("Source : " + e.Source);
      Console.WriteLine("Message : " + e.Message);
    }

    catch(FormatException e)
    {
      Console.WriteLine("FormatException caught!!!");
      Console.WriteLine("Source : " + e.Source);
      Console.WriteLine("Message : " + e.Message);
    }

    catch(Exception e)
    {
      Console.WriteLine("Exception caught!!!");
      Console.WriteLine("Source : " + e.Source);
      Console.WriteLine("Message : " + e.Message);
    }
   }
}

Comentários

O método estático Parse cria uma IPAddress instância de um endereço IP expresso em notação dotted-quad para IPv4 e em notação hexadecimal de dois-pontos para IPv6.

O número de partes (cada parte é separada por um ponto) em ipString determina como o endereço IP é construído. Um endereço de uma parte é armazenado diretamente no endereço de rede. Um endereço de duas partes, conveniente para especificar um endereço de classe A, coloca a parte à esquerda no primeiro byte e a parte à direita no máximo três bytes do endereço de rede. Um endereço de três partes, conveniente para especificar um endereço de classe B, coloca a primeira parte no primeiro byte, a segunda parte no segundo byte e a parte final no máximo dois bytes direitos do endereço de rede. Por exemplo:

Número de partes e exemplo ipString	Endereço IPv4 para IPAddress
1 -- "65535"	0.0.255.255
2 -- "20.2"	20.0.0.2
2 -- "20.65535"	20.0.255.255
3 -- "128.1.2"	128.1.0.2
4 -- "1.1.1.10"	1.1.1.10
4 -- "1.1.1.010"	1.1.1.8
1 - "0x2F"	0.0.0.47

Parse(ReadOnlySpan<Char>)

Origem:

IPAddress.cs

Converte um endereço IP representado como um intervalo de caracteres em uma instância de IPAddress.

C#

public static System.Net.IPAddress Parse(ReadOnlySpan<char> ipSpan);

Parâmetros

ipSpan

ReadOnlySpan<Char>

Um intervalo de cadeia de caracteres que contém um endereço IP em notação quádrupla com pontos para IPv4 e em notação hexadecimal com dois-pontos para IPv6.

Retornos

IPAddress

O endereço IP convertido.

Exceções

FormatException

ipString não é um endereço IP válido.