Uri.IsWellFormedUriString(String, UriKind) Uri.IsWellFormedUriString(String, UriKind) Uri.IsWellFormedUriString(String, UriKind) Method

Definition

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.Indicates whether the string is well-formed by attempting to construct a URI with the string and ensures that the string does not require further escaping.

public:
 static bool IsWellFormedUriString(System::String ^ uriString, UriKind uriKind);
public static bool IsWellFormedUriString (string uriString, UriKind uriKind);
static member IsWellFormedUriString : string * UriKind -> bool

Parameter

uriString
String String String

Die Zeichenfolge, mit der ein Uri erstellt werden soll.The string used to attempt to construct a Uri.

uriKind
UriKind UriKind UriKind

Der Typ des Uri in uriString.The type of the Uri in uriString.

Gibt zurück

true, wenn die Zeichenfolge wohlgeformt ist, andernfalls false.true if the string was well-formed; otherwise, false.

Hinweise

In Versionen von .net vor Version 4,5 wird die Zeichenfolge standardmäßig in Übereinstimmung mit RFC 2396 und RFC 2732 als wohl geformt betrachtet.In versions of .NET before version 4.5, by default the string is considered well-formed in accordance with RFC 2396 and RFC 2732. Wenn die bialisierung von International Resource Identifier (IRIS) oder Internationalized Domain Name (IDN) aktiviert ist, wird die Zeichenfolge in Übereinstimmung mit RFC 3986 und RFC 3987 als wohl geformt betrachtet.If International Resource Identifiers (IRIs) or Internationalized Domain Name (IDN) parsing are enabled, the string is considered well-formed in accordance with RFC 3986 and RFC 3987.

Ab .NET 4,5 werden Zeichen folgen in Übereinstimmung mit RFC 3986 und RFC 3987 immer als wohl geformt betrachtet, unabhängig davon, ob IRI oder IDN aktiviert ist.Beginning in .NET 4.5, strings are always considered well-formed in accordance with RFC 3986 and RFC 3987, whether or not IRI or IDN are enabled. Beachten Sie jedoch, dass dies nur für apps gilt, die auf .NET 4,5 oder höher ausgerichtet sind.Note, however, that this is only true for apps that target .NET 4.5 or later. Apps, die auf .NET 4,0 abzielen, rufen Kompatibilitäts Code auf und erleben das alte Verhalten (vor 4,5).Apps that target .NET 4.0 invoke compatibility code, and experience the old (pre-4.5) behavior.

Die Zeichenfolge wird als unzureichend formatiert angesehen und bewirkt, dass die Methode "false" zurückgibt, wenn eine der folgenden Bedingungen zutrifft:The string is considered poorly formed, causing the method to return false, if any of the following conditions occur

FehlerError BeispielExample
Die Zeichenfolge ist nicht korrekt mit Escapezeichen versehen.The string is not correctly escaped. http://www.contoso.com/path???/file name
Die Zeichenfolge ist eine absolute Uri, die eine implizite Datei Uri darstellt.The string is an absolute Uri that represents an implicit file Uri. c:\\directory\filename
Bei der Zeichenfolge handelt es sich um einen absoluten URI, dem ein Schrägstrich vor dem Pfad fehlt.The string is an absolute URI that is missing a slash before the path. file://c:/directory/filename
Die Zeichenfolge enthält umgekehrte Schrägstriche ohne Escapezeichen, auch wenn Sie als Schrägstriche behandelt werden.The string contains unescaped backslashes even if they will be treated as forward slashes http:\\\host/path/file
Die Zeichenfolge stellt eine hierarchische absolute Uri dar und enthält nicht "://".The string represents a hierarchical absolute Uri and does not contain "://" www.contoso.com/path/file
Der Parser für den Scheme gibt an, dass die ursprüngliche Zeichenfolge nicht wohl geformt ist.The parser for the Scheme indicates that the original string was not well-formed. Das Beispiel hängt vom Schema des URIs ab.The example depends on the scheme of the URI.
Ab .NET 4,5 werden relative URIs mit einem Doppelpunkt (': ') im ersten Segment nicht als wohl geformt betrachtet.Beginning with .NET 4.5, relative URIs with a colon (':') in their first segment are not considered well-formed. 2013.05.29_14:33:41

Weitere Informationen zur IRI-Unterstützung finden Sie im Abschnitt "Hinweise" für die Uri-Klasse.For more information on IRI support, see the Remarks section for the Uri class.

Gilt für:

Siehe auch