Uri.GetLeftPart メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

Uri.GetLeftPart メソッド

Uri インスタンスの指定部分を返します。

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

Visual Basic (宣言)

Public Function GetLeftPart ( _
    part As UriPartial _
) As String

Visual Basic (使用法)

Dim instance As Uri
Dim part As UriPartial
Dim returnValue As String

returnValue = instance.GetLeftPart(part)

public string GetLeftPart (
    UriPartial part
)

C++

public:
String^ GetLeftPart (
    UriPartial part
)

public String GetLeftPart (
    UriPartial part
)

JScript

public function GetLeftPart (
    part : UriPartial
) : String

パラメータ

part: UriPartial 値のうち、返される URI 部分の末尾を指定する値。

戻り値
Uri インスタンスの指定部分を含む String。

例外

例外の種類	条件
InvalidOperationException	現在の Uri インスタンスは、絶対インスタンスではありません。
ArgumentException	指定した part が有効ではありません。

解説

GetLeftPart メソッドは、URI 文字列の左端から part により指定された位置までの部分を格納した文字列を返します。

GetLeftPart が返す文字列に区切り記号が含まれる状況を次に示します。

Scheme にスキーム区切り記号が含まれている。
Authority にパス区切り記号が含まれていない。
Path に、元の URI のクエリまたはフラグメントの区切り記号以外の区切り記号が含まれている。
Query に Path、クエリ、およびクエリの区切り記号が含まれている。

次に示す例は、Scheme、Authority、Path、または Query を指定して GetLeftPart を呼び出した結果と URI を示しています。

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	なし
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	なし
file://server/filename.ext	file://	file://server	file://server/filename.ext	file://server/filename.ext

使用例

Uri インスタンスを作成し、パスをコンソールに出力する例を次に示します。

Visual Basic

' Create Uri
Dim uriAddress As New Uri("http://www.contoso.com/index.htm#search")
Console.WriteLine(uriAddress.Fragment)
Console.WriteLine("Uri {0} the default port ", IIf(uriAddress.IsDefaultPort,
 "uses", "does not use"))
 'TODO: For performance reasons this should be changed to nested IF statements

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.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());