IPEndPoint.TryParse Método

Definição

Namespace:

System.Net

Assembly:

System.Net.Primitives.dll

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 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.

TryParse(ReadOnlySpan<Char>, IPEndPoint)

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);

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

Boolean

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

TryParse(String, IPEndPoint)

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);

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

Boolean

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