IPEndPoint.Parse Metodo

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.Primitives.dll

Overload

Parse(ReadOnlySpan<Char>)	Converte un endpoint di rete IP (indirizzo e porta) rappresentato come intervallo di sola lettura in un'istanza di IPEndPoint.
Parse(String)	Converte un endpoint di rete IP (indirizzo e porta) rappresentato come stringa in un'istanza di IPEndPoint.

Commenti

Il numero di parti (ogni parte è separata da un punto) in s determina come viene costruito l'indirizzo IP dell'endpoint. Un indirizzo a una parte viene archiviato direttamente nell'indirizzo di rete. Un indirizzo a due parti, pratico per specificare un indirizzo A della classe, inserisce la parte iniziale nel primo byte e la parte finale nella maggior parte destra dell'indirizzo di rete. Un indirizzo a tre parti, pratico per specificare un indirizzo B di classe, inserisce la prima parte nel primo byte, la seconda parte nel secondo byte e la parte finale nella maggior parte destra dell'indirizzo di rete. Ad esempio:

Numero di parti ed esempio s	Indirizzo IPv4 per 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

Si noti che questo metodo accetta come valore valido che può essere analizzato come Int64, e quindi considera che Int64 come valore lungo di un indirizzo IP nell'ordine di byte di rete, simile al modo in cui il costruttore IPAddress esegue. Ciò significa che questo metodo restituisce true se Int64 viene analizzato correttamente, anche se rappresenta un indirizzo IP non valido. Ad esempio, se s è "1", questo metodo restituisce true anche se "1" (o 0.0.0.1) non è un indirizzo IP valido e potrebbe essere previsto che questo metodo restituisca false. La correzione di questo bug interrompe le app esistenti, quindi il comportamento corrente non verrà modificato. Il codice può evitare questo comportamento assicurandosi che usi solo questo metodo per analizzare gli indirizzi IP in formato punteggiato-decimale.

Gli indirizzi IPv6 letterali devono essere racchiusi tra parentesi quadre [] quando si passa un endpoint che specifica un numero di porta; in caso contrario, le parentesi graffe quadrate non sono obbligatorie.

Parse(ReadOnlySpan<Char>)

Origine:

IPEndPoint.cs

Converte un endpoint di rete IP (indirizzo e porta) rappresentato come intervallo di sola lettura in un'istanza di IPEndPoint.

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

Public Shared Function Parse (s As ReadOnlySpan(Of Char)) As IPEndPoint

Parametri

s

ReadOnlySpan<Char>

Intervallo di sola lettura contenente un endpoint IP nella notazione a quattro numeri separati da punti o con l'ordine dei byte di rete per IPv4 e nella notazione a cifre esadecimali separate da due punti per IPv6.

Restituisce

IPEndPoint

Rappresentazione oggetto di un endpoint di rete IP.

Eccezioni

ArgumentNullException

s è null.

FormatException

s non è un endpoint IP valido.

Parse(String)

Origine:

IPEndPoint.cs

Converte un endpoint di rete IP (indirizzo e porta) rappresentato come stringa in un'istanza di IPEndPoint.

public:
 static System::Net::IPEndPoint ^ Parse(System::String ^ s);

public static System.Net.IPEndPoint Parse (string s);

static member Parse : string -> System.Net.IPEndPoint

Public Shared Function Parse (s As String) As IPEndPoint

Parametri

s

String

Stringa contenente un endpoint IP nella notazione a quattro numeri separati da punti o con l'ordine dei byte di rete per IPv4 e nella notazione a cifre esadecimali separate da due punti per IPv6.

Restituisce

IPEndPoint

Rappresentazione oggetto di un endpoint di rete IP.

Eccezioni

ArgumentNullException

s è null.

FormatException

s non è un endpoint IP valido.