Uri.IsWellFormedUriString(String, UriKind) Methode

  • Referenz

Definition

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Gibt an, ob eine Zeichenfolge wohlgeformt ist, indem versucht wird, einen URI aus der Zeichenfolge zu erstellen. Es wird sichergestellt, dass keine weiteren Escapezeichen in die Zeichenfolge eingefügt werden müssen.

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 ein Uri erstellt werden soll.

uriKind
UriKind

Der Typ des Uri in uriString.

Gibt zurück

Boolean

true, wenn die Zeichenfolge wohlgeformt ist, andernfalls false.

Hinweise

In Versionen von .NET vor Version 4.5 gilt die Zeichenfolge standardmäßig gemäß RFC 2396 und RFC 2732 als gut gebildet. Wenn internationale Ressourcenbezeichner (IRIs) oder internationalisierte Domänennamen (IDN) aktiviert sind, wird die Zeichenfolge gemäß RFC 3986 und RFC 3987 als gut gebildet.

Ab .NET 4.5 werden Zeichenfolgen immer gemäß RFC 3986 und RFC 3987 als gut gebildet, 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, wodurch die Methode falsch zurückgegeben wird, wenn eine der folgenden Bedingungen auftritt.

Fehler Beispiel
Die Zeichenfolge ist nicht ordnungsgemäß 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 dann, wenn sie als Schrägstriche behandelt werden. http:\\\host/path/file
Die Zeichenfolge stellt eine hierarchische Absolute Uri dar und enthält keine "://" www.contoso.com/path/file
Der Parser für das Scheme Gibt an, dass die ursprüngliche Zeichenfolge nicht gut gebildet wurde. Das Beispiel hängt vom Schema des URI ab.
Ab .NET 4.5 werden relative URIs mit einem Doppelpunkt (':') in ihrem ersten Segment nicht als gut gebildet betrachtet. 2013.05.29_14:33:41

Weitere Informationen zur Unterstützung von IRI finden Sie im Abschnitt "Hinweise" für die Uri Klasse.

Gilt für

Siehe auch