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
Параметры
Возвращаемое значение
Значение 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 разделе "Примечания" для класса.