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 standardmäßig die Zeichenfolge wohlgeformt in Übereinstimmung mit RFC 2396 und RFC 2732 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 es sich bei International Resource Identifiers (IRIs) oder Analysieren von Internationalized Domain Name (IDN) aktiviert ist, wird die Zeichenfolge wohlgeformt in Übereinstimmung mit RFC 3986 und RFC 3987 angesehen.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 ist Zeichenfolgen werden immer als wohlgeformt in Übereinstimmung mit RFC 3986 und RFC 3987, unabhängig davon, ob IRI oder IDN aktiviert sind.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, die.NET 4.5 ausgerichtet, sind "true" oder höher.Note, however, that this is only true for apps that target .NET 4.5 or later. Apps, die auf .NET 4.0 ausgerichtet Kompatibilität Code aufrufen und das alte Verhalten (vor 4.5) auftreten.Apps that target .NET 4.0 invoke compatibility code, and experience the old (pre-4.5) behavior.

Die Zeichenfolge wird als fehlerhaft formuliert, dass die Methode false zurückgibt, wenn eine der folgenden Bedingungen eintrittThe string is considered poorly formed, causing the method to return false, if any of the following conditions occur

FehlerError BeispielExample
Die Zeichenfolge ist nicht ordnungsgemäß mit Escapezeichen versehen.The string is not correctly escaped. http://www.contoso.com/path???/file Namehttp://www.contoso.com/path???/file name
Die Zeichenfolge ist ein absoluter Uri , die eine implizite Datei darstellt Uri.The string is an absolute Uri that represents an implicit file Uri. "c:"\\directory\filenamec:\\directory\filename
Die Zeichenfolge ist ein absoluter URI, der einen Schrägstrich vor dem Pfad nicht vorhanden ist.The string is an absolute URI that is missing a slash before the path. file://c:/directory/filenamefile://c:/directory/filename
Die Zeichenfolge enthält umgekehrte Schrägstriche ohne Escapezeichen, auch wenn sie als Schrägstriche behandelt werdenThe string contains unescaped backslashes even if they will be treated as forward slashes http:\\host/path/filehttp:\\host/path/file
Die Zeichenfolge darstellt, einen hierarchischen absoluten Uri und enthält keine "://"The string represents a hierarchical absolute Uri and does not contain "://" www.contoso.com/path/filewww.contoso.com/path/file
Der Parser für die Scheme gibt an, dass die ursprüngliche Zeichenfolge nicht wohlgeformt war.The parser for the Scheme indicates that the original string was not well-formed. Im Beispiel hängt von dem Schema des URI ab.The example depends on the scheme of the URI.
Ab .NET 4.5, relativen URIs mit einem Doppelpunkt (":") im ersten Segment gelten nicht wohlgeformt.Beginning with .NET 4.5, relative URIs with a colon (':') in their first segment are not considered well-formed. 2013.05.29_14:33:412013.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