Uri::GetLeftPart Method
Gets the specified portion of a Uri instance.
Assembly: System (in System.dll)
Parameters
- part
- Type: System::UriPartial
One of the UriPartial values that specifies the end of the URI portion to return.
| Exception | Condition |
|---|---|
| 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.
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.
// Create Uri Uri^ uriAddress = gcnew Uri( "http://www.contoso.com/index.htm#search" ); Console::WriteLine( uriAddress->Fragment ); Console::WriteLine( "Uri {0} the default port ", uriAddress->IsDefaultPort ? (String^)"uses" : "does not use" ); Console::WriteLine( "The path of this Uri is {0}", uriAddress->GetLeftPart( UriPartial::Path ) ); Console::WriteLine( "Hash code {0}", uriAddress->GetHashCode() );
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.