IPEndPoint.Parse Método

Definição

Namespace:

System.Net

Assembly:

System.Net.Primitives.dll

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

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

IPEndPoint

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

Exceções

ArgumentNullException

s é null.

FormatException

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

Parse(String)

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

IPEndPoint

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

Exceções

ArgumentNullException

s é null.

FormatException

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