Uri.IsWellFormedUriString(String, UriKind) Método

  • Referência

Definição

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Indica se a cadeia de caracteres é bem formada pela tentativa de construir um URI com a cadeia de caracteres e garante que a cadeia de caracteres não requer mais de 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

Parâmetros

uriString
String

A cadeia de caracteres usada na tentativa de construir um Uri.

uriKind
UriKind

O tipo do Uri em uriString.

Retornos

Boolean

true se a cadeia de caracteres foi bem formada; caso contrário, false.

Comentários

Em versões do .NET antes da versão 4.5, por padrão, a cadeia de caracteres é considerada bem formada de acordo com o RFC 2396 e o RFC 2732. Se a análise de IDN (International Resource Identifiers) ou IDN (Internationalized Domain Name) estiver habilitada, a cadeia de caracteres será considerada bem formada de acordo com o RFC 3986 e o RFC 3987.

A partir do .NET 4.5, as cadeias de caracteres são sempre consideradas bem formadas de acordo com o RFC 3986 e o RFC 3987, se o IRI ou o IDN estão habilitados ou não. No entanto, observe que isso só é verdadeiro para aplicativos direcionados ao .NET 4.5 ou posterior. Aplicativos direcionados ao .NET 4.0 invocam código de compatibilidade e experimentam o comportamento antigo (pré-4.5).

A cadeia de caracteres é considerada mal formada, fazendo com que o método retorne false, se alguma das condições a seguir ocorrer

Erro Exemplo
A cadeia de caracteres não é escapada corretamente. http://www.contoso.com/path???/file name
A cadeia de caracteres é um absoluto Uri que representa um arquivo Uriimplícito. c:\\directory\filename
A cadeia de caracteres é um URI absoluto que está faltando uma barra antes do caminho. file://c:/directory/filename
A cadeia de caracteres contém cílios invertidos sem escape, mesmo que sejam tratados como barras para frente http:\\\host/path/file
A cadeia de caracteres representa um absoluto Uri hierárquico e não contém "://" www.contoso.com/path/file
O analisador para o Scheme indica que a cadeia de caracteres original não estava bem formada. O exemplo depende do esquema do URI.
A partir do .NET 4.5, URIs relativas com dois-pontos (':') no primeiro segmento não são consideradas bem formadas. 2013.05.29_14:33:41

Para obter mais informações sobre o suporte IRI, consulte a seção Comentários da classe Uri.

Aplica-se a

Confira também