IPEndPoint.Parse Methode

Definition

Namespace:

System.Net

Assembly:

System.Net.Primitives.dll

Überlädt

Parse(ReadOnlySpan<Char>)	Konvertiert einen IP-Netzwerkendpunkt (Adresse und Port) als schreibgeschützten Bereich auf eine IPEndPoint-Instanz.
Parse(String)	Konvertiert einen IP-Netzwerkendpunkt (Adresse und Port), der als Zeichenfolge dargestellt ist, in eine IPEndPoint-Instanz.

Hinweise

Die Anzahl der Teile (jeder Teil wird durch einen Punkt getrennt) in s bestimmt, wie die IP-Adresse des Endpunkts erstellt wird. Eine einteilige Adresse wird direkt in der Netzwerkadresse gespeichert. Bei einer zweiteiligen Adresse, die für die Angabe einer Adresse der Klasse A geeignet ist, wird der führende Teil in das erste Byte und der nachfolgende Teil in die höchsten drei Bytes der Netzwerkadresse platziert. Eine dreiteilige Adresse, die für die Angabe einer Klasse B-Adresse geeignet ist, setzt den ersten Teil in das erste Byte, den zweiten Teil in das zweite Byte und den letzten Teil in den höchsten zwei Bytes der Netzwerkadresse. Beispiel:

Anzahl der Teile und Beispiel s	IPv4-Adresse für IPEndPoint.Address	Port
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

Wichtig

Beachten Sie, dass diese Methode einen Wert als gültig akzeptiert, der als Int64analysiert werden kann, und behandelt diesen Int64 dann als long-Wert einer IP-Adresse in Netzwerkbytereihenfolge, ähnlich wie der IPAddress-Konstruktor. Dies bedeutet, dass diese Methode true zurückgibt, wenn der Int64 erfolgreich analysiert wurde, auch wenn es eine Adresse darstellt, die keine gültige IP-Adresse ist. Wenn s beispielsweise "1" ist, gibt diese Methode true zurück, obwohl "1" (oder 0.0.0.1) keine gültige IP-Adresse ist und Sie möglicherweise erwarten, dass diese Methode false zurückgibt. Das Beheben dieses Fehlers würde vorhandene Apps unterbrechen, sodass das aktuelle Verhalten nicht geändert wird. Ihr Code kann dieses Verhalten vermeiden, indem er sicherstellt, dass diese Methode nur verwendet wird, um IP-Adressen im Gepunktet-Dezimalformat zu analysieren.

Literale IPv6-Adressen müssen in eckige Klammern [] eingeschlossen werden, wenn sie einen Endpunkt übergeben, der eine Portnummer angibt. Andernfalls sind eckige Klammern nicht obligatorisch.

Parse(ReadOnlySpan<Char>)

Quelle:

IPEndPoint.cs

Konvertiert einen IP-Netzwerkendpunkt (Adresse und Port) als schreibgeschützten Bereich auf eine IPEndPoint-Instanz.

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

Parameter

s

ReadOnlySpan<Char>

Ein schreibgeschützter Bereich, der einen IP-Endpunkt im Punktformat (Dotted-Quad Notation) oder mit Netzwerk-Bytereihenfolge für IPv4 und im durch Doppelpunkt getrennten Hexadezimalformat für IPv6 enthält.

Gibt zurück

IPEndPoint

Die Objektdarstellung eines IP-Netzwerkendpunkts.

Ausnahmen

ArgumentNullException

s ist null.

FormatException

s ist kein gültiger IP-Endpunkt.

Parse(String)

Quelle:

IPEndPoint.cs

Konvertiert einen IP-Netzwerkendpunkt (Adresse und Port), der als Zeichenfolge dargestellt ist, in eine IPEndPoint-Instanz.

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

Parameter

s

String

Eine Zeichenfolge, die einen IP-Endpunkt im Punktformat (Dotted-Quad Notation) oder mit Netzwerk-Bytereihenfolge für IPv4 und im durch Doppelpunkt getrennten Hexadezimalformat für IPv6 enthält.

Gibt zurück

IPEndPoint

Die Objektdarstellung eines IP-Netzwerkendpunkts.

Ausnahmen

ArgumentNullException

s ist null.

FormatException

s ist kein gültiger IP-Endpunkt.