IPAddress.Parse Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
Parse(String) |
Converte una stringa di indirizzi IP in un'istanza di IPAddress. |
Parse(ReadOnlySpan<Char>) |
Converte un indirizzo IP rappresentato come intervallo di caratteri in un'istanza di IPAddress. |
Parse(String)
- Origine:
- IPAddress.cs
- Origine:
- IPAddress.cs
- Origine:
- IPAddress.cs
Converte una stringa di indirizzi IP in un'istanza di 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
Parametri
- ipString
- String
Stringa contenente un indirizzo IP nella notazione a quattro numeri separati da punti per IPv4 e nella notazione a cifre esadecimali separate da due punti per IPv6.
Restituisce
Istanza di IPAddress.
Eccezioni
ipString
è null
.
ipString
non è un indirizzo IP valido.
Esempio
Il codice seguente converte una stringa che contiene un indirizzo IP, in notazione quad tratteggiata per IPv4 o in notazione esadecimale per IPv6, in un'istanza della IPAddress classe . Usa quindi il metodo di ToString overload per visualizzare l'indirizzo nella notazione standard.
#using <System.dll>
using namespace System;
using namespace System::Net;
// 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.
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: \"{0}\" produces this address (shown in its standard notation): {1}", ipAddress, address );
}
catch ( ArgumentNullException^ e )
{
Console::WriteLine( "ArgumentNullException caught!!!" );
Console::WriteLine( "Source : {0}", e->Source );
Console::WriteLine( "Message : {0}", e->Message );
}
catch ( FormatException^ e )
{
Console::WriteLine( "FormatException caught!!!" );
Console::WriteLine( "Source : {0}", e->Source );
Console::WriteLine( "Message : {0}", e->Message );
}
catch ( Exception^ e )
{
Console::WriteLine( "Exception caught!!!" );
Console::WriteLine( "Source : {0}", e->Source );
Console::WriteLine( "Message : {0}", e->Message );
}
}
int main()
{
array<String^>^args = Environment::GetCommandLineArgs();
String^ IPaddress;
if ( args->Length == 1 )
{
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 0;
}
else
IPaddress = args[ 1 ];
// Get the list of the IPv6 addresses associated with the requested host.
parse( IPaddress );
}
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
Commenti
Il metodo statico Parse crea un'istanza IPAddress da un indirizzo IP espresso in notazione quad tratteggiata per IPv4 e in notazione esadecimale a due punti per IPv6.
Il numero di parti (ogni parte è separata da un punto) in ipString
determina la modalità di costruzione dell'indirizzo IP. Un indirizzo di una parte viene archiviato direttamente nell'indirizzo di rete. Un indirizzo in due parti, utile per specificare una classe A, inserisce la parte iniziale nel primo byte e la parte finale nei tre byte più a destra dell'indirizzo di rete. Un indirizzo in tre parti, utile per specificare un indirizzo di classe B, inserisce la prima parte nel primo byte, la seconda parte nel secondo byte e la parte finale nei due byte più a destra dell'indirizzo di rete. Ad esempio:
Numero di parti ed esempio ipString |
Indirizzo IPv4 per 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 |
Si applica a
Parse(ReadOnlySpan<Char>)
- Origine:
- IPAddress.cs
- Origine:
- IPAddress.cs
- Origine:
- IPAddress.cs
Converte un indirizzo IP rappresentato come intervallo di caratteri in un'istanza di IPAddress.
public:
static System::Net::IPAddress ^ Parse(ReadOnlySpan<char> ipSpan);
public:
static System::Net::IPAddress ^ Parse(ReadOnlySpan<char> ipString);
public static System.Net.IPAddress Parse (ReadOnlySpan<char> ipSpan);
public static System.Net.IPAddress Parse (ReadOnlySpan<char> ipString);
static member Parse : ReadOnlySpan<char> -> System.Net.IPAddress
static member Parse : ReadOnlySpan<char> -> System.Net.IPAddress
Public Shared Function Parse (ipSpan As ReadOnlySpan(Of Char)) As IPAddress
Public Shared Function Parse (ipString As ReadOnlySpan(Of Char)) As IPAddress
Parametri
- ipStringipSpan
- ReadOnlySpan<Char>
Intervallo di caratteri contenente un indirizzo IP nella notazione a quattro numeri separati da punti per IPv4 e nella notazione a cifre esadecimali separate da due punti per IPv6.
Restituisce
Indirizzo IP convertito.
Eccezioni
ipString
non è un indirizzo IP valido.