Uri.OriginalString Proprietà

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Origine:

Uri.cs

Ottiene la stringa URI originale passata al costruttore Uri.

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

public string OriginalString { get; }

member this.OriginalString : string

Public ReadOnly Property OriginalString As String

Valore della proprietà

String

L'URI esatto specificato quando questa istanza è stata costruita; in caso contrario, Empty.

Esempio

Nell'esempio seguente viene creata una nuova Uri istanza da una stringa. Illustra la differenza tra il valore restituito da OriginalString, che restituisce la stringa passata al costruttore e da una chiamata a ToString, che restituisce la forma canonica della stringa.

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

Commenti

Se l'URI specificato nel costruttore contiene spazi iniziali o finali, questi spazi vengono mantenuti.

Il valore restituito da questa proprietà differisce da ToString e AbsoluteUri. ToString restituisce la forma canonicamente non esescaped dell'URI. AbsoluteUri restituisce la forma di escape canonica dell'URI.

Quando il supporto IRI (International Resource Identifier) e Internationalized Domain Name (IDN) sono abilitati, OriginalString restituisce la stringa non normalizzata originale con il nome host Punycode se è stato usato per inizializzare l'istanza Uri . I nomi Punycode contengono solo caratteri ASCII e iniziano sempre con il prefisso "xn--".

Per altre informazioni sul supporto IRI, vedere la sezione Osservazioni per la Uri classe.

Quando un Uri oggetto viene serializzato, l'oggetto OriginalString non viene mantenuto. Il processo di serializzazione usa la proprietà completamente escape e canonica durante AbsoluteUri la serializzazione. Per un Uri oggetto contenente un indirizzo IPv6, l'indirizzo IPv6 e l'ID ambito sono inclusi nell'oggetto serializzato Uri .