IPEndPoint.Parse 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 |
|---|---|
| Parse(ReadOnlySpan<Byte>) | |
| Parse(ReadOnlySpan<Char>) |
Converte um endpoint de rede IP (endereço e porta) representado como um span de apenas leitura numa IPEndPoint instância. |
| Parse(String) |
Converte um endpoint de rede IP (endereço e porta) representado como uma string numa IPEndPoint instância. |
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.
Parse(ReadOnlySpan<Byte>)
- Origem:
- IPEndPoint.cs
public:
static System::Net::IPEndPoint ^ Parse(ReadOnlySpan<System::Byte> utf8Text);public static System.Net.IPEndPoint Parse(ReadOnlySpan<byte> utf8Text);static member Parse : ReadOnlySpan<byte> -> System.Net.IPEndPointPublic Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte)) As IPEndPointParâmetros
- utf8Text
- ReadOnlySpan<Byte>
Devoluções
Aplica-se a
Parse(ReadOnlySpan<Char>)
- Origem:
- IPEndPoint.cs
- Origem:
- IPEndPoint.cs
- Origem:
- IPEndPoint.cs
- Origem:
- IPEndPoint.cs
- Origem:
- IPEndPoint.cs
Converte um endpoint de rede IP (endereço e porta) representado como um span de apenas leitura numa IPEndPoint instância.
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.IPEndPointPublic Shared Function Parse (s As ReadOnlySpan(Of Char)) As IPEndPointParâmetros
- s
- ReadOnlySpan<Char>
Um span de apenas leitura que contém um endpoint IP em notação pontuado-quad ou ordem de bytes de rede para IPv4 e em notação dois-dois hexadecimal para IPv6.
Devoluções
A representação do objeto de um ponto final de rede IP.
Exceções
s é null.
s não é um endpoint IP válido.
Aplica-se a
Parse(String)
- Origem:
- IPEndPoint.cs
- Origem:
- IPEndPoint.cs
- Origem:
- IPEndPoint.cs
- Origem:
- IPEndPoint.cs
- Origem:
- IPEndPoint.cs
Converte um endpoint de rede IP (endereço e porta) representado como uma string numa IPEndPoint instância.
public:
static System::Net::IPEndPoint ^ Parse(System::String ^ s);public static System.Net.IPEndPoint Parse(string s);static member Parse : string -> System.Net.IPEndPointPublic Shared Function Parse (s As String) As IPEndPointParâmetros
- s
- String
Uma cadeia que contém um endpoint IP em notação pontuado-quad ou ordem de bytes de rede para IPv4 e em notação dois-dois e hexadecimal para IPv6.
Devoluções
A representação do objeto de um ponto final de rede IP.
Exceções
s é null.
s não é um endpoint IP válido.
