System.Uri.ToString 方法

方法描述

获取指定的 Uri 实例的规范化字符串表示形式。

语法定义(C# System.Uri.ToString 方法 的用法)

[SecurityPermissionAttribute(SecurityAction.InheritanceDemand, Flags = SecurityPermissionFlag.Infrastructure)]
public override string ToString()

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
返回值 System.String 一个 String 实例,它包含 Uri 实例的非转义规范化表示形式。 除了 #、? 和 %,所有字符均为非转义字符。

提示和注释

当此端口是方案的默认端口时,此方法返回的字符串不包含端口信息。

注意

由 ToString 方法返回的字符串可能包含一些控制字符,可以损坏控制台应用程序的状态。 您可以使用采用 UriFormat.SafeUnescaped 格式的 GetComponents 方法从返回字符串中移除控制字符。

System.Uri.ToString 方法例子

此示例阐释了从 OriginalString 返回的值(传递到构造函数的字符串)和从 ToString 调用返回的值(字符串的规范格式)之间的差异。

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

异常

异常 异常描述

命名空间

namespace: System

程序集: System(在 System.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1 受以下版本支持:

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。