Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Uri.GetLeftPart Method

Gets the specified portion of a Uri instance.

Namespace:  System
Assembly:  System (in System.dll)

public function GetLeftPart(
	part : UriPartial
) : String

Parameters

part
Type: System.UriPartial

One of the UriPartial values that specifies the end of the URI portion to return.

Return Value

Type: System.String
A String that contains the specified portion of the Uri instance.

ExceptionCondition
InvalidOperationException

The current Uri instance is not an absolute instance.

ArgumentException

The specified part is not valid.

The GetLeftPart method returns a string containing the leftmost portion of the URI string, ending with the portion specified by part.

GetLeftPart includes delimiters in the following cases:

  • Scheme includes the scheme delimiter.

  • Authority does not include the path delimiter.

  • Path includes any delimiters in the original URI up to the query or fragment delimiter.

  • Query includes the Path, plus the query and its delimiter.

The following examples show a URI and the results of calling GetLeftPart with Scheme, Authority, Path, or Query.

URI

Scheme

Authority

Path

Query

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

The following example creates a Uri instance and writes the path to the console.

No code example is currently available or this language may not be supported.
// Create Uri
Uri* uriAddress = new Uri(S"http://www.contoso.com/index.htm#search");
Console::WriteLine(uriAddress->Fragment);
Console::WriteLine(S"Uri {0} the default port ", uriAddress->IsDefaultPort ? S"uses" : S"does not use");

Console::WriteLine(S"The path of this Uri is {0}", uriAddress->GetLeftPart(UriPartial::Path));
Console::WriteLine(S"Hash code {0}", __box(uriAddress->GetHashCode()));

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, 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, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0

Community Additions

Show:
© 2014 Microsoft