Uri.IsWellFormedUriString(String, UriKind) Метод

Определение

Указывает, является ли правильным формат данной строки, пытаясь создать на ее основе универсальный код ресурса и проверяя, не требуется ли для нее дополнительное преобразование в escape-последовательность.

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

Параметры

uriString
String

Строка, используемая при попытке создания объекта Uri.

uriKind
UriKind

Тип объекта Uri в параметре uriString.

Возвращаемое значение

Boolean

Значение true, если строка имеет правильный формат; в противном случае — значение false.

Комментарии

В версиях .NET до версии 4.5 строка по умолчанию считается правильно сформированной в соответствии с RFC 2396 и RFC 2732. Если включены синтаксический анализ международных идентификаторов ресурсов (IRIs) или международного доменного имени (IDN), строка считается правильно сформированной в соответствии с RFC 3986 и RFC 3987.

Начиная с .NET 4.5 строки всегда считаются хорошо сформированными в соответствии с RFC 3986 и RFC 3987 независимо от того, включены ли IRI или IDN. Однако обратите внимание, что это справедливо только для приложений, предназначенных для .NET 4.5 или более поздней версии. Приложения, предназначенные для .NET 4.0, вызывают код совместимости и испытывают старое поведение (до 4.5).

Строка считается плохо сформированной, что приводит к возврату метода false, если возникает какое-либо из следующих условий.

Ошибка Пример
Строка неправильно экранирована. http://www.contoso.com/path???/file name
Строка является абсолютной Uri , которая представляет неявный файл Uri. c:\\directory\filename
Строка является абсолютным универсальным кодом ресурса (URI), который отсутствует косая черта перед путем. file://c:/directory/filename
Строка содержит неэкранированные обратные косые черты, даже если они будут рассматриваться как косая черта. http:\\\host/path/file
Строка представляет иерархическое абсолютное и Uri не содержит "://" www.contoso.com/path/file
Средство синтаксического анализа Scheme указывает, что исходная строка была неправильно сформирована. Пример зависит от схемы URI.
Начиная с .NET 4.5 относительные URI с двоеточием (":") в первом сегменте не считаются хорошо сформированными. 2013.05.29_14:33:41

Дополнительные сведения о поддержке IRI см. в Uri разделе "Примечания" для класса.

Применяется к

См. также раздел