Uri.IsWellFormedUriString(String, UriKind) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Indica se a cadeia está bem formada ao tentar construir um URI com a cadeia e garante que a cadeia não precisa de mais fugas.
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
Devoluções
true se a corda estivesse bem formada; caso contrário, false.
Observações
Nas versões do .NET anteriores à versão 4.5, por defeito a cadeia é considerada bem formada de acordo com o RFC 2396 e o RFC 2732. Se os Identificadores Internacionais de Recursos (IRIs) ou a análise sintática de Nomes de Domínio Internacionalizados (IDN) estiverem ativados, a cadeia é considerada bem formada de acordo com o RFC 3986 e o RFC 3987.
A partir do .NET 4.5, as strings são sempre consideradas bem formadas de acordo com o RFC 3986 e o RFC 3987, independentemente de IRI ou IDN estarem ou não ativados. Note-se, no entanto, que isto só é verdade para aplicações que visam .NET 4.5 ou posteriores. As aplicações que têm como alvo .NET 4.0 invocam código de compatibilidade e experienciam o comportamento antigo (pré-4.5).
A cadeia é considerada mal formada, fazendo com que o método devolva falso, caso alguma das seguintes condições ocorra
| Erro | Example |
|---|---|
| A corda não está corretamente escapada. | http://www.contoso.com/path???/file name |
| A cadeia é um absoluto Uri que representa um ficheiro Uriimplícito . | c:\\directory\filename |
| A cadeia é um URI absoluto que não tem uma barra antes do caminho. | file://c:/directory/filename |
| A corda contém barras para trás sem escapar, mesmo que sejam tratadas como barras para a frente | http:\\\host/path/file |
| A cadeia 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 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 mais informações sobre o apoio ao IRI, consulte a secção de Observações da Uri disciplina.
