C#のUri.ToString()メソッドの使い方を徹底解説

Uri.ToString()メソッドとは

C#のUri.ToString()メソッドは、指定されたUriインスタンスの正規（カノニカル）な文字列表現を取得するためのメソッドです。Uriオブジェクトを文字列として扱いたい場合や、コンソール・画面に表示したい場合などに利用されます。

構文

Uri.ToString()メソッドの構文は以下のとおりです。

public override string ToString();

使用例

ここでは、Uri.ToString()メソッドを使った具体的なサンプルコードを紹介します。この例では、2つのUriインスタンスを作成し、それぞれの文字列表現を取得して表示しています。さらに、Equals()メソッドによる等価性の比較や、MakeRelativeUri()メソッドによる相対URIの生成もあわせて確認できます。

using System;
public class Demo {
   public static void Main(){
      // 1つ目のUriインスタンスを作成
      Uri newURI1 = new Uri("https://www.tutorialspoint.com/");
      Console.WriteLine("URI = " + newURI1);
      Console.WriteLine("String representation = " + newURI1.ToString());

      // フラグメント（#abcd）を含む2つ目のUriインスタンスを作成
      Uri newURI2 = new Uri("https://www.tutorialspoint.com/jquery.htm#abcd");
      Console.WriteLine("\nURI = " + newURI2);
      Console.WriteLine("String representation = " + newURI2.ToString());

      // 2つのURIが等しいかどうかを比較
      if (newURI1.Equals(newURI2))
         Console.WriteLine("\nBoth the URIs are equal!");
      else
         Console.WriteLine("\nBoth the URIs aren't equal!");

      // 相対URIを生成
      Uri res = newURI1.MakeRelativeUri(newURI2);
      Console.WriteLine("Relative uri = " + res);
   }
}

実行結果

上記のコードを実行すると、以下のような出力が得られます。

URI = https://www.tutorialspoint.com/
String representation = https://www.tutorialspoint.com/
URI = https://www.tutorialspoint.com/jquery.htm#abcd
String representation = https://www.tutorialspoint.com/jquery.htm#abcd
Both the URIs aren't equal!
Relative uri = jquery.htm#abcd

ポイントまとめ

• ToString()メソッドは、Uriオブジェクトの正規の文字列表現を返します。
• Console.WriteLineでUriを直接出力する場合も、内部的にはToString()が呼び出されるため、同じ結果になります。
• フラグメント（#以降の部分）を含むURIも、そのまま文字列として取得できます。