Uri.OriginalString Propiedad

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Source:

Uri.cs

Obtiene la cadena de identificador URI original que se pasó al constructor Uri.

public:
 property System::String ^ OriginalString { System::String ^ get(); };

public string OriginalString { get; }

member this.OriginalString : string

Public ReadOnly Property OriginalString As String

Valor de propiedad

String

El URI exacto especificado cuando se construyó esta instancia; de lo contrario, Empty.

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 = gcnew 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 original 
// string that was passed to the constructor.
// The following outputs "http://www.contoso.com//thick and thin.htm".
Console::WriteLine( uriAddress );

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

// 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 original
// 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 original
// 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 original 
    ' 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

Si el URI especificado para el constructor contenía espacios iniciales o finales, estos espacios se conservan.

El valor devuelto por esta propiedad difiere de ToString y AbsoluteUri. ToString devuelve la forma canónica sin escape del URI. AbsoluteUri devuelve la forma de escape canónica del URI.

Cuando se habilita OriginalString la compatibilidad con el identificador de recursos internacional (IRI) y el nombre de dominio internacionalizado (IDN), devuelve la cadena no normalizada original con el nombre de host punycode si se usó para inicializar la Uri instancia. Los nombres de Punycode solo contienen caracteres ASCII y siempre empiezan con el prefijo xn--.

Para obtener más información sobre la compatibilidad con IRI, vea la sección Comentarios de la Uri clase .

Cuando se serializa un Uri objeto, OriginalString no se conserva . El proceso de serialización usa la propiedad totalmente con escape y canónica AbsoluteUri al serializar. Para un Uri objeto que contiene una dirección IPv6, la dirección IPv6 y el identificador de ámbito se incluyen en el objeto serializado Uri .