System.Uri.GetLeftPart 方法
方法描述
获取 Uri 实例的指定部分。
语法定义(C# System.Uri.GetLeftPart 方法 的用法)
public string GetLeftPart( UriPartial part )
参数/返回值
参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
---|---|---|
part | System-UriPartial | UriPartial 值之一,指定要返回的 URI 部分的结尾。 |
返回值 | System.String | 一个 String,其中包含 Uri 实例的指定部分。 |
提示和注释
GetLeftPart 方法返回一个包含 URI 字符串中最左边部分的字符串,它以 part 指定的部分结束。
在下面的情况下,GetLeftPart 包括分隔符:
Scheme 包括方案分隔符。
Authority 不包括路径分隔符。
Path 包括原始 URI 中的任何分隔符,一直到查询或段分隔符。
Query 包括 Path,并加上查询及其分隔符。
下面的示例演示一个 URI 以及使用 Scheme、Authority、Path 或 Query 调用 GetLeftPart 的结果。
URI
方案
颁发机构
路径
查询
http://www.contoso.com/index.htm?date=today
http://
http://www.contoso.com
http://www.contoso.com/index.htm
http://www.contoso.com/index.htm?date=today
http://www.contoso.com/index.htm#main
http://
http://www.contoso.com
http://www.contoso.com/index.htm
http://www.contoso.com/index.htm
mailto:user@contoso.com?subject=uri
mailto:
mailto:user@contoso.com
mailto:user@contoso.com?subject=uri
nntp://news.contoso.com/123456@contoso.com
nntp://
nntp://news.contoso.com
nntp://news.contoso.com/123456@contoso.com
nntp://news.contoso.com/123456@contoso.com
news:123456@contoso.com
news:
news:123456@contoso.com
news:123456@contoso.com
file://server/filename.ext
file://
file://server
file://server/filename.ext
file://server/filename.ext
System.Uri.GetLeftPart 方法例子
下面的示例创建一个 Uri 实例并将路径输出到控制台。
// Create Uri Uri uriAddress = new Uri("http://www.contoso.com/index.htm#search"); Console.WriteLine(uriAddress.Fragment); Console.WriteLine("Uri {0} the default port ", uriAddress.IsDefaultPort ? "uses" : "does not use"); Console.WriteLine("The path of this Uri is {0}", uriAddress.GetLeftPart(UriPartial.Path)); Console.WriteLine("Hash code {0}", uriAddress.GetHashCode());
异常
异常 | 异常描述 |
---|---|
InvalidOperationException | 当前 Uri 实例不是绝对实例。 |
ArgumentException | 指定的 part 无效。 |
版本信息
.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 系统要求。