IPAddress.Parse Método
Definição
Sobrecargas
| Parse(String) |
Converte uma cadeia de caracteres de endereços IP em uma instância IPAddress.Converts an IP address string to an IPAddress instance. |
| Parse(ReadOnlySpan<Char>) |
Converte um endereço IP representado como um intervalo de caracteres em uma instância de IPAddress.Converts an IP address represented as a character span to an IPAddress instance. |
Parse(String)
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
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.A string that contains an IP address in dotted-quad notation for IPv4 and in colon-hexadecimal notation for IPv6.
Retornos
Uma instância IPAddress.An IPAddress instance.
Exceções
ipString é null.ipString is null.
ipString não é um endereço IP válido.ipString is not a valid IP address.
Exemplos
O código a seguir converte uma cadeia de caracteres que contém um endereço IP, em notação pontilhada-Quad para IPv4 ou em notação hexadecimal de dois-pontos para IPv6, em uma instância da IPAddress classe.The following code converts a string that contains an IP address, in dotted-quad notation for IPv4 or in colon-hexadecimal notation for IPv6, into an instance of the IPAddress class. Em seguida, ele usa o ToString método sobrecarregado para exibir o endereço na notação padrão.Then it uses the overloaded ToString method to display the address in standard notation.
#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
Comentários
O Parse método estático cria uma IPAddress instância de um endereço IP expresso em notação pontilhada-quádrupla para IPv4 e em notação hexadecimal de dois-pontos para IPv6.The static Parse method creates an IPAddress instance from an IP address expressed in dotted-quad notation for IPv4 and in colon-hexadecimal notation for IPv6.
O número de partes (cada parte é separado por um ponto) em ipString determina como o endereço IP é construído.The number of parts (each part is separated by a period) in ipString determines how the IP address is constructed. Um endereço de uma parte é armazenado diretamente no endereço de rede.A one part address is stored directly in the network address. Um endereço de duas partes, conveniente para especificar um endereço de classe A, coloca a parte principal no primeiro byte e a parte à direita na maioria dos três bytes do endereço de rede.A two part address, convenient for specifying a class A address, puts the leading part in the first byte and the trailing part in the right-most three bytes of the network address. 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 na maioria dos dois bytes do endereço de rede à direita.A three part address, convenient for specifying a class B address, puts the first part in the first byte, the second part in the second byte, and the final part in the right-most two bytes of the network address. Por exemplo:For example:
Número de partes e exemplo ipStringNumber of parts and example ipString |
Endereço IPv4 para IPAddressIPv4 address for IPAddress |
|---|---|
| 1--"65535"1 -- "65535" | 0.0.255.2550.0.255.255 |
| 2--"20,2"2 -- "20.2" | 20.0.0.220.0.0.2 |
| 2--"20,65535"2 -- "20.65535" | 20.0.255.25520.0.255.255 |
| 3--"128.1.2"3 -- "128.1.2" | 128.1.0.2128.1.0.2 |
Aplica-se a
Parse(ReadOnlySpan<Char>)
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
Parâmetros
- ipStringipSpan
- 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.A character span that contains an IP address in dotted-quad notation for IPv4 and in colon-hexadecimal notation for IPv6.
Retornos
O endereço IP convertido.The converted IP address.
Exceções
ipString não é um endereço IP válido.ipString is not a valid IP address.