.NET Framework クラス ライブラリ リファレンス

Uri.IsBaseOf メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

現在の Uri インスタンスが、指定した Uri のベースかどうかを判断します。

名前空間: System
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Function IsBaseOf ( _
    uri As Uri _
) As Boolean

Visual Basic (使用法)

Dim instance As Uri
Dim uri As Uri
Dim returnValue As Boolean

returnValue = instance.IsBaseOf(uri)

C#

public bool IsBaseOf (
    Uri uri
)

C++

public:
bool IsBaseOf (
    Uri^ uri
)

J#

public boolean IsBaseOf (
    Uri uri
)

JScript

public function IsBaseOf (
    uri : Uri
) : boolean

パラメータ

uri

テスト対象に指定する Uri。

戻り値
現在の Uri インスタンスが uri のベースである場合は true。それ以外の場合は false。

解説

IsBaseOf を使用して、指定した Uri と現在の Uri インスタンスを比較し、この URI が、指定した Uri のベースであるかどうかを判断します。2 つの Uri オブジェクトを比較して、ベース関係を判断する場合、ユーザー情報 (UserInfo) は評価されません。2 つの URI (uri1 と uri2) の比較で、最後のスラッシュの後ろをすべて無視した場合にこれら 2 つの URI が同じであるときは、uri1 は uri2 のベースです。次の表では、http://host/path/path/file?query をベース URI として使用し、この URI が他の URI のベースであるかどうかを示します。

URI	http://host/path/path/file?query が次の URI のベースかどうか
http://host/path/path/file/	○
http://host/path/path/#fragment	○
http://host/path/path/MoreDir/"	○
http://host/path/path/OtherFile?Query	○
http://host/path/path/	○
http://host/path/path/file	○
http://host/path/path	×
http://host/path/path?query	×
http://host/path/path#Fragment	×
http://host/path/path2/	×
http://host/path/path2/MoreDir	×
http://host/path/File	×

使用例

この例では、ベース Uri インスタンスを表す Uri インスタンスを作成します。また、文字列から 2 つ目の Uri インスタンスを作成します。さらに、IsBaseOf を呼び出して、ベース インスタンスが 2 つ目のインスタンスのベースであるかどうかを判断します。結果がコンソールに出力されます。

Visual Basic

' Create a base Uri.
Dim baseUri As New Uri("http://www.contoso.com/")

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

' Determine whether BaseUri is a base of UriAddress.  
If baseUri.IsBaseOf(uriAddress) Then
    Console.WriteLine("{0} is the base of {1}", baseUri,
 uriAddress)
End If

C#

// 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 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

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Uri クラス
Uri メンバ
System 名前空間