C#のUri.Equals（Object）メソッドの使い方を徹底解説

C#のUri.Equals()メソッドは、2つのUriインスタンスが等しいかどうかを比較するためのメソッドです。Webアプリケーション開発などでURLの同一性を確認したい場合に活用できます。

構文

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

public override bool Equals (object comparand);

パラメータ「comparand」には、現在のインスタンスと比較対象となるUriインスタンスまたはURI識別子を指定します。戻り値はbool型で、2つのURIが等しい場合はtrue、等しくない場合はfalseが返されます。

使用例1：同じURI同士の比較

まず、まったく同じURIを持つ2つのUriインスタンスを比較してみましょう。

using System;

public class Demo {
    public static void Main() {
        Uri newURI1 = new Uri("https://www.tutorialspoint.com/index.htm");
        Console.WriteLine("URI = " + newURI1);

        Uri newURI2 = new Uri("https://www.tutorialspoint.com/index.htm");
        Console.WriteLine("URI = " + newURI2);

        if (newURI1.Equals(newURI2))
            Console.WriteLine("両方のURIは等しいです！");
        else
            Console.WriteLine("両方のURIは等しくありません！");
    }
}

出力

このプログラムを実行すると、次のような結果が出力されます。

URI = https://www.tutorialspoint.com/index.htm
URI = https://www.tutorialspoint.com/index.htm
両方のURIは等しいです！

スキーム（https）もパス（index.htm）も完全に一致しているため、Equals()メソッドはtrueを返しています。

使用例2：異なるURI同士の比較

次に、パスが異なる2つのUriインスタンスを比較してみましょう。

using System;

public class Demo {
    public static void Main() {
        Uri newURI1 = new Uri("https://www.tutorialspoint.com/index.htm");
        Console.WriteLine("URI = " + newURI1);

        Uri newURI2 = new Uri("https://www.tutorialspoint.com/");
        Console.WriteLine("URI = " + newURI2);

        if (newURI1.Equals(newURI2))
            Console.WriteLine("両方のURIは等しいです！");
        else
            Console.WriteLine("両方のURIは等しくありません！");
    }
}

出力

このプログラムを実行すると、次のような結果が出力されます。

URI = https://www.tutorialspoint.com/index.htm
URI = https://www.tutorialspoint.com/
両方のURIは等しくありません！

一方は「index.htm」というファイル名を含むパス、もう一方はルートディレクトリを指しているため、2つのURIは等しくないと判定されました。

まとめ

Uri.Equals()メソッドを使うことで、スキームやホスト名、パスなどを含むURI全体が一致しているかどうかを簡単に判定できます。URLの比較処理を実装する際は、文字列比較ではなくこのメソッドを使用することで、URIとして正確な等価性チェックが可能になります。