Uri.IsWellFormedUriString(String, UriKind) Methode

Definition

Gibt an, ob die Zeichenfolge wohlgeformt ist, indem Sie versuchen, einen URI mit der Zeichenfolge zu erstellen, und stellt sicher, dass die Zeichenfolge keine weitere Escapeung erfordert.

public:
 static bool IsWellFormedUriString(System::String ^ uriString, UriKind uriKind);
public static bool IsWellFormedUriString(string uriString, UriKind uriKind);
public static bool IsWellFormedUriString(string? uriString, UriKind uriKind);
static member IsWellFormedUriString : string * UriKind -> bool
Public Shared Function IsWellFormedUriString (uriString As String, uriKind As UriKind) As Boolean

Parameter

uriString
String

Die Zeichenfolge, mit der versucht wird, eine Uri.

uriKind
UriKind

Der Typ des Ins UriuriString.

Gibt zurück

truewenn die Zeichenfolge wohlgeformt war; andernfalls . false

Hinweise

In Versionen von .NET vor Version 4.5 gilt die Zeichenfolge standardmäßig als wohlgeformt gemäß RFC 2396 und RFC 2732. Wenn die Analyse von International Resource Identifiers (IRIs) oder Internationalized Domain Name (IDN) aktiviert ist, wird die Zeichenfolge gemäß RFC 3986 und RFC 3987 als wohlgeformt betrachtet.

Ab .NET 4.5 gelten Zeichenfolgen immer als wohlgeformt gemäß RFC 3986 und RFC 3987, unabhängig davon, ob IRI oder IDN aktiviert sind. Beachten Sie jedoch, dass dies nur für Apps gilt, die auf .NET 4.5 oder höher abzielen. Apps, die auf .NET 4.0 abzielen, rufen Kompatibilitätscode auf und erleben das alte Verhalten (pre-4.5).

Die Zeichenfolge wird als schlecht gebildet betrachtet, was dazu führt, dass die Methode "false" zurückgibt, wenn eine der folgenden Bedingungen auftritt.

Fehler Example
Die Zeichenfolge ist nicht richtig escaped. http://www.contoso.com/path???/file name
Die Zeichenfolge ist eine absolute Uri , die eine implizite Datei Uridarstellt. c:\\directory\filename
Die Zeichenfolge ist ein absoluter URI, der vor dem Pfad einen Schrägstrich fehlt. file://c:/directory/filename
Die Zeichenfolge enthält unescaped backslashes, auch wenn sie als Schrägstriche behandelt werden. http:\\\host/path/file
Die Zeichenfolge stellt einen hierarchischen absoluten Uri Wert dar und enthält nicht "://". www.contoso.com/path/file
Der Parser für die Scheme Gibt an, dass die ursprüngliche Zeichenfolge nicht wohlgeformt war. Das Beispiel hängt vom Schema des URI ab.
Ab .NET 4.5 gelten relative URIs mit einem Doppelpunkt (':') in ihrem ersten Segment nicht als wohlgeformt. 2013.05.29_14:33:41

Weitere Informationen zur IRI-Unterstützung finden Sie im Abschnitt "Hinweise" für den Uri Kurs.

Gilt für:

Weitere Informationen