Uri.ToString Uri.ToString Uri.ToString Uri.ToString Method

Définition

Obtient une représentation canonique sous forme de chaîne de l'instance de Uri.Gets a canonical string representation for the specified Uri instance.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Retours

Instance de String qui contient la représentation réglementaire sans séquence d'échappement de l'instance de Uri.A String instance that contains the unescaped canonical representation of the Uri instance. Tous les caractères sont sans séquence d'échappement, hormis #, ? et %.All characters are unescaped except #, ?, and %.

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

La chaîne retournée par cette méthode ne contient pas d’informations de port lorsque le port est le port par défaut pour le schéma.The string returned by this method does not contain port information when the port is the default port for the scheme.

Notes

La chaîne retournée par ToString la méthode peut contenir des caractères de contrôle, ce qui peut corrompre l’état d’une application console.The string returned by the ToString method may contain control characters, which can corrupt the state of a console application. Vous pouvez utiliser la GetComponents méthode avec le UriFormat.SafeUnescaped format pour supprimer les caractères de contrôle de la chaîne retournée.You can use the GetComponents method with the UriFormat.SafeUnescaped format to remove control characters from the returned string.

Sécurité

SecurityPermission
pour empêcher le code partiellement fiable de dériver Uride.to prevent partially trusted code from deriving from Uri. Énumération associée : Infrastructure.Associated enumeration: Infrastructure.

S’applique à