Uri.IsWellFormedUriString(String, UriKind) Método

Referência

Definição

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

IETF (Internet Engineering Task Force)

Compartilhar via