IPEndPoint.TryParse Método

Definição

Sobrecargas

Name Description
TryParse(ReadOnlySpan<Byte>, IPEndPoint)
TryParse(String, IPEndPoint)

Tenta converter um endpoint de rede IP (endereço e porta) representado como uma string para o seu IPEndPoint equivalente, e devolve um valor que indica se a conversão foi bem-sucedida.

TryParse(ReadOnlySpan<Char>, IPEndPoint)

Tenta converter um endpoint de rede IP (endereço e porta) representado como um span de apenas leitura para o seu IPEndPoint equivalente, e devolve um valor que indica se a conversão foi bem-sucedida.

Observações

O número de partes (cada parte é separada por um ponto) determina s como o endereço IP do endpoint é construído. Um endereço de uma peça é armazenado diretamente no endereço de rede. Um endereço de duas partes, conveniente para especificar um endereço de classe A, coloca a parte inicial no primeiro byte e a parte final nos três bytes mais à direita 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 última parte 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 Porto
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

Note-se que este método aceita como válido um valor que pode ser analisado como um Int64, e depois o Int64 trata como o valor longo de um endereço IP em ordem de bytes de rede, de forma semelhante ao que o construtor IPAddress faz. Isto significa que este método retorna verdadeiro se o Int64 for analisado com sucesso, mesmo que represente um endereço que não seja um endereço IP válido. Por exemplo, se s for "1", este método devolve true mesmo que "1" (ou 0.0.0.1) não seja um endereço IP válido e pode esperar que este método devolva false. Corrigir este bug iria quebrar as aplicações existentes, por isso o comportamento atual não será alterado. O seu código pode evitar este comportamento garantindo que só utiliza este método para analisar endereços IP em formato pontuado-decimal.

Endereços IPv6 literais precisam de ser incluídos entre colchetes quadrados [] ao passar por um endpoint que especifica um número de porta; caso contrário, os bloqueios quadrados não são obrigatórios.

TryParse(ReadOnlySpan<Byte>, IPEndPoint)

Origem:
IPEndPoint.cs
public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, [Runtime::InteropServices::Out] System::Net::IPEndPoint ^ % result);
public static bool TryParse(ReadOnlySpan<byte> utf8Text, out System.Net.IPEndPoint? result);
static member TryParse : ReadOnlySpan<byte> * IPEndPoint -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), ByRef result As IPEndPoint) As Boolean

Parâmetros

utf8Text
ReadOnlySpan<Byte>
result
IPEndPoint

Devoluções

Aplica-se a

TryParse(String, IPEndPoint)

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

Tenta converter um endpoint de rede IP (endereço e porta) representado como uma string para o seu IPEndPoint equivalente, e devolve um valor que indica se a conversão foi bem-sucedida.

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] System::Net::IPEndPoint ^ % result);
public static bool TryParse(string s, out System.Net.IPEndPoint? result);
public static bool TryParse(string s, out System.Net.IPEndPoint result);
static member TryParse : string * IPEndPoint -> bool
Public Shared Function TryParse (s As String, ByRef result As IPEndPoint) As Boolean

Parâmetros

s
String

O endpoint IP para validar.

result
IPEndPoint

Quando este método retorna, a IPEndPoint versão de s.

Devoluções

true se s pode ser analisado como um endpoint IP; caso contrário, false.

Aplica-se a

TryParse(ReadOnlySpan<Char>, IPEndPoint)

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

Tenta converter um endpoint de rede IP (endereço e porta) representado como um span de apenas leitura para o seu IPEndPoint equivalente, e devolve um valor que indica se a conversão foi bem-sucedida.

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] System::Net::IPEndPoint ^ % result);
public static bool TryParse(ReadOnlySpan<char> s, out System.Net.IPEndPoint? result);
public static bool TryParse(ReadOnlySpan<char> s, out System.Net.IPEndPoint result);
static member TryParse : ReadOnlySpan<char> * IPEndPoint -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As IPEndPoint) As Boolean

Parâmetros

s
ReadOnlySpan<Char>

O endpoint IP para validar.

result
IPEndPoint

Quando este método retorna, a IPEndPoint versão de s.

Devoluções

true se s pode ser analisado como um endpoint IP; caso contrário, false.

Aplica-se a