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 无效。

命名空间

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 系统要求。