Uri.ToString 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:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs
Source:
Uri.cs

Obtiene una representación de cadena canónica para la instancia especificada Uri .

public:
 override System::String ^ ToString();
public override string ToString();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Devoluciones

String

Representación canónica sin escape de la Uri instancia. Todos los caracteres no se incluyen excepto #, ?y %.

Ejemplos

En el ejemplo siguiente se crea una nueva Uri instancia a partir de una cadena. Ilustra la diferencia entre el valor devuelto de OriginalString, que devuelve la cadena que se pasó al constructor y de una llamada a ToString, que devuelve la forma canónica de la cadena.

// Create a new Uri from a string address.
Uri uriAddress = new Uri("HTTP://www.Contoso.com:80/thick%20and%20thin.htm");

// Write the new Uri to the console and note the difference in the two values.
// ToString() gives the canonical version.  OriginalString gives the orginal
// string that was passed to the constructor.

// The following outputs "http://www.contoso.com/thick and thin.htm".
Console.WriteLine(uriAddress.ToString());

// The following outputs "HTTP://www.Contoso.com:80/thick%20and%20thin.htm".
Console.WriteLine(uriAddress.OriginalString);

// Create a new Uri from a string address.
let uriAddress = Uri "HTTP://www.Contoso.com:80/thick%20and%20thin.htm"

// Write the new Uri to the console and note the difference in the two values.
// ToString() gives the canonical version.  OriginalString gives the orginal
// string that was passed to the constructor.

// The following outputs "http://www.contoso.com/thick and thin.htm".
printfn $"{uriAddress.ToString()}"

// The following outputs "HTTP://www.Contoso.com:80/thick%20and%20thin.htm".
printfn $"{uriAddress.OriginalString}"

    ' Create a new Uri from a string address.
    Dim uriAddress As New Uri("HTTP://www.Contoso.com:80/thick%20and%20thin.htm")
    
    ' Write the new Uri to the console and note the difference in the two values.
    ' ToString() gives the canonical version.  OriginalString gives the orginal 
    ' string that was passed to the constructor.
    ' The following outputs "http://www.contoso.com/thick and thin.htm".
    Console.WriteLine(uriAddress.ToString())
    
    ' The following outputs "HTTP://www.Contoso.com:80/thick%20and%20thin.htm".
    Console.WriteLine(uriAddress.OriginalString)

End Sub

Comentarios

La cadena devuelta por este método no contiene información de puerto cuando el puerto es el puerto predeterminado para el esquema.

Note

La cadena devuelta por el ToString método puede contener caracteres de control, que pueden dañar el estado de una aplicación de consola. Puede usar el GetComponents método con el UriFormat.SafeUnescaped formato para quitar los caracteres de control de la cadena devuelta.

Se aplica a