Uri Uri Uri Uri Constructors

Definición

Sobrecargas

Uri(String) Uri(String) Uri(String) Uri(String)

Inicializa una nueva instancia de la clase Uri con el identificador URI especificado.Initializes a new instance of the Uri class with the specified URI.

Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase Uri desde las instancias especificadas de las clases SerializationInfo y StreamingContext.Initializes a new instance of the Uri class from the specified instances of the SerializationInfo and StreamingContext classes.

Uri(String, Boolean) Uri(String, Boolean) Uri(String, Boolean) Uri(String, Boolean)

Inicializa una nueva instancia de la clase Uri con el identificador URI especificado, con control explícito de la secuencia de escape de carácter.Initializes a new instance of the Uri class with the specified URI, with explicit control of character escaping.

Uri(String, UriKind) Uri(String, UriKind) Uri(String, UriKind)

Inicializa una nueva instancia de la clase Uri con el identificador URI especificado.Initializes a new instance of the Uri class with the specified URI. Este constructor permite especificar si la cadena URI corresponde a un identificador URI relativo, a un identificador URI absoluto, o si está sin determinar.This constructor allows you to specify if the URI string is a relative URI, absolute URI, or is indeterminate.

Uri(Uri, String) Uri(Uri, String) Uri(Uri, String) Uri(Uri, String)

Inicializa una nueva instancia de la clase Uri basada en la cadena especificada de identificador URI base y relativo.Initializes a new instance of the Uri class based on the specified base URI and relative URI string.

Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri)

Inicializa una nueva instancia de la clase Uri basada en la combinación de una instancia especificada de Uri base y una instancia de Uri relativo.Initializes a new instance of the Uri class based on the combination of a specified base Uri instance and a relative Uri instance.

Uri(Uri, String, Boolean) Uri(Uri, String, Boolean) Uri(Uri, String, Boolean) Uri(Uri, String, Boolean)

Inicializa una nueva instancia de la clase Uri basada en los identificadores URI base y relativo especificados, con control explícito de la secuencia de escape de carácter.Initializes a new instance of the Uri class based on the specified base and relative URIs, with explicit control of character escaping.

Uri(String) Uri(String) Uri(String) Uri(String)

Inicializa una nueva instancia de la clase Uri con el identificador URI especificado.Initializes a new instance of the Uri class with the specified URI.

public:
 Uri(System::String ^ uriString);
public Uri (string uriString);
new Uri : string -> Uri
Public Sub New (uriString As String)

Parámetros

uriString
String String String String

Cadena que identifica el recurso que la instancia de Uri va a representar.A string that identifies the resource to be represented by the Uri instance. Tenga en cuenta que las direcciones IPv6 en forma de cadena deben indicarse entre corchetes.Note that an IPv6 address in string form must be enclosed within brackets. Por ejemplo, "http://[2607:f8b0:400d:c06::69]".For example, "http://[2607:f8b0:400d:c06::69]".

Excepciones

Nota: En .NET para aplicaciones de la Tienda Windows o la Biblioteca de clases portable, capture en su lugar la excepción de clase base, FormatException.Note: In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

uriString está vacía.uriString is empty.

O bien-or- El esquema especificado en uriString no está formado correctamente.The scheme specified in uriString is not correctly formed. Vea CheckSchemeName(String).See CheckSchemeName(String).

o bien-or- uriString contiene demasiadas barras diagonales.uriString contains too many slashes.

O bien-or- La contraseña especificada en uriString no es válida.The password specified in uriString is not valid.

o bien-or- El nombre de host especificado en uriString no es válido.The host name specified in uriString is not valid.

O bien-or- El nombre de archivo especificado en uriString no es válido.The file name specified in uriString is not valid.

o bien-or- El nombre de usuario especificado en uriString no es válido.The user name specified in uriString is not valid.

o bien-or- El nombre de host o de autoridad especificado en uriString no puede terminar con barras diagonales inversas.The host or authority name specified in uriString cannot be terminated by backslashes.

o bien-or- El número de puerto especificado en uriString no es válido o no se puede analizar.The port number specified in uriString is not valid or cannot be parsed.

O bien-or- La longitud de uriString supera los 65 519 caracteres.The length of uriString exceeds 65519 characters.

O bien-or- La longitud del esquema especificado en uriString supera los 1023 caracteres.The length of the scheme specified in uriString exceeds 1023 characters.

o bien-or- Existe una secuencia de caracteres no válida en uriString.There is an invalid character sequence in uriString.

O bien-or- La ruta de acceso a MS-DOS especificada en uriString debe comenzar por c:\\.The MS-DOS path specified in uriString must start with c:\\.

Ejemplos

En el ejemplo siguiente se crea una instancia de Uri con el URI http://www.contoso.com/.The following example creates a Uri instance with the URI http://www.contoso.com/.

Uri^ baseUri = gcnew Uri( "http://www.contoso.com/" );
Uri myUri = new Uri("http://www.contoso.com/");

Dim myUri As New Uri("http://www.contoso.com/")

Comentarios

Este constructor crea una instancia de Uri a partir de una cadena de URI.This constructor creates a Uri instance from a URI string. Analiza el URI, lo pone en formato canónico y realiza las codificaciones de escape necesarias.It parses the URI, puts it in canonical format, and makes any required escape encodings.

Este constructor no garantiza que el Uri hace referencia a un recurso accesible.This constructor does not ensure that the Uri refers to an accessible resource.

Este constructor supone que el parámetro string hace referencia a un URI absoluto y es equivalente a llamar al constructor Uri con @no__t 2 establecido en Absolute.This constructor assumes that the string parameter references an absolute URI and is equivalent to calling the Uri constructor with UriKind set to Absolute. Si el parámetro string que se pasa al constructor es un URI relativo, este constructor producirá una UriFormatException.If the string parameter passed to the constructor is a relative URI, this constructor will throw a UriFormatException.

Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext)

Inicializa una nueva instancia de la clase Uri desde las instancias especificadas de las clases SerializationInfo y StreamingContext.Initializes a new instance of the Uri class from the specified instances of the SerializationInfo and StreamingContext classes.

protected:
 Uri(System::Runtime::Serialization::SerializationInfo ^ serializationInfo, System::Runtime::Serialization::StreamingContext streamingContext);
protected Uri (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);
new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri

Parámetros

serializationInfo
SerializationInfo SerializationInfo SerializationInfo SerializationInfo

Instancia de la clase SerializationInfo que contiene la información necesaria para serializar la nueva instancia de Uri.An instance of the SerializationInfo class containing the information required to serialize the new Uri instance.

streamingContext
StreamingContext StreamingContext StreamingContext StreamingContext

Instancia de la clase StreamingContext que contiene el origen del flujo serializado asociado a la nueva instancia de Uri.An instance of the StreamingContext class containing the source of the serialized stream associated with the new Uri instance.

Excepciones

El parámetro serializationInfo contiene un URI null.The serializationInfo parameter contains a null URI.

El serializationInfo parámetro contiene un URI que está vacío.The serializationInfo parameter contains a URI that is empty.

o bien-or- El esquema especificado no tiene el formato correcto.The scheme specified is not correctly formed. Vea CheckSchemeName(String).See CheckSchemeName(String).

O bien-or- El URI contiene demasiadas barras diagonales.The URI contains too many slashes.

o bien-or- La contraseña especificada en el URI no es válida.The password specified in the URI is not valid.

o bien-or- El nombre de host especificado en el URI no es válido.The host name specified in URI is not valid.

o bien-or- El nombre de archivo especificado en el URI no es válido.The file name specified in the URI is not valid.

o bien-or- El nombre de usuario especificado en el URI no es válido.The user name specified in the URI is not valid.

o bien-or- El nombre de host o de autoridad especificado en el URI no puede terminar con barras diagonales inversas.The host or authority name specified in the URI cannot be terminated by backslashes.

o bien-or- El número de puerto especificado en el URI no es válido o no se puede analizar.The port number specified in the URI is not valid or cannot be parsed.

O bien-or- La longitud del URI supera los 65 519 caracteres.The length of URI exceeds 65519 characters.

o bien-or- La longitud del esquema especificado en el URI supera los 1023 caracteres.The length of the scheme specified in the URI exceeds 1023 characters.

o bien-or- Existe una secuencia de caracteres no válida en el URI.There is an invalid character sequence in the URI.

o bien-or- La ruta de acceso a MS-DOS especificada en el URI debe comenzar por c:\\.The MS-DOS path specified in the URI must start with c:\\.

Comentarios

Este constructor implementa la interfaz ISerializable para la clase Uri.This constructor implements the ISerializable interface for the Uri class.

Consulte también:

Uri(String, Boolean) Uri(String, Boolean) Uri(String, Boolean) Uri(String, Boolean)

Advertencia

Esta API está ya obsoleta.

Inicializa una nueva instancia de la clase Uri con el identificador URI especificado, con control explícito de la secuencia de escape de carácter.Initializes a new instance of the Uri class with the specified URI, with explicit control of character escaping.

public:
 Uri(System::String ^ uriString, bool dontEscape);
[System.Obsolete("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202")]
[System.Obsolete("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri (string uriString, bool dontEscape);
new Uri : string * bool -> Uri
Public Sub New (uriString As String, dontEscape As Boolean)

Parámetros

uriString
String String String String

Cadena que identifica el recurso que la instancia de Uri va a representar.A string that identifies the resource to be represented by the Uri instance. Tenga en cuenta que las direcciones IPv6 en forma de cadena deben indicarse entre corchetes.Note that an IPv6 address in string form must be enclosed within brackets. Por ejemplo, "http://[2607:f8b0:400d:c06::69]".For example, "http://[2607:f8b0:400d:c06::69]".

dontEscape
Boolean Boolean Boolean Boolean

Es true si uriString es totalmente de escape; en caso contrario, es false.true if uriString is completely escaped; otherwise, false.

Excepciones

uriString está vacío o sólo contiene espacios.uriString is empty or contains only spaces.

O bien-or- El esquema especificado en uriString no es válido.The scheme specified in uriString is not valid.

o bien-or- uriString contiene demasiadas barras diagonales.uriString contains too many slashes.

o bien-or- La contraseña especificada en uriString no es válida.The password specified in uriString is not valid.

O bien-or- El nombre de host especificado en uriString no es válido.The host name specified in uriString is not valid.

O bien-or- El nombre de archivo especificado en uriString no es válido.The file name specified in uriString is not valid.

o bien-or- El nombre de usuario especificado en uriString no es válido.The user name specified in uriString is not valid.

O bien-or- El nombre de host o de autoridad especificado en uriString no puede terminar con barras diagonales inversas.The host or authority name specified in uriString cannot be terminated by backslashes.

o bien-or- El número de puerto especificado en uriString no es válido o no se puede analizar.The port number specified in uriString is not valid or cannot be parsed.

o bien-or- La longitud de uriString supera los 65 519 caracteres.The length of uriString exceeds 65519 characters.

o bien-or- La longitud del esquema especificado en uriString supera los 1023 caracteres.The length of the scheme specified in uriString exceeds 1023 characters.

O bien-or- Existe una secuencia de caracteres no válida en uriString.There is an invalid character sequence in uriString.

o bien-or- La ruta de acceso a MS-DOS especificada en uriString debe comenzar por c:\\.The MS-DOS path specified in uriString must start with c:\\.

Ejemplos

En el ejemplo siguiente se crea una instancia de Uri para el URI http://www.contoso.com/Hello%20World.htm.The following example creates a Uri instance for the URI http://www.contoso.com/Hello%20World.htm. Dado que el URI contenido tiene un carácter de escape completo y está en formato canónico, el parámetro dontEscape se puede establecer en true.Because the contained URI is completely escaped and is in canonical form, the dontEscape parameter can be set to true.

Uri^ myUri = gcnew Uri(  "http://www.contoso.com/Hello%20World.htm",true );
Uri myUri = new Uri("http://www.contoso.com/Hello%20World.htm", true);

Dim myUri As New Uri("http://www.contoso.com/Hello%20World.htm", True)

Comentarios

Este constructor crea una instancia de Uri a partir de una cadena de URI.This constructor creates a Uri instance from a URI string. Analiza el URI y lo pone en formato canónico.It parses the URI and puts it in canonical format.

El parámetro dontEscape controla si los caracteres reservados se traducen en secuencias de escape.The dontEscape parameter controls whether reserved characters are translated into escape sequences. Este parámetro debe establecerse en true solo si está seguro de que todos los caracteres reservados en el URI tienen un carácter de escape.This parameter should be set to true only if you are certain that all reserved characters in the URI have been escaped. Si se establece el valor en true para un URI que no tiene un carácter de escape completo, puede producirse un comportamiento inesperado.Setting the value to true for a URI that has not been completely escaped can cause unexpected behavior. Se recomienda encarecidamente que siempre establezca este parámetro en false.It is strongly recommended that you always set this parameter to false.

Si dontEscape se establece en false, el constructor realiza el escape de los caracteres reservados mediante la comprobación de que todas las apariciones del porcentaje (%) van seguidos de una secuencia de escape válida.If dontEscape is set to false, the constructor escapes any reserved characters by checking that all occurrences of percent (%) are followed by a valid escape sequence. Si la secuencia de caracteres que sigue a un porcentaje no es válida, el porcentaje se sustituye por% 25.If the character sequence following a percent is not valid, the percent is replaced by %25.

Este constructor no garantiza que el Uri hace referencia a un recurso accesible.This constructor does not ensure that the Uri refers to an accessible resource.

Uri(String, UriKind) Uri(String, UriKind) Uri(String, UriKind)

Inicializa una nueva instancia de la clase Uri con el identificador URI especificado.Initializes a new instance of the Uri class with the specified URI. Este constructor permite especificar si la cadena URI corresponde a un identificador URI relativo, a un identificador URI absoluto, o si está sin determinar.This constructor allows you to specify if the URI string is a relative URI, absolute URI, or is indeterminate.

public:
 Uri(System::String ^ uriString, UriKind uriKind);
public Uri (string uriString, UriKind uriKind);
new Uri : string * UriKind -> Uri

Parámetros

uriString
String String String String

Cadena que identifica el recurso que la instancia de Uri va a representar.A string that identifies the resource to be represented by the Uri instance. Tenga en cuenta que las direcciones IPv6 en forma de cadena deben indicarse entre corchetes.Note that an IPv6 address in string form must be enclosed within brackets. Por ejemplo, "http://[2607:f8b0:400d:c06::69]".For example, "http://[2607:f8b0:400d:c06::69]".

uriKind
UriKind UriKind UriKind UriKind

Especifica si la cadena URI es un identificador URI relativo, un identificador URI absoluto, o si está sin determinar.Specifies whether the URI string is a relative URI, absolute URI, or is indeterminate.

Excepciones

uriKind no es válido.uriKind is invalid.

Nota: En .NET para aplicaciones de la Tienda Windows o la Biblioteca de clases portable, capture en su lugar la excepción de clase base, FormatException.Note: In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

uriString contiene un URI relativo y uriKind es Absolute.uriString contains a relative URI and uriKind is Absolute.

oor uriString contiene un URI absoluto y uriKind es Relative.uriString contains an absolute URI and uriKind is Relative.

oor uriString está vacía.uriString is empty.

O bien-or- El esquema especificado en uriString no está formado correctamente.The scheme specified in uriString is not correctly formed. Vea CheckSchemeName(String).See CheckSchemeName(String).

O bien-or- uriString contiene demasiadas barras diagonales.uriString contains too many slashes.

O bien-or- La contraseña especificada en uriString no es válida.The password specified in uriString is not valid.

o bien-or- El nombre de host especificado en uriString no es válido.The host name specified in uriString is not valid.

O bien-or- El nombre de archivo especificado en uriString no es válido.The file name specified in uriString is not valid.

O bien-or- El nombre de usuario especificado en uriString no es válido.The user name specified in uriString is not valid.

o bien-or- El nombre de host o de autoridad especificado en uriString no puede terminar con barras diagonales inversas.The host or authority name specified in uriString cannot be terminated by backslashes.

O bien-or- El número de puerto especificado en uriString no es válido o no se puede analizar.The port number specified in uriString is not valid or cannot be parsed.

O bien-or- La longitud de uriString supera los 65 519 caracteres.The length of uriString exceeds 65519 characters.

o bien-or- La longitud del esquema especificado en uriString supera los 1023 caracteres.The length of the scheme specified in uriString exceeds 1023 characters.

O bien-or- Existe una secuencia de caracteres no válida en uriString.There is an invalid character sequence in uriString.

o bien-or- La ruta de acceso a MS-DOS especificada en uriString debe comenzar por c:\\.The MS-DOS path specified in uriString must start with c:\\.

Comentarios

Los URI relativos y absolutos tienen restricciones diferentes en su formato.Relative and absolute URIs have different restrictions on their format. Por ejemplo, un URI relativo no requiere un esquema ni una autoridad.For example, a relative URI does not require a scheme or an authority. El valor que especifique en uriKind debe coincidir con el tipo de URI pasado en uriString.The value you specify in uriKind must match the type of URI passed in uriString. Sin embargo, si se especifica RelativeOrAbsolute, la cadena del URI puede ser relativa o absoluta.However, if RelativeOrAbsolute is specified, the URI string can be relative or absolute.

Uri(Uri, String) Uri(Uri, String) Uri(Uri, String) Uri(Uri, String)

Inicializa una nueva instancia de la clase Uri basada en la cadena especificada de identificador URI base y relativo.Initializes a new instance of the Uri class based on the specified base URI and relative URI string.

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri);
public Uri (Uri baseUri, string relativeUri);
new Uri : Uri * string -> Uri
Public Sub New (baseUri As Uri, relativeUri As String)

Parámetros

baseUri
Uri Uri Uri Uri

Identificador URI base.The base URI.

relativeUri
String String String String

Identificador URI relativo que se va a agregar al identificador URI base.The relative URI to add to the base URI.

Excepciones

baseUri no es una instancia Uri absoluta.baseUri is not an absolute Uri instance.

Nota: En .NET para aplicaciones de la Tienda Windows o la Biblioteca de clases portable, capture en su lugar la excepción de clase base, FormatException.Note: In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

El URI formado mediante la combinación de baseUri y relativeUri está vacío o solo contiene espacios en blanco.The URI formed by combining baseUri and relativeUri is empty or contains only spaces.

O bien-or- El esquema especificado en el URI formado mediante la combinación de baseUri y relativeUri no es válido.The scheme specified in the URI formed by combining baseUri and relativeUri is not valid.

o bien-or- El URI formado mediante la combinación de baseUri y relativeUri contiene demasiadas barras diagonales.The URI formed by combining baseUri and relativeUri contains too many slashes.

o bien-or- La contraseña especificada en el URI formado mediante la combinación de baseUri y relativeUri no es válida.The password specified in the URI formed by combining baseUri and relativeUri is not valid.

o bien-or- El nombre de host especificado en el URI formado mediante la combinación de baseUri y relativeUri no es válido.The host name specified in the URI formed by combining baseUri and relativeUri is not valid.

O bien-or- El nombre de archivo especificado en el URI formado mediante la combinación de baseUri y relativeUri no es válido.The file name specified in the URI formed by combining baseUri and relativeUri is not valid.

o bien-or- El nombre de usuario especificado en el URI formado mediante la combinación de baseUri y relativeUri no es válido.The user name specified in the URI formed by combining baseUri and relativeUri is not valid.

O bien-or- El nombre de host o de autoridad especificado en el URI formado mediante la combinación de baseUri y relativeUri no puede terminar con barras diagonales inversas.The host or authority name specified in the URI formed by combining baseUri and relativeUri cannot be terminated by backslashes.

O bien-or- El número de puerto especificado en el URI formado mediante la combinación de baseUri y relativeUri no es válido o no se puede analizar.The port number specified in the URI formed by combining baseUri and relativeUri is not valid or cannot be parsed.

O bien-or- La longitud del URI formado mediante la combinación de baseUri y relativeUri supera los 65519 caracteres.The length of the URI formed by combining baseUri and relativeUri exceeds 65519 characters.

o bien-or- La longitud del esquema especificado en el URI formado mediante la combinación de baseUri y relativeUri supera los 1023 caracteres.The length of the scheme specified in the URI formed by combining baseUri and relativeUri exceeds 1023 characters.

O bien-or- Hay una secuencia de caracteres no válida en el URI formado mediante la combinación baseUri y relativeUri.There is an invalid character sequence in the URI formed by combining baseUri and relativeUri.

O bien-or- La ruta de acceso a MS-DOS especificada en uriString debe comenzar por c:\\.The MS-DOS path specified in uriString must start with c:\\.

Ejemplos

En el ejemplo siguiente se crea una nueva instancia de la clase Uri mediante la combinación de los URI relativos http://www.contoso.com y catalog/shownew.htm para formar el URI absoluto http://www.contoso.com/catalog/shownew.htm.The following example creates a new instance of the Uri class by combining the relative URIs http://www.contoso.com and catalog/shownew.htm to form the absolute URI http://www.contoso.com/catalog/shownew.htm.

Uri^ baseUri = gcnew Uri(  "http://www.contoso.com" );
Uri^ myUri = gcnew Uri( baseUri, "catalog/shownew.htm" );
Console::WriteLine( myUri->ToString() );
Uri baseUri = new Uri("http://www.contoso.com");
 Uri myUri = new Uri(baseUri, "catalog/shownew.htm");

Console.WriteLine(myUri.ToString());
   
Dim baseUri As New Uri("http://www.contoso.com")
Dim myUri As New Uri(baseUri, "catalog/shownew.htm")

Console.WriteLine(myUri.ToString())

Comentarios

Este constructor crea una instancia de Uri mediante la combinación de los baseUri y relativeUri.This constructor creates a Uri instance by combining the baseUri and the relativeUri. Si relativeUri es un URI absoluto (que contiene un esquema, un nombre de host y, opcionalmente, un número de puerto), la instancia de Uri se crea usando solo relativeUri.If relativeUri is an absolute URI (containing a scheme, host name, and optionally a port number), the Uri instance is created using only relativeUri.

Si el baseUri tiene partes relativas (como /api), la parte relativa debe terminar con una barra diagonal (como @no__t 2), si la parte relativa de baseUri se va a conservar en el Uri construido.If the baseUri has relative parts (like /api), then the relative part must be terminated with a slash, (like /api/), if the relative part of baseUri is to be preserved in the constructed Uri.

Además, si el relativeUri empieza con una barra diagonal, reemplazará cualquier parte relativa del baseUriAdditionally, if the relativeUri begins with a slash, then it will replace any relative part of the baseUri

Este constructor no garantiza que el Uri hace referencia a un recurso accesible.This constructor does not ensure that the Uri refers to an accessible resource.

Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri)

Inicializa una nueva instancia de la clase Uri basada en la combinación de una instancia especificada de Uri base y una instancia de Uri relativo.Initializes a new instance of the Uri class based on the combination of a specified base Uri instance and a relative Uri instance.

public:
 Uri(Uri ^ baseUri, Uri ^ relativeUri);
public Uri (Uri baseUri, Uri relativeUri);
new Uri : Uri * Uri -> Uri
Public Sub New (baseUri As Uri, relativeUri As Uri)

Parámetros

baseUri
Uri Uri Uri Uri

Uri absoluto que es la base de la nueva instancia de Uri.An absolute Uri that is the base for the new Uri instance.

relativeUri
Uri Uri Uri Uri

Instancia de Uri relativo que se combina con baseUri.A relative Uri instance that is combined with baseUri.

Excepciones

baseUri no es una instancia Uri absoluta.baseUri is not an absolute Uri instance.

baseUri no es una instancia Uri absoluta.baseUri is not an absolute Uri instance.

Nota: En .NET para aplicaciones de la Tienda Windows o la Biblioteca de clases portable, capture en su lugar la excepción de clase base, FormatException.Note: In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

El URI formado mediante la combinación de baseUri y relativeUri está vacío o solo contiene espacios en blanco.The URI formed by combining baseUri and relativeUri is empty or contains only spaces.

O bien-or- El esquema especificado en el URI formado mediante la combinación de baseUri y relativeUri no es válido.The scheme specified in the URI formed by combining baseUri and relativeUri is not valid.

O bien-or- El URI formado mediante la combinación de baseUri y relativeUri contiene demasiadas barras diagonales.The URI formed by combining baseUri and relativeUri contains too many slashes.

o bien-or- La contraseña especificada en el URI formado mediante la combinación de baseUri y relativeUri no es válida.The password specified in the URI formed by combining baseUri and relativeUri is not valid.

o bien-or- El nombre de host especificado en el URI formado mediante la combinación de baseUri y relativeUri no es válido.The host name specified in the URI formed by combining baseUri and relativeUri is not valid.

o bien-or- El nombre de archivo especificado en el URI formado mediante la combinación de baseUri y relativeUri no es válido.The file name specified in the URI formed by combining baseUri and relativeUri is not valid.

O bien-or- El nombre de usuario especificado en el URI formado mediante la combinación de baseUri y relativeUri no es válido.The user name specified in the URI formed by combining baseUri and relativeUri is not valid.

o bien-or- El nombre de host o de autoridad especificado en el URI formado mediante la combinación de baseUri y relativeUri no puede terminar con barras diagonales inversas.The host or authority name specified in the URI formed by combining baseUri and relativeUri cannot be terminated by backslashes.

O bien-or- El número de puerto especificado en el URI formado mediante la combinación de baseUri y relativeUri no es válido o no se puede analizar.The port number specified in the URI formed by combining baseUri and relativeUri is not valid or cannot be parsed.

o bien-or- La longitud del URI formado mediante la combinación de baseUri y relativeUri supera los 65519 caracteres.The length of the URI formed by combining baseUri and relativeUri exceeds 65519 characters.

o bien-or- La longitud del esquema especificado en el URI formado mediante la combinación de baseUri y relativeUri supera los 1023 caracteres.The length of the scheme specified in the URI formed by combining baseUri and relativeUri exceeds 1023 characters.

O bien-or- Hay una secuencia de caracteres no válida en el URI formado mediante la combinación baseUri y relativeUri.There is an invalid character sequence in the URI formed by combining baseUri and relativeUri.

O bien-or- La ruta de acceso a MS-DOS especificada en uriString debe comenzar por c:\\.The MS-DOS path specified in uriString must start with c:\\.

Ejemplos

En este ejemplo se crea una instancia absoluta de Uri, absoluteUri y una instancia relativa de @no__t 2, relativeUri.This example creates an absolute Uri instance, absoluteUri, and a relative Uri instance, relativeUri. A continuación, se crea una nueva instancia Uri, combinedUri a partir de estas dos instancias.A new Uri instance, combinedUri, is then created from these two instances.

// Create an absolute Uri from a string.
String^ addressString1 = "http://www.contoso.com/";
String^ addressString2 = "catalog/shownew.htm?date=today";
Uri^ absoluteUri = gcnew Uri(addressString1);

// Create a relative Uri from a string.  allowRelative = true to allow for 
// creating a relative Uri.
Uri^ relativeUri = gcnew Uri(addressString2);

// Check whether the new Uri is absolute or relative.
if (  !relativeUri->IsAbsoluteUri )
   Console::WriteLine( "{0} is a relative Uri.", relativeUri );

// Create a new Uri from an absolute Uri and a relative Uri.
Uri^ combinedUri = gcnew Uri( absoluteUri,relativeUri );
Console::WriteLine( combinedUri->AbsoluteUri );
   // Create an absolute Uri from a string.
   Uri absoluteUri = new Uri("http://www.contoso.com/");

   // Create a relative Uri from a string.  allowRelative = true to allow for 
   // creating a relative Uri.
   Uri relativeUri = new Uri("/catalog/shownew.htm?date=today", UriKind.Relative);

   // Check whether the new Uri is absolute or relative.
   if (!relativeUri.IsAbsoluteUri)
       Console.WriteLine("{0} is a relative Uri.", relativeUri);

   // Create a new Uri from an absolute Uri and a relative Uri.
   Uri combinedUri = new Uri(absoluteUri, relativeUri);
   Console.WriteLine(combinedUri.AbsoluteUri);
    ' Create an absolute Uri from a string.
    Dim absoluteUri As New Uri("http://www.contoso.com/")
    
    ' Create a relative Uri from a string.  allowRelative = true to allow for 
    ' creating a relative Uri.
    Dim relativeUri As New Uri("/catalog/shownew.htm?date=today")
    
    ' Check whether the new Uri is absolute or relative.
    If Not relativeUri.IsAbsoluteUri Then
        Console.WriteLine("{0} is a relative Uri.", relativeUri)
    End If 
    ' Create a new Uri from an absolute Uri and a relative Uri.
    Dim combinedUri As New Uri(absoluteUri, relativeUri)
    Console.WriteLine(combinedUri.AbsoluteUri)

End Sub

Comentarios

Este constructor crea una nueva instancia de Uri mediante la combinación de una instancia de Uri absoluta, baseUri, con una instancia relativa de Uri, relativeUri.This constructor creates a new Uri instance by combining an absolute Uri instance, baseUri, with a relative Uri instance, relativeUri. Si relativeUri es una instancia absoluta de Uri (que contiene un esquema, un nombre de host y, opcionalmente, un número de puerto), se crea la instancia de @no__t 2 usando solo relativeUri.If relativeUri is an absolute Uri instance (containing a scheme, host name, and optionally a port number), the Uri instance is created using only relativeUri.

Si el baseUri tiene partes relativas (como /api), la parte relativa debe terminar con una barra diagonal (como @no__t 2), si la parte relativa de baseUri se va a conservar en el Uri construido.If the baseUri has relative parts (like /api), then the relative part must be terminated with a slash, (like /api/), if the relative part of baseUri is to be preserved in the constructed Uri.

Además, si el relativeUri empieza con una barra diagonal, reemplazará cualquier parte relativa del baseUriAdditionally, if the relativeUri begins with a slash, then it will replace any relative part of the baseUri

Este constructor no garantiza que el Uri hace referencia a un recurso accesible.This constructor does not ensure that the Uri refers to an accessible resource.

Uri(Uri, String, Boolean) Uri(Uri, String, Boolean) Uri(Uri, String, Boolean) Uri(Uri, String, Boolean)

Advertencia

Esta API está ya obsoleta.

Inicializa una nueva instancia de la clase Uri basada en los identificadores URI base y relativo especificados, con control explícito de la secuencia de escape de carácter.Initializes a new instance of the Uri class based on the specified base and relative URIs, with explicit control of character escaping.

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri, bool dontEscape);
[System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. http://go.microsoft.com/fwlink/?linkid=14202")]
[System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri (Uri baseUri, string relativeUri, bool dontEscape);
new Uri : Uri * string * bool -> Uri
Public Sub New (baseUri As Uri, relativeUri As String, dontEscape As Boolean)

Parámetros

baseUri
Uri Uri Uri Uri

Identificador URI base.The base URI.

relativeUri
String String String String

Identificador URI relativo que se va a agregar al identificador URI base.The relative URI to add to the base URI.

dontEscape
Boolean Boolean Boolean Boolean

Es true si uriString es totalmente de escape; en caso contrario, es false.true if uriString is completely escaped; otherwise, false.

Excepciones

baseUri no es una instancia Uri absoluta.baseUri is not an absolute Uri instance.

El URI formado mediante la combinación de baseUri y relativeUri está vacío o solo contiene espacios en blanco.The URI formed by combining baseUri and relativeUri is empty or contains only spaces.

o bien-or- El esquema especificado en el URI formado mediante la combinación de baseUri y relativeUri no es válido.The scheme specified in the URI formed by combining baseUri and relativeUri is not valid.

O bien-or- El URI formado mediante la combinación de baseUri y relativeUri contiene demasiadas barras diagonales.The URI formed by combining baseUri and relativeUri contains too many slashes.

O bien-or- La contraseña especificada en el URI formado mediante la combinación de baseUri y relativeUri no es válida.The password specified in the URI formed by combining baseUri and relativeUri is not valid.

O bien-or- El nombre de host especificado en el URI formado mediante la combinación de baseUri y relativeUri no es válido.The host name specified in the URI formed by combining baseUri and relativeUri is not valid.

o bien-or- El nombre de archivo especificado en el URI formado mediante la combinación de baseUri y relativeUri no es válido.The file name specified in the URI formed by combining baseUri and relativeUri is not valid.

O bien-or- El nombre de usuario especificado en el URI formado mediante la combinación de baseUri y relativeUri no es válido.The user name specified in the URI formed by combining baseUri and relativeUri is not valid.

o bien-or- El nombre de host o de autoridad especificado en el URI formado mediante la combinación de baseUri y relativeUri no puede terminar con barras diagonales inversas.The host or authority name specified in the URI formed by combining baseUri and relativeUri cannot be terminated by backslashes.

O bien-or- El número de puerto especificado en el URI formado mediante la combinación de baseUri y relativeUri no es válido o no se puede analizar.The port number specified in the URI formed by combining baseUri and relativeUri is not valid or cannot be parsed.

O bien-or- La longitud del URI formado mediante la combinación de baseUri y relativeUri supera los 65519 caracteres.The length of the URI formed by combining baseUri and relativeUri exceeds 65519 characters.

o bien-or- La longitud del esquema especificado en el URI formado mediante la combinación de baseUri y relativeUri supera los 1023 caracteres.The length of the scheme specified in the URI formed by combining baseUri and relativeUri exceeds 1023 characters.

o bien-or- Hay una secuencia de caracteres no válida en el URI formado mediante la combinación baseUri y relativeUri.There is an invalid character sequence in the URI formed by combining baseUri and relativeUri.

O bien-or- La ruta de acceso a MS-DOS especificada en uriString debe comenzar por c:\\.The MS-DOS path specified in uriString must start with c:\\.

Ejemplos

En el ejemplo siguiente se crea una nueva instancia de la clase Uri mediante la combinación de los URI relativos http://www.contoso.com y Hello%20World.htm para formar un URI absoluto.The following example creates a new instance of the Uri class by combining the relative URIs http://www.contoso.com and Hello%20World.htm to form an absolute URI.

Uri^ baseUri = gcnew Uri( "http://www.contoso.com/" );
Uri^ myUri = gcnew Uri( baseUri,"Hello%20World.htm",false );
 Uri baseUri = new Uri("http://www.contoso.com");
 Uri myUri = new Uri(baseUri, "Hello%20World.htm",false);

Dim baseUri As New Uri("http://www.contoso.com")
Dim myUri As New Uri(baseUri, "Hello%20World.htm", False)

Comentarios

Este constructor crea una instancia de Uri mediante la combinación de baseUri y relativeUri.This constructor creates a Uri instance by combining baseUri and relativeUri. Si el URI pasado en relativeUri es un URI absoluto (que contiene un esquema, un nombre de host y, opcionalmente, un número de puerto), la instancia de Uri se crea usando solo relativeUri.If the URI passed in relativeUri is an absolute URI (containing a scheme, host name, and optionally a port number), the Uri instance is created using only relativeUri.

El parámetro dontEscape controla si los caracteres reservados se traducen en secuencias de escape.The dontEscape parameter controls whether reserved characters are translated into escape sequences. Este parámetro debe establecerse en true solo si está seguro de que todos los caracteres reservados en el URI tienen un carácter de escape.This parameter should be set to true only if you are certain that all reserved characters in the URI have been escaped. Si se establece el valor en true para un URI que no tiene un carácter de escape completo, puede producirse un comportamiento inesperado.Setting the value to true for a URI that has not been completely escaped can cause unexpected behavior. Se recomienda encarecidamente que siempre establezca este parámetro en false.It is strongly recommended that you always set this parameter to false. Si dontEscape se establece en false, el constructor realiza el escape de los caracteres reservados mediante la comprobación de que todas las apariciones del porcentaje (%) van seguidos de una secuencia de escape válida.If dontEscape is set to false, the constructor escapes any reserved characters by checking that all occurrences of percent (%) are followed by a valid escape sequence. Si la secuencia de caracteres que sigue a un porcentaje no es válida, el porcentaje se sustituye por% 25.If the character sequence following a percent is not valid, the percent is replaced by %25.

Este constructor no garantiza que el Uri hace referencia a un recurso accesible.This constructor does not ensure that the Uri refers to an accessible resource.

Notas a los autores de las llamadas

Debido a los problemas de seguridad, la aplicación no debe llamar a este constructor con cadenas URI de orígenes que no son de confianza y con dontEscape establecido en true.Because of security concerns, your application should not call this constructor with URI strings from untrusted sources and with dontEscape set to true. Como alternativa, puede comprobar la validez de una cadena de URI llamando al método IsWellFormedOriginalString() antes de llamar a este constructor.Alternately, you can check a URI string for validity by calling the IsWellFormedOriginalString() method prior to calling this constructor.

Se aplica a