Uri Constructores

Definición

Espacio de nombres:

System

Ensamblados:

netstandard.dll, System.Runtime.dll

Inicializa una nueva instancia de la clase Uri.

Sobrecargas

Nombre	Description
Uri(String)	Inicializa una nueva instancia de la Uri clase con el URI especificado.
Uri(SerializationInfo, StreamingContext)	Obsoletos. Inicializa una nueva instancia de la Uri clase a partir de las instancias especificadas de las SerializationInfo clases y StreamingContext .
Uri(String, Boolean)	Obsoletos. Inicializa una nueva instancia de la Uri clase con el URI especificado, con control explícito de escape de caracteres.
Uri(String, UriCreationOptions)	Inicializa una nueva instancia de la Uri clase con el URI especificado y adicional UriCreationOptions.
Uri(String, UriKind)	Inicializa una nueva instancia de la Uri clase con el URI especificado. Este constructor permite especificar si la cadena de URI es un URI relativo, un URI absoluto o está indeterminado.
Uri(Uri, String)	Inicializa una nueva instancia de la Uri clase basándose en el URI base especificado y la cadena de URI relativa.
Uri(Uri, Uri)	Inicializa una nueva instancia de la Uri clase basándose en la combinación de una instancia base Uri especificada y una instancia relativa Uri .
Uri(Uri, String, Boolean)	Obsoletos. Inicializa una nueva instancia de la Uri clase en función de los URI relativos y base especificados, con control explícito de escape de caracteres.

Uri(String)

Source:

Uri.cs

Inicializa una nueva instancia de la Uri clase con el URI especificado.

public:
 Uri(System::String ^ uriString);

public Uri(string uriString);

new Uri : string -> Uri

Public Sub New (uriString As String)

Parámetros

uriString

String

Cadena que identifica el recurso que se va a representar mediante la Uri instancia de .

Excepciones

ArgumentNullException

uriString es null.

UriFormatException

uriString está vacío.

-o-

El esquema especificado en uriString no tiene el formato correcto. Consulte CheckSchemeName(String).

-o-

uriString contiene demasiadas barras diagonales.

-o-

La contraseña, el nombre de host, el nombre de archivo o el nombre de usuario especificados en uriString no es válido.

-o-

El nombre de host o autoridad especificado en uriString finaliza mediante barras diagonales inversas.

-o-

El número de puerto especificado en uriString no es válido o no se puede analizar.

-o-

La longitud de uriString supera los 65519 caracteres (solo .NET 9 y versiones anteriores).

-o-

La longitud del esquema especificado en uriString supera los 1023 caracteres.

-o-

Hay una secuencia de caracteres no válida en uriString.

-o-

La ruta de acceso MS-DOS especificada en uriString no comienza con c:\\.

Ejemplos

En el ejemplo siguiente se crea una Uri instancia con el URI http://www.contoso.com/.

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

let myUri = Uri "http://www.contoso.com/"

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

Comentarios

Este constructor crea una Uri instancia a partir de una cadena de URI. Analiza el URI, lo coloca en formato canónico y hace que las codificaciones de escape necesarias.

Este constructor no garantiza que haga Uri referencia a un recurso accesible.

uriString Si representa una dirección IPv6, debe incluirse entre corchetes, por ejemplo, "http://[2607:f8b0:400d:c06::69]".

Este constructor supone que el string parámetro hace referencia a un URI absoluto y es equivalente a llamar al Uri constructor con UriKind establecido en Absolute. Si el string parámetro pasado al constructor es un URI relativo, este constructor produce una UriFormatExceptionexcepción .

Uri(SerializationInfo, StreamingContext)

Source:

Uri.cs

Precaución

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

Inicializa una nueva instancia de la Uri clase a partir de las instancias especificadas de las SerializationInfo clases y StreamingContext .

protected:
 Uri(System::Runtime::Serialization::SerializationInfo ^ serializationInfo, System::Runtime::Serialization::StreamingContext streamingContext);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected Uri(System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri

Protected Sub New (serializationInfo As SerializationInfo, streamingContext As StreamingContext)

Parámetros

serializationInfo

SerializationInfo

Información necesaria para serializar la nueva Uri instancia.

streamingContext

StreamingContext

Origen de la secuencia serializada asociada a la nueva Uri instancia.

Atributos

ObsoleteAttribute

Excepciones

ArgumentNullException

El serializationInfo parámetro contiene un null URI.

UriFormatException

El serializationInfo parámetro contiene un URI que está vacío.

-o-

El esquema especificado no tiene el formato correcto. Consulte CheckSchemeName(String).

-o-

El URI contiene demasiadas barras diagonales.

-o-

La contraseña, el nombre de host, el nombre de archivo o el nombre de usuario especificados en el URI no son válidos.

-o-

El nombre de host o autoridad especificado en el URI finaliza mediante barras diagonales inversas.

-o-

El número de puerto especificado en el URI no es válido o no se puede analizar.

-o-

La longitud del URI supera los 65519 caracteres (solo .NET 9 y versiones anteriores).

-o-

La longitud del esquema especificado en el URI supera los 1023 caracteres.

-o-

Hay una secuencia de caracteres no válida en el URI.

-o-

La ruta de acceso MS-DOS especificada en el URI no comienza con c:\\.

Comentarios

Este constructor implementa la ISerializable interfaz de la Uri clase .

Consulte también

• Serialización XML y SOAP

Uri(String, Boolean)

Source:

Uri.cs

Precaución

This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.

Inicializa una nueva instancia de la Uri clase con el URI especificado, con control explícito de escape de caracteres.

public:
 Uri(System::String ^ uriString, bool dontEscape);

[System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.")]
public Uri(string uriString, bool dontEscape);

[<System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.")>]
new Uri : string * bool -> Uri

Public Sub New (uriString As String, dontEscape As Boolean)

Parámetros

uriString

String

Cadena que identifica el recurso que se va a representar mediante la Uri instancia de . Tenga en cuenta que una dirección IPv6 en forma de cadena debe incluirse entre corchetes. Por ejemplo, "http://[2607:f8b0:400d:c06::69]".

dontEscape

Boolean

true es si uriString se ha escapado completamente; de lo contrario, falsees .

Atributos

ObsoleteAttribute

Excepciones

ArgumentNullException

uriString es null.

UriFormatException

uriString está vacío o solo contiene espacios.

-o-

El esquema especificado en uriString no es válido.

-o-

uriString contiene demasiadas barras diagonales.

-o-

La contraseña, el nombre de host, el nombre de archivo o el nombre de usuario especificados en uriString no es válido.

-o-

El nombre de host o autoridad especificado en uriString finaliza mediante barras diagonales inversas.

-o-

El número de puerto especificado en uriString no es válido o no se puede analizar.

-o-

La longitud de uriString supera los 65519 caracteres (solo .NET 9 y versiones anteriores).

-o-

La longitud del esquema especificado en uriString supera los 1023 caracteres.

-o-

Hay una secuencia de caracteres no válida en uriString.

-o-

La ruta de acceso MS-DOS especificada en uriString no comienza con c:\\.

Comentarios

Este constructor crea una Uri instancia a partir de una cadena de URI. Analiza el URI y lo coloca en formato canónico.

El dontEscape parámetro controla si los caracteres reservados se traducen en secuencias de escape. Este parámetro debe establecerse true en solo si está seguro de que se han escape todos los caracteres reservados del URI. Establecer el valor true en para un URI que no se ha escapado completamente puede provocar un comportamiento inesperado. Se recomienda encarecidamente establecer siempre este parámetro falseen .

Si dontEscape se establece falseen , el constructor escapa a los caracteres reservados comprobando que todas las apariciones del porcentaje (%) van seguidas de una secuencia de escape válida. Si la secuencia de caracteres que sigue a un porcentaje no es válida, el porcentaje se reemplaza por %25.

Este constructor no garantiza que haga Uri referencia a un recurso accesible.

Uri(String, UriCreationOptions)

Source:

Uri.cs

Inicializa una nueva instancia de la Uri clase con el URI especificado y adicional UriCreationOptions.

public:
 Uri(System::String ^ uriString, UriCreationOptions % creationOptions);

public Uri(string uriString, in UriCreationOptions creationOptions);

new Uri : string * UriCreationOptions -> Uri

Public Sub New (uriString As String, ByRef creationOptions As UriCreationOptions)

Parámetros

uriString

String

Cadena que identifica el recurso que se va a representar mediante la Uri instancia de .

creationOptions

UriCreationOptions

Opciones que controlan cómo Uri se crea y se comporta.

Uri(String, UriKind)

Source:

Uri.cs

Inicializa una nueva instancia de la Uri clase con el URI especificado. Este constructor permite especificar si la cadena de URI es un URI relativo, un URI absoluto o está indeterminado.

public:
 Uri(System::String ^ uriString, UriKind uriKind);

public Uri(string uriString, UriKind uriKind);

new Uri : string * UriKind -> Uri

Public Sub New (uriString As String, uriKind As UriKind)

Parámetros

uriString

String

Cadena que identifica el recurso que se va a representar mediante la Uri instancia de .

uriKind

UriKind

Especifica si la cadena de URI es un URI relativo, un URI absoluto o es indeterminado.

Excepciones

ArgumentException

uriKind no es válido.

ArgumentNullException

uriString es null.

UriFormatException

uriString contiene un URI relativo y uriKind es Absolute.

o

uriString contiene un URI absoluto y uriKind es Relative.

o

uriString está vacío.

-o-

El esquema especificado en uriString no tiene el formato correcto. Consulte CheckSchemeName(String).

-o-

uriString contiene demasiadas barras diagonales.

-o-

La contraseña, el nombre de host, el nombre de archivo o el nombre de usuario especificados en uriString no es válido.

-o-

El nombre de host o autoridad especificado en uriString finaliza mediante barras diagonales inversas.

-o-

El número de puerto especificado en uriString no es válido o no se puede analizar.

-o-

La longitud de uriString supera los 65519 caracteres (solo .NET 9 y versiones anteriores).

-o-

La longitud del esquema especificado en uriString supera los 1023 caracteres.

-o-

Hay una secuencia de caracteres no válida en uriString.

-o-

La ruta de acceso MS-DOS especificada en uriString no comienza con c:\\.

Comentarios

Los URI relativos y absolutos tienen restricciones diferentes en su formato. Por ejemplo, un URI relativo no requiere un esquema ni una autoridad. El valor especificado en uriKind debe coincidir con el tipo de URI pasado en uriString. Sin embargo, si RelativeOrAbsolute se especifica , la cadena de URI puede ser relativa o absoluta.

Para uriString, una dirección IPv6 en forma de cadena debe incluirse entre corchetes, por ejemplo, "http://[2607:f8b0:400d:c06::69]".

Uri(Uri, String)

Source:

Uri.cs

Inicializa una nueva instancia de la Uri clase basándose en el URI base especificado y la cadena de URI relativa.

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 base.

relativeUri

String

URI relativo que se va a agregar al URI base.

Excepciones

ArgumentNullException

baseUri es null.

ArgumentOutOfRangeException

baseUri no es una instancia absoluta Uri .

UriFormatException

El URI formado mediante la baseUri combinación de y relativeUri está vacío o contiene solo espacios.

-o-

El esquema especificado en el URI formado mediante la combinación baseUri y relativeUri no es válido.

-o-

El URI formado mediante la baseUri combinación de y relativeUri contiene demasiadas barras diagonales.

-o-

La contraseña, el nombre de host, el nombre de archivo o el nombre de usuario especificados en el URI formado mediante la combinación baseUri de y relativeUri no es válido.

-o-

El nombre de host o autoridad especificado en el URI formado mediante la combinación baseUri de y relativeUri finaliza mediante barras diagonales inversas.

-o-

El número de puerto especificado en el URI formado mediante baseUri la combinación de y relativeUri no es válido o no se puede analizar.

-o-

La longitud del URI formado mediante la combinación baseUri y relativeUri supera los 65519 caracteres (solo .NET 9 y versiones anteriores).

-o-

La longitud del esquema especificado en el URI formado por la combinación baseUri y relativeUri supera los 1023 caracteres.

-o-

Hay una secuencia de caracteres no válida en el URI formado mediante la combinación baseUri de y relativeUri.

-o-

La ruta de acceso MS-DOS especificada en baseUri no comienza con c:\\.

Ejemplos

En el ejemplo siguiente se crea una nueva instancia de la Uri clase combinando los URI http://www.contoso.com relativos y catalog/shownew.htm para formar el URI http://www.contoso.com/catalog/shownew.htmabsoluto .

Uri baseUri = new Uri("http://www.contoso.com");
 Uri myUri = new Uri(baseUri, "catalog/shownew.htm");

Console.WriteLine(myUri.ToString());

let baseUri = Uri "http://www.contoso.com"
let myUri = Uri(baseUri, "catalog/shownew.htm")

printfn $"{myUri}"

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 Uri instancia mediante la combinación de baseUri y .relativeUri Si relativeUri es un URI absoluto (que contiene un esquema, un nombre de host y, opcionalmente, un número de puerto), la Uri instancia se crea con solo relativeUri.

Si tiene baseUri partes relativas (como /api), la parte relativa debe terminarse con una barra diagonal (como /api/), si la parte relativa de baseUri se va a conservar en el construido Uri.

Además, si relativeUri comienza por una barra diagonal, reemplazará cualquier parte relativa de . baseUri

Este constructor no garantiza que haga Uri referencia a un recurso accesible.

Uri(Uri, Uri)

Source:

Uri.cs

Inicializa una nueva instancia de la Uri clase basándose en la combinación de una instancia base Uri especificada y una instancia relativa Uri .

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

Absoluto Uri que es la base de la nueva Uri instancia.

relativeUri

Uri

Instancia relativa Uri que se combina con baseUri.

Excepciones

ArgumentException

baseUri no es una instancia absoluta Uri .

ArgumentNullException

baseUri es null.

ArgumentOutOfRangeException

baseUri no es una instancia absoluta Uri .

UriFormatException

El URI formado mediante la baseUri combinación de y relativeUri está vacío o contiene solo espacios.

-o-

El esquema especificado en el URI formado mediante la combinación baseUri y relativeUri no es válido.

-o-

El URI formado mediante la baseUri combinación de y relativeUri contiene demasiadas barras diagonales.

-o-

La contraseña, el nombre de host, el nombre de archivo o el nombre de usuario especificados en el URI formado mediante la combinación baseUri de y relativeUri no es válido.

-o-

El nombre de host o autoridad especificado en el URI formado mediante la combinación baseUri de y relativeUri finaliza mediante barras diagonales inversas.

-o-

El número de puerto especificado en el URI formado mediante baseUri la combinación de y relativeUri no es válido o no se puede analizar.

-o-

La longitud del URI formado mediante la combinación baseUri y relativeUri supera los 65519 caracteres (solo .NET 9 y versiones anteriores).

-o-

La longitud del esquema especificado en el URI formado por la combinación baseUri y relativeUri supera los 1023 caracteres.

-o-

Hay una secuencia de caracteres no válida en el URI formado mediante la combinación baseUri de y relativeUri.

-o-

La ruta de acceso MS-DOS especificada en baseUri no comienza con c:\\.

Ejemplos

En este ejemplo se crea una instancia absoluta Uri , absoluteUri, y una instancia relativa Uri , relativeUri. A continuación, se crea una nueva Uri instancia de , combinedUria partir de estas dos instancias.

// 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.
let absoluteUri = Uri "http://www.contoso.com/"

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

// Check whether the new Uri is absolute or relative.
if not relativeUri.IsAbsoluteUri then
    printfn $"{relativeUri} is a relative Uri."

// Create a new Uri from an absolute Uri and a relative Uri.
let combinedUri = Uri(absoluteUri, relativeUri)
printfn $"{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 Uri instancia combinando una instancia absoluta Uri , baseUri, con una instancia relativa Uri , relativeUri. Si relativeUri es una instancia absoluta Uri (que contiene un esquema, un nombre de host y, opcionalmente, un número de puerto), la Uri instancia se crea con solo relativeUri.

Si tiene baseUri partes relativas (como /api), la parte relativa debe terminarse con una barra diagonal (como /api/), si la parte relativa de baseUri se va a conservar en el construido Uri.

Además, si relativeUri comienza por una barra diagonal, reemplazará cualquier parte relativa de .baseUri

Este constructor no garantiza que haga Uri referencia a un recurso accesible.

Uri(Uri, String, Boolean)

Source:

Uri.cs

Precaución

This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.

Inicializa una nueva instancia de la Uri clase en función de los URI relativos y base especificados, con control explícito de escape de caracteres.

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri, bool dontEscape);

[System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.")]
public Uri(Uri baseUri, string? relativeUri, bool dontEscape);

[<System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.")>]
new Uri : Uri * string * bool -> Uri

Public Sub New (baseUri As Uri, relativeUri As String, dontEscape As Boolean)

Parámetros

baseUri

Uri

URI base.

relativeUri

String

URI relativo que se va a agregar al URI base.

dontEscape

Boolean

true es si baseUri y relativeUri son completamente escapes; en caso contrario, falsees .

Atributos

ObsoleteAttribute

Excepciones

ArgumentNullException

baseUri es null.

ArgumentOutOfRangeException

baseUri no es una instancia absoluta Uri .

UriFormatException

El URI formado mediante la baseUri combinación de y relativeUri está vacío o contiene solo espacios.

-o-

El esquema especificado en el URI formado mediante la combinación baseUri y relativeUri no es válido.

-o-

El URI formado mediante la baseUri combinación de y relativeUri contiene demasiadas barras diagonales.

-o-

La contraseña, el nombre de host, el nombre de archivo o el nombre de usuario especificados en el URI formado mediante la combinación baseUri de y relativeUri no es válido.

-o-

El nombre de host o autoridad especificado en el URI formado mediante la combinación baseUri de y relativeUri finaliza mediante barras diagonales inversas.

-o-

El número de puerto especificado en el URI formado mediante baseUri la combinación de y relativeUri no es válido o no se puede analizar.

-o-

La longitud del URI formado mediante la combinación baseUri y relativeUri supera los 65519 caracteres (solo .NET 9 y versiones anteriores).

-o-

La longitud del esquema especificado en el URI formado por la combinación baseUri y relativeUri supera los 1023 caracteres.

-o-

Hay una secuencia de caracteres no válida en el URI formado mediante la combinación baseUri de y relativeUri.

-o-

La ruta de acceso MS-DOS especificada en baseUri no comienza con c:\\.

Comentarios

Este constructor crea una instancia mediante la Uri combinación baseUri de y relativeUri. Si el URI pasado es relativeUri un URI absoluto (que contiene un esquema, un nombre de host y, opcionalmente, un número de puerto), la Uri instancia se crea con solo relativeUri.

El dontEscape parámetro controla si los caracteres reservados se traducen en secuencias de escape. Este parámetro debe establecerse true en solo si está seguro de que se han escape todos los caracteres reservados del URI. Establecer el valor true en para un URI que no se ha escapado completamente puede provocar un comportamiento inesperado. Se recomienda encarecidamente establecer siempre este parámetro falseen . Si dontEscape se establece falseen , el constructor escapa a los caracteres reservados comprobando que todas las apariciones del porcentaje (%) van seguidas de una secuencia de escape válida. Si la secuencia de caracteres que sigue a un porcentaje no es válida, el porcentaje se reemplaza por %25.

Este constructor no garantiza que haga Uri referencia a un recurso accesible.

Notas a los autores de las llamadas

Debido a problemas de seguridad, la aplicación no debe llamar a este constructor con cadenas de URI de orígenes que no son de confianza y con establecido en dontEscapetrue. Como alternativa, puede comprobar si hay una cadena de URI válida llamando al IsWellFormedOriginalString() método antes de llamar a este constructor.