IPEndPoint.TryParse Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.