本文档已存档,并且将不进行维护。

Uri.GetLeftPart 方法

更新:2007 年 11 月

获取 Uri 实例的指定部分。

命名空间:  System
程序集:  System(在 System.dll 中)

public string GetLeftPart(
	UriPartial part
)
public String GetLeftPart(
	UriPartial part
)
public function GetLeftPart(
	part : UriPartial
) : String

参数

part
类型:System.UriPartial
UriPartial 值之一,指定要返回的 URI 部分的结尾。

返回值

类型:System.String
一个 String,其中包含 Uri 实例的指定部分。

异常条件
InvalidOperationException

当前 Uri 实例不是绝对实例。

ArgumentException

指定的 part 无效。

GetLeftPart 方法返回一个包含 URI 字符串中最左边部分的字符串,它以 part 指定的部分结束。

在下面的情况下,GetLeftPart 包括分隔符:

  • Scheme 包括方案分隔符。

  • Authority 不包括路径分隔符。

  • Path 包括原始 URI 中的任何分隔符,一直到查询或段分隔符。

  • Query 包括 Path,并加上查询及其分隔符。

下面的示例演示一个 URI 以及使用 SchemeAuthorityPathQuery 调用 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

<none>

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

<none>

file://server/filename.ext

file://

file://server

file://server/filename.ext

file://server/filename.ext

下面的示例创建一个 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());


// Create Uri
Uri uriAddress = new Uri("http://www.contoso.com/index.htm#search");
Console.WriteLine(uriAddress.get_Fragment());
Console.WriteLine("Uri {0} the default port ", 
    (uriAddress.get_IsDefaultPort()) ? "uses" : "does not use");

Console.WriteLine("The path of this Uri is {0}",
    uriAddress.GetLeftPart(UriPartial.Path));
Console.WriteLine("Hash code {0}",
    (System.Int32)uriAddress.GetHashCode());


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360

.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求

.NET Framework

受以下版本支持:3.5、3.0、2.0、1.1、1.0

.NET Compact Framework

受以下版本支持:3.5、2.0、1.0

XNA Framework

受以下版本支持:2.0、1.0
显示: