Uri.OriginalString Propriété

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Source:

Uri.cs

Obtient la chaîne d'URI d'origine passée au constructeur Uri.

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

public string OriginalString { get; }

member this.OriginalString : string

Public ReadOnly Property OriginalString As String

Valeur de propriété

String

URI exact spécifié lors de la construction de cette instance ; sinon, Empty.

Exemples

L’exemple suivant crée une Uri instance à partir d’une chaîne. Il illustre la différence entre la valeur retournée à partir de OriginalString, qui retourne la chaîne qui a été passée au constructeur, et à partir d’un appel à ToString, qui retourne la forme canonique de la chaîne.

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

Remarques

Si l’URI spécifié au constructeur contenait des espaces de début ou de fin, ces espaces sont conservés.

La valeur retournée par cette propriété diffère de ToString et AbsoluteUri. ToString retourne la forme canoniquement sans séquence d’échappement de l’URI. AbsoluteUri retourne la forme d’échappement canonique de l’URI.

Lorsque la prise en charge de l’identificateur de ressource international (IRI) et de l’IDN (Internationalized Domain Name) est activée, OriginalString retourne la chaîne non normalisée d’origine avec le nom d’hôte Punycode si elle a été utilisée pour initialiser le Uri instance. Les noms Punycode contiennent uniquement des caractères ASCII et commencent toujours par le préfixe xn--.

Pour plus d’informations sur la prise en charge de l’IRI, consultez la section Remarques pour la Uri classe .

Lorsqu’un Uri objet est sérialisé, le OriginalString n’est pas conservé. Le processus de sérialisation utilise la propriété entièrement échappée et canonique lors AbsoluteUri de la sérialisation. Pour un Uri qui contient une adresse IPv6, l’adresse IPv6 et l’ID d’étendue sont inclus dans l’objet sérialisé Uri .