Uri.IsWellFormedUriString(String, UriKind) Método

Definición

Espacio de nombres:
System
Ensamblados:
System.dll, System.Runtime.dll
Ensamblados:
netstandard.dll, System.Runtime.dll
Ensamblado:
System.Runtime.dll
Ensamblado:
System.dll
Ensamblado:
netstandard.dll
Source:
UriExt.cs
Source:
UriExt.cs
Source:
UriExt.cs
Source:
UriExt.cs
Source:
UriExt.cs

Indica si la cadena tiene un formato correcto al intentar construir un URI con la cadena y garantiza que la cadena no requiera un 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 -> bool
Public Shared Function IsWellFormedUriString (uriString As String, uriKind As UriKind) As Boolean

Parámetros

uriString
String

Cadena que se usa para intentar construir un Uri.

uriKind
UriKind

Tipo de en UriuriString.

Devoluciones

Boolean

true si la cadena tenía un formato correcto; de lo contrario, false.

Comentarios

En las versiones de .NET anteriores a la versión 4.5, de forma predeterminada, la cadena se considera bien 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 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 Example
La cadena no se ha escapado 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 un 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 .

Se aplica a

Consulte también