Uri.IsWellFormedUriString(String, UriKind) Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Source:

UriExt.cs

Indica si la cadena tiene el formato correcto al intentar construir un URI con ella y garantiza que la cadena no requiere después secuencias de escape.

public:
 static bool IsWellFormedUriString(System::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

Cadena usada para intentar construir un Uri.

uriKind

UriKind

Tipo del Uri en uriString.

Devoluciones

Boolean

true si la cadena tiene el formato correcto; de lo contrario, false.

Comentarios

En las versiones de .NET anteriores a la versión 4.5, la cadena se considera correctamente formada de acuerdo con RFC 2396 y RFC 2732. Si se habilitan los identificadores de recursos internacionales (IRIs) o el análisis de nombres de dominio internacionalizados (IDN), la cadena se considera bien formada de acuerdo con RFC 3986 y RFC 3987.

A partir de .NET 4.5, las cadenas siempre se consideran bien formadas de acuerdo con RFC 3986 y RFC 3987, independientemente de si están habilitados o no IRI o IDN. Sin embargo, tenga en cuenta que esto solo es cierto para las aplicaciones que tienen como destino .NET 4.5 o posterior. Las aplicaciones destinadas a .NET 4.0 invocan código de compatibilidad y experimentan el comportamiento anterior (anterior a la 4.5).

La cadena se considera mal formada, lo que hace que el método devuelva false, si se produce alguna de las condiciones siguientes.

Error	Ejemplo
La cadena no se ha escape correctamente.	http://www.contoso.com/path???/file name
La cadena es absoluta Uri que representa un archivo Uriimplícito.	c:\\directory\filename
La cadena es un URI absoluto que falta una barra diagonal antes de la ruta de acceso.	file://c:/directory/filename
La cadena contiene barras diagonales inversas sin escape, incluso si se tratarán como barras diagonales	http:\\\host/path/file
La cadena representa un absoluto Uri jerárquico y no contiene "://"	www.contoso.com/path/file
El analizador de Scheme indica que la cadena original no tiene el formato correcto.	El ejemplo depende del esquema del URI.
A partir de .NET 4.5, los URI relativos con dos puntos (":") en su primer segmento no se consideran bien formados.	2013.05.29_14:33:41

Para obtener más información sobre la compatibilidad con IRI, vea la sección Comentarios de la Uri clase .

Consulte también

• Grupo de trabajo de ingeniería de Internet (IETF)