Uri.IsWellFormedUriString(String, UriKind) Método
Definição
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 está bem formada ao tentar construir um URI com a cadeia de caracteres e garante que a cadeia de caracteres não exija escape adicional.
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 -> boolPublic Shared Function IsWellFormedUriString (uriString As String, uriKind As UriKind) As BooleanParâmetros
Retornos
true se a cadeia de caracteres estava bem formada; caso contrário, false.
Comentários
Em versões de .NET antes da versão 4.5, por padrão, a cadeia de caracteres é considerada bem formada de acordo com RFC 2396 e RFC 2732. Se a análise de IRIs (International Resource Identifiers) ou IDN (Internationalized Domain Name) estiver habilitada, a cadeia de caracteres será considerada bem formada de acordo com RFC 3986 e RFC 3987.
A partir do .NET 4.5, as cadeias de caracteres são sempre consideradas bem formadas de acordo com RFC 3986 e RFC 3987, independentemente de IRI ou IDN estarem habilitadas ou não. Observe, no entanto, que isso só é verdadeiro para aplicativos destinados .NET 4.5 ou posterior. Os aplicativos destinados .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 | Example |
|---|---|
| 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 barras invertidas sem escape, mesmo que sejam tratadas 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. |
| Começando com .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 a IRI, consulte a seção Comentários da Uri classe.
