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

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

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

Uri.ToString メソッド

指定した Uri インスタンスの正規文字列形式を返します。

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

Visual Basic (宣言)

Public Overrides Function
 ToString As String

Visual Basic (使用法)

Dim instance As Uri
Dim returnValue As String

returnValue = instance.ToString

public override string ToString ()

C++

public:
virtual String^ ToString () override

public String ToString ()

JScript

public override function ToString () : String

戻り値
エスケープ解除された正規形式の Uri インスタンスを格納している String インスタンス。#、?、および % 以外のすべての文字は、エスケープ解除されます。

解説

ポートがスキームの既定ポートである場合、このメソッドで返される文字列にはポート情報が含まれません。

メモ
ToString メソッドで返される文字列には、コンソールアプリケーションの状態を破損させる制御文字が含まれることがあります。返される文字列から制御文字を削除するには、GetComponents メソッドを UriFormat.SafeUnescaped 形式で使用します。

使用例

文字列から新しい Uri インスタンスを作成する例を次に示します。この例では、コンストラクタに渡した文字列を返す OriginalString の戻り値と、正規形式の文字列を返す ToString の呼び出しの戻り値の相違を示します。

Visual Basic

    ' Create a new Uri from a string address.
    Dim uriAddress As New
 Uri("HTTP://www.Contoso.com:80//thick%20and%20thin.htm")
    
    ' Write the new Uri to the console and note the difference in the
 two values.
    ' ToString() gives the canonical version.  OriginalString gives
 the orginal 
    ' string that was passed to the constructor.
    ' The following outputs "http://www.contoso.com/thick and thin.htm".
    Console.WriteLine(uriAddress.ToString())
    
    ' The following outputs "HTTP://www.Contoso.com:80//thick%20and%20thin.htm".
    Console.WriteLine(uriAddress.OriginalString)

End Sub 'SampleToString

// Create a new Uri from a string address.
Uri uriAddress = new Uri("HTTP://www.Contoso.com:80//thick%20and%20thin.htm");

// Write the new Uri to the console and note the difference in the two
 values.
// ToString() gives the canonical version.  OriginalString gives the
 orginal 
// string that was passed to the constructor.

// The following outputs "http://www.contoso.com/thick and thin.htm".
Console.WriteLine(uriAddress.ToString()); 

// The following outputs "HTTP://www.Contoso.com:80//thick%20and%20thin.htm".
Console.WriteLine(uriAddress.OriginalString);