Uri.ToString Method
Gets a canonical string representation for the specified Uri instance.
Namespace: System
Assembly: System (in System.dll)
[SecurityPermissionAttribute(SecurityAction.InheritanceDemand, Flags = SecurityPermissionFlag.Infrastructure)] public override string ToString()
Return Value
Type: System.StringA String instance that contains the unescaped canonical representation of the Uri instance. All characters are unescaped except #, ?, and %.
The string returned by this method does not contain port information when the port is the default port for the scheme.
Note |
|---|
The string returned by the ToString method may contain control characters, which can corrupt the state of a console application. You can use the GetComponents method with the UriFormat.SafeUnescaped format to remove control characters from the returned string. |
The following example creates a new Uri instance from a string. 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 = 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);
- SecurityPermission
to prevent partially trusted code from deriving from Uri. Associated enumeration: Infrastructure.
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Note