Uri.OriginalString Uri.OriginalString Uri.OriginalString Uri.OriginalString Property

Définition

Obtient la chaîne d'URI d'origine passée au constructeur 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

Valeur de propriété

String contenant l'URI exact spécifié lors de la construction de cette instance ; sinon, Empty.A String containing the exact URI specified when this instance was constructed; otherwise, Empty.

Exemples

L’exemple suivant crée une nouvelle Uri instance à partir d’une chaîne.The following example creates a new Uri instance from a string. Elle illustre la différence entre la valeur retournée par OriginalString, qui retourne la chaîne passée au constructeur, et à partir d’un appel à ToString, qui retourne la forme canonique de la chaîne.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 orginal 
// 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 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.
    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

Remarques

Si l’URI spécifié au constructeur contient des espaces de début ou de fin, ces espaces sont conservés.If the URI specified to the constructor contained leading or trailing spaces, these spaces are preserved.

La valeur retournée par cette propriété est ToString différente AbsoluteUride et.The value returned by this property differs from ToString and AbsoluteUri. ToStringretourne le formulaire canoniquement sans séquence d’échappement de l’URI.ToString returns the canonically unescaped form of the URI. AbsoluteUriretourne la forme d’échappement canonique de l’URI.AbsoluteUri returns the canonically escaped form of the URI.

Lorsque la prise en charge des IRI (International Resource Identifier) et des IDN (Internationalized Domain Name OriginalString ) est activée, retourne la chaîne non normalisée d’origine avec le nom d’hôte Punycode, Uri si celle-ci a été utilisée pour initialiser l’instance.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. Les noms Punycode contiennent uniquement des caractères ASCII et commencent toujours par le préfixe xn--.Punycode names contain only ASCII characters and always start with the xn-- prefix.

Pour plus d’informations sur la prise en charge des IRI, consultez Uri la section Notes de la classe.For more information on IRI support, see the Remarks section for the Uri class.

Lorsqu’un Uri objet est sérialisé, le OriginalString n’est pas conservé.When a Uri object is serialized, the OriginalString is not preserved. Le processus de sérialisation utilise la AbsoluteUri propriété entièrement échappée et avec Canonical lors de la sérialisation.The serialization process uses the fully escaped and canonicalized AbsoluteUri property when serializing. Pour un Uri qui contient une adresse IPv6, l’adresse IPv6 et l’ID d’étendue sont inclus dans l' Uri objet sérialisé.For a Uri that contains an IPv6 address, the IPv6 address and the scope ID are included in the serialized Uri object.

S’applique à