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.IsBaseOf Method

Determines whether the current Uri instance is a base of the specified Uri instance.

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

public bool IsBaseOf (
	Uri uri
)
public boolean IsBaseOf (
	Uri uri
)
public function IsBaseOf (
	uri : Uri
) : boolean
Not applicable.

Parameters

uri

The specified Uri instance to test.

Return Value

true if the current Uri instance is a base of uri; otherwise, false.

IsBaseOf is used to compare the current Uri instance to a specified Uri to determine whether this URI is a base for the specified Uri. When comparing two Uri objects to determine a base relationship, the user information (UserInfo) is not evaluated. When comparing two URIs (uri1 and uri2), uri1 is the base of uri2 if, when you ignore everything in uri2 after the last slash (/), the two URIs are identical. Using http://host/path/path/file?query as the base URI, the following table shows whether it is a base for other URIs.

URI

http://host/path/path/file?query is base of

http://host/path/path/file/

yes

http://host/path/path/#fragment

yes

http://host/path/path/MoreDir/"

yes

http://host/path/path/OtherFile?Query

yes

http://host/path/path/

yes

http://host/path/path/file

yes

http://host/path/path

no

http://host/path/path?query

no

http://host/path/path#Fragment

no

http://host/path/path2/

no

http://host/path/path2/MoreDir

no

http://host/path/File

no

This example creates a Uri instance that represents a base Uri instance. It then creates a second Uri instance from a string. It calls IsBaseOf to determine whether the base instance is the base of the second instance. The outcome is written to the console.

// Create a base Uri.
Uri baseUri = new Uri("http://www.contoso.com/");

// Create a new Uri from a string.
Uri uriAddress = new Uri("http://www.contoso.com/index.htm?date=today"); 

// Determine whether BaseUri is a base of UriAddress.  
if (baseUri.IsBaseOf(uriAddress))
    Console.WriteLine("{0} is the base of {1}", baseUri, uriAddress);

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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

.NET Compact Framework

Supported in: 2.0

XNA Framework

Supported in: 1.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft