Compartilhar via


IPEndPoint.TryParse Método

Definição

Sobrecargas

TryParse(ReadOnlySpan<Char>, IPEndPoint)

Tenta converter um ponto de extremidade de rede IP (endereço e porta) representado como um intervalo somente leitura em seu IPEndPoint equivalente e retorna um valor que indica se a conversão foi bem-sucedida.

TryParse(String, IPEndPoint)

Tenta converter um ponto de extremidade de rede IP (endereço e porta) representado como uma cadeia de caracteres em seu IPEndPoint equivalente e retorna um valor que indica se a conversão foi bem-sucedida.

Comentários

O número de partes (cada parte é separada por um ponto) 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 de classe A, coloca a parte à esquerda 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 no máximo dois bytes direitos 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 válido um valor que pode ser analisado como um Int64e, em seguida, trata isso Int64 como o valor longo de um endereço IP na ordem de bytes 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 IP 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 decimal pontilhado.

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.

TryParse(ReadOnlySpan<Char>, IPEndPoint)

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

Tenta converter um ponto de extremidade de rede IP (endereço e porta) representado como um intervalo somente leitura em seu IPEndPoint equivalente e retorna 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 ponto de extremidade de IP a ser validado.

result
IPEndPoint

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

Retornos

true se s puder ser analisado como um ponto de extremidade de IP; caso contrário, false.

Aplica-se a

TryParse(String, IPEndPoint)

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

Tenta converter um ponto de extremidade de rede IP (endereço e porta) representado como uma cadeia de caracteres em seu IPEndPoint equivalente e retorna 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 ponto de extremidade de IP a ser validado.

result
IPEndPoint

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

Retornos

true se s puder ser analisado como um ponto de extremidade de IP; caso contrário, false.

Aplica-se a