IPAddress.Parse Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.