Udostępnij za pośrednictwem


Uri.IsWellFormedUriString(String, UriKind) Metoda

Definicja

Wskazuje, czy ciąg jest dobrze sformułowany, próbując skonstruować identyfikator URI za pomocą ciągu i gwarantuje, że ciąg nie wymaga dalszego ucieczki.

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

Parametry

uriString
String

Ciąg używany do próby skonstruowania .Uri

uriKind
UriKind

Typ elementu w uriStringelemecie Uri .

Zwraca

true jeśli ciąg został dobrze sformułowany; w przeciwnym razie , false.

Uwagi

W wersjach platformy .NET przed wersją 4.5 domyślnie ciąg jest uznawany za dobrze sformułowany zgodnie z RFC 2396 i RFC 2732. Jeśli włączono analizowanie międzynarodowych identyfikatorów zasobów (IRI) lub międzynarodowych nazw domen (IDN), ciąg jest uznawany za dobrze sformułowany zgodnie z RFC 3986 i RFC 3987.

Począwszy od platformy .NET 4.5, ciągi są zawsze uznawane za dobrze sformułowane zgodnie z RFC 3986 i RFC 3987, bez względu na to, czy są włączone IRI, czy IDN. Należy jednak pamiętać, że dotyczy to tylko aplikacji przeznaczonych dla platformy .NET 4.5 lub nowszej. Aplikacje przeznaczone dla platformy .NET 4.0 wywołują kod zgodności i doświadczają starego zachowania (pre-4.5).

Ciąg jest uznawany za słabo sformułowany, powodując zwrócenie wartości false przez metodę , jeśli wystąpi którykolwiek z poniższych warunków

Błąd Przykład
Ciąg nie został poprawnie uniknięty. http://www.contoso.com/path???/file name
Ciąg jest bezwzględnym Uri , który reprezentuje niejawny plik Uri. c:\\directory\filename
Ciąg jest bezwzględnym identyfikatorem URI, który brakuje ukośnika przed ścieżką. file://c:/directory/filename
Ciąg zawiera niezapieczętowane ukośniki odwrotne, nawet jeśli będą traktowane jako ukośniki do przodu http:\\\host/path/file
Ciąg reprezentuje bezwzględny Uri hierarchiczny i nie zawiera "://" www.contoso.com/path/file
Analizator parametru Scheme wskazuje, że oryginalny ciąg nie został dobrze sformułowany. Przykład zależy od schematu identyfikatora URI.
Począwszy od platformy .NET 4.5, względne identyfikatory URI z dwukropkiem (':') w pierwszym segmencie nie są uznawane za dobrze sformułowane. 2013.05.29_14:33:41

Aby uzyskać więcej informacji na temat obsługi IRI, zobacz sekcję Uwagi dla Uri klasy.

Dotyczy

Zobacz też