Uri.OriginalString Proprietà

Definizione

Ottiene la stringa URI originale passata al costruttore Uri.Gets the original URI string that was passed to the Uri constructor.

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

URI esatto specificato quando è stata costruita l'istanza. in caso contrario, Empty .The exact URI specified when this instance was constructed; otherwise, Empty.

Esempio

Nell'esempio seguente viene creata una nuova Uri istanza di da una stringa.The following example creates a new Uri instance from a string. Viene illustrata la differenza tra il valore restituito da OriginalString , che restituisce la stringa passata al costruttore e da una chiamata a ToString , che restituisce il formato canonico della stringa.It illustrates the difference between the value returned from OriginalString, which returns the string that was passed to the constructor, and from a call to ToString, which returns the canonical form of the string.

// 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.
    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 per il costruttore contiene spazi iniziali o finali, questi spazi vengono conservati.If the URI specified to the constructor contained leading or trailing spaces, these spaces are preserved.

Il valore restituito da questa proprietà è diverso da ToString e da AbsoluteUri .The value returned by this property differs from ToString and AbsoluteUri. ToString Restituisce il formato canonico senza caratteri di escape dell'URI.ToString returns the canonically unescaped form of the URI. AbsoluteUri Restituisce il formato di escape canonico dell'URI.AbsoluteUri returns the canonically escaped form of the URI.

Quando sono abilitati i supporti IRI (International Resource Identifier) e IDN (International Domain Name), OriginalString restituisce la stringa non normalizzata originale con il nome host Punycode se ne è stato usato uno per inizializzare l' Uri istanza.When International Resource Identifier (IRI) and Internationalized Domain Name (IDN) support are enabled, OriginalString returns the original non normalized string with Punycode host name if one was used to initialize the Uri instance. I nomi Punycode contengono solo caratteri ASCII e iniziano sempre con il prefisso "xn--".Punycode names contain only ASCII characters and always start with the xn-- prefix.

Per ulteriori informazioni sul supporto di IRI, vedere la sezione Osservazioni relativa alla Uri classe.For more information on IRI support, see the Remarks section for the Uri class.

Quando un Uri oggetto viene serializzato, l'oggetto OriginalString non viene mantenuto.When a Uri object is serialized, the OriginalString is not preserved. Il processo di serializzazione usa la proprietà completamente sottoposta a escape e in forma canonica AbsoluteUri durante la serializzazione.The serialization process uses the fully escaped and canonicalized AbsoluteUri property when serializing. Per un Uri oggetto che contiene un indirizzo IPv6, l'indirizzo IPv6 e l'ID ambito sono inclusi nell'oggetto serializzato Uri .For a Uri that contains an IPv6 address, the IPv6 address and the scope ID are included in the serialized Uri object.

Si applica a