Uri.IsWellFormedUriString(String, UriKind) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System

Zestaw:: System.Runtime.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Źródło:: UriExt.cs

Źródło:: UriExt.cs

Źródło:: UriExt.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

Boolean

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ż

Internet Engineering Task Force (IETF)