IPAddress.Parse Méthode

Définition

Surcharges

Nom Description
Parse(String)

Convertit une chaîne d’adresse IP en instance IPAddress .

Parse(ReadOnlySpan<Char>)

Convertit une adresse IP représentée sous la forme d’une étendue de caractères en instance IPAddress .

Parse(String)

Convertit une chaîne d’adresse IP en instance IPAddress .

public:
 static System::Net::IPAddress ^ Parse(System::String ^ ipString);
public static System.Net.IPAddress Parse(string ipString);
static member Parse : string -> System.Net.IPAddress
Public Shared Function Parse (ipString As String) As IPAddress

Paramètres

ipString
String

Chaîne qui contient une adresse IP en notation pointillée quad pour IPv4 et en notation deux-hexadécimales pour IPv6.

Retours

Instance IPAddress .

Exceptions

ipString a la valeur null.

ipString n’est pas une adresse IP valide.

Exemples

Le code suivant convertit une chaîne qui contient une adresse IP, en notation en pointillés pour IPv4 ou en notation hexadécimale deux-points pour IPv6, en une instance de la IPAddress classe. Ensuite, il utilise la méthode surchargée ToString pour afficher l’adresse en notation standard.


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);
    }
   }
}
Imports System.Net



Class ParseAddress
   
   'Entry point which delegates to C-style main Private Function
   Public Overloads Shared Sub Main()
      Main(System.Environment.GetCommandLineArgs())
   End Sub
   
   
   Overloads Private Shared Sub Main(args() As String)
      Dim IPaddress As String
      
      If args.Length = 1 Then
         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(1)
      End If 
      ' Get the list of the IPv6 addresses associated with the requested host.
      Parse(IPaddress)
   End Sub
    
   
   ' This method calls the IPAddress.Parse method to check the ipAddress 
   ' input string. If the ipAddress argument represents a syntatical 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 Shared Sub Parse(ipAddr As String)
      Try
         ' Create an instance of IPAddress for the specified address string (in 
         ' dotted-quad, or colon-hexadecimal notation).
         Dim address As IPAddress = IPAddress.Parse(ipAddr)
         
         ' Display the address in standard notation.
         Console.WriteLine(("Parsing your input string: " + """" + ipAddr + """" + " produces this address (shown in its standard notation): " + address.ToString()))
      
      Catch e As ArgumentNullException
         Console.WriteLine("ArgumentNullException caught!!!")
         Console.WriteLine(("Source : " + e.Source))
         Console.WriteLine(("Message : " + e.Message))
      
      Catch e As FormatException
         Console.WriteLine("FormatException caught!!!")
         Console.WriteLine(("Source : " + e.Source))
         Console.WriteLine(("Message : " + e.Message))
      
      Catch e As Exception
         Console.WriteLine("Exception caught!!!")
         Console.WriteLine(("Source : " + e.Source))
         Console.WriteLine(("Message : " + e.Message))
      End Try
   End Sub
End Class

Remarques

La méthode statique Parse crée une instance à partir d’une IPAddress adresse IP exprimée en notation pointillée pour IPv4 et en notation hexadécimale deux-points pour IPv6.

Le nombre de parties (chaque partie est séparée par un point) ipString détermine la façon dont l’adresse IP est construite. Une adresse d’une partie est stockée directement dans l’adresse réseau. Une adresse en deux parties, pratique pour spécifier une adresse A de classe, place la partie de début dans le premier octet et la partie de fin dans les trois octets les plus à droite de l’adresse réseau. Une adresse en trois parties, pratique pour spécifier une adresse B de classe, place la première partie dans le premier octet, la deuxième partie dans le deuxième octet et la dernière partie dans les deux octets les plus à droite de l’adresse réseau. Par exemple:

Nombre de parties et d’exemples ipString Adresse IPv4 pour 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

S’applique à

Parse(ReadOnlySpan<Char>)

Convertit une adresse IP représentée sous la forme d’une étendue de caractères en instance IPAddress .

public:
 static System::Net::IPAddress ^ Parse(ReadOnlySpan<char> ipString);
public static System.Net.IPAddress Parse(ReadOnlySpan<char> ipString);
static member Parse : ReadOnlySpan<char> -> System.Net.IPAddress
Public Shared Function Parse (ipString As ReadOnlySpan(Of Char)) As IPAddress

Paramètres

ipStringipSpan
ReadOnlySpan<Char>

Étendue de caractères qui contient une adresse IP en notation pointillée quad pour IPv4 et en notation deux-hexadécimales pour IPv6.

Retours

Adresse IP convertie.

Exceptions

ipString n’est pas une adresse IP valide.

S’applique à