Partilhar via


IPEndPoint.Parse Método

Definição

Sobrecargas

Parse(ReadOnlySpan<Char>)

Converte um ponto de extremidade de rede IP (endereço e porta) representado como um intervalo somente leitura em uma instância de IPEndPoint.

Parse(String)

Converte um ponto de extremidade de rede IP (endereço e porta) representado como uma cadeia de caracteres em uma instância de IPEndPoint.

Comentários

O número de partes (cada parte é separada por um período) em s determina como o endereço IP do ponto de extremidade é 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 classe A, coloca a parte principal 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 nos dois bytes mais à direita do endereço de rede. Por exemplo:

Número de partes e exemplo s Endereço IPv4 para IPEndPoint.Address Porta
1 -- "1" 0.0.0.1 0
2 -- "20.2:80" 20.0.0.2 80
2 -- "20.65535:23" 20.0.255.255 23
3 -- "128.1.2:443" 128.1.0.2 443

Importante

Observe que esse método aceita como um valor válido que pode ser analisado como um Int64e, em seguida, trata isso Int64 como o valor longo de um endereço IP na ordem de byte de rede, semelhante à maneira como o construtor IPAddress faz. Isso significa que esse método retornará true se o Int64 for analisado com êxito, mesmo que ele represente um endereço que não seja um endereço IP válido. Por exemplo, se s for "1", esse método retornará true mesmo que "1" (ou 0.0.0.1) não seja um endereço IP válido e você pode esperar que esse método retorne false. Corrigir esse bug interromperia os aplicativos existentes para que o comportamento atual não seja alterado. Seu código pode evitar esse comportamento garantindo que ele use apenas esse método para analisar endereços IP no formato dotted-decimal.

Os endereços IPv6 literais precisam ser colocados entre colchetes [] ao passar um ponto de extremidade que especifica um número de porta; caso contrário, chaves quadradas não são obrigatórias.

Parse(ReadOnlySpan<Char>)

Origem:
IPEndPoint.cs
Origem:
IPEndPoint.cs
Origem:
IPEndPoint.cs

Converte um ponto de extremidade de rede IP (endereço e porta) representado como um intervalo somente leitura em uma instância de IPEndPoint.

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

Parâmetros

s
ReadOnlySpan<Char>

Um intervalo somente leitura que contém um ponto de extremidade IP em notação quádrupla pontilhada ou em ordem de byte de rede para IPv4 e em notação hexadecimal com dois-pontos para IPv6.

Retornos

A representação de objeto de um ponto de extremidade de rede IP.

Exceções

s não é um ponto de extremidade de IP válido.

Aplica-se a

Parse(String)

Origem:
IPEndPoint.cs
Origem:
IPEndPoint.cs
Origem:
IPEndPoint.cs

Converte um ponto de extremidade de rede IP (endereço e porta) representado como uma cadeia de caracteres em uma instância de IPEndPoint.

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

Parâmetros

s
String

Uma cadeia de caracteres que contém um ponto de extremidade IP em notação quádrupla pontilhada ou em ordem de byte de rede para IPv4 e em notação hexadecimal com dois-pontos para IPv6.

Retornos

A representação de objeto de um ponto de extremidade de rede IP.

Exceções

s não é um ponto de extremidade de IP válido.

Aplica-se a