Uri.IsWellFormedUriString(String, UriKind) Método

Definición

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.Indicates whether the string is well-formed by attempting to construct a URI with the string and ensures that the string does not require further escaping.

public:
 static bool IsWellFormedUriString(System::String ^ uriString, UriKind uriKind);
public static bool IsWellFormedUriString (string uriString, UriKind uriKind);
static member IsWellFormedUriString : string * UriKind -> bool

Parámetros

uriString
String

Cadena usada para intentar construir un Uri.The string used to attempt to construct a Uri.

uriKind
UriKind

Tipo del Uri en uriString.The type of the Uri in uriString.

Devoluciones

true si la cadena tiene el formato correcto; de lo contrario, false.true if the string was well-formed; otherwise, 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.In versions of .NET before version 4.5, by default the string is considered well-formed in accordance with RFC 2396 and RFC 2732. Si los identificadores de recursos internacionales (IRIs) o el análisis de nombres de dominio internacionalizados (IDN) están habilitados, la cadena se considera bien formada de acuerdo con RFC 3986 y RFC 3987.If International Resource Identifiers (IRIs) or Internationalized Domain Name (IDN) parsing are enabled, the string is considered well-formed in accordance with RFC 3986 and RFC 3987.

A partir de .NET 4,5, las cadenas se consideran siempre bien formadas de acuerdo con RFC 3986 y RFC 3987, tanto si IRI como IDN están habilitados.Beginning in .NET 4.5, strings are always considered well-formed in accordance with RFC 3986 and RFC 3987, whether or not IRI or IDN are enabled. Sin embargo, tenga en cuenta que esto solo es válido para las aplicaciones destinadas a .NET 4,5 o posterior.Note, however, that this is only true for apps that target .NET 4.5 or later. Las aplicaciones destinadas a .NET 4,0 invocan código de compatibilidad y experimentan el comportamiento anterior (anterior a 4,5).Apps that target .NET 4.0 invoke compatibility code, and experience the old (pre-4.5) behavior.

La cadena se considera incorrecta, lo que hace que el método devuelva false, si se produce alguna de las condiciones siguientes:The string is considered poorly formed, causing the method to return false, if any of the following conditions occur

ErrorError EjemploExample
La cadena no tiene un carácter de escape correcto.The string is not correctly escaped. http://www.contoso.com/path???/file name
La cadena es una Uri absoluta que representa un Uride archivos implícito.The string is an absolute Uri that represents an implicit file Uri. c:\\directory\filename
La cadena es un URI absoluto al que le falta una barra diagonal antes de la ruta de acceso.The string is an absolute URI that is missing a slash before the path. file://c:/directory/filename
La cadena contiene barras diagonales inversas sin escape, aunque se traten como barras diagonales.The string contains unescaped backslashes even if they will be treated as forward slashes http:\\\host/path/file
La cadena representa una Uri absoluta jerárquica y no contiene "://"The string represents a hierarchical absolute Uri and does not contain "://" www.contoso.com/path/file
El analizador del Scheme indica que la cadena original no tenía el formato correcto.The parser for the Scheme indicates that the original string was not well-formed. El ejemplo depende del esquema del URI.The example depends on the scheme of the URI.
A partir de .NET 4,5, los URI relativos con un signo de dos puntos (': ') en su primer segmento no se consideran correctos.Beginning with .NET 4.5, relative URIs with a colon (':') in their first segment are not considered well-formed. 2013.05.29_14:33:41

Para obtener más información sobre la compatibilidad con IRI, consulte la sección Comentarios de la clase Uri.For more information on IRI support, see the Remarks section for the Uri class.

Se aplica a

Consulte también: