Uri.Equals Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Overload

Equals(Object)

Membandingkan dua instans Uri untuk kesetaraan.

Equals(Object)

Sumber:

Uri.cs

Membandingkan dua instans Uri untuk kesetaraan.

public:
 override bool Equals(System::Object ^ comparand);

public override bool Equals (object? comparand);

override this.Equals : obj -> bool

Public Overrides Function Equals (comparand As Object) As Boolean

Parameter

comparand

Object

URI atau pengidentifikasi URI untuk dibandingkan dengan instans saat ini.

Mengembalikan

Boolean

true jika kedua instans mewakili URI yang sama; jika tidak, false.

Contoh

Contoh ini membuat dua instans Uri dari string dan membandingkannya untuk menentukan apakah instans tersebut mewakili nilai yang sama. address1 dan address2 sama karena bagian Fragment diabaikan untuk perbandingan ini. Hasilnya ditulis ke konsol.

// Create some Uris.
Uri^ address1 = gcnew Uri( "http://www.contoso.com/index.htm#search" );
Uri^ address2 = gcnew Uri( "http://www.contoso.com/index.htm" );
if ( address1->Equals( address2 ) )
{
   Console::WriteLine( "The two addresses are equal" );
}
else
{
   Console::WriteLine( "The two addresses are not equal" );
}
// Will output "The two addresses are equal"

// Create some Uris.
Uri address1 = new Uri("http://www.contoso.com/index.htm#search");
Uri address2 = new Uri("http://www.contoso.com/index.htm");
if (address1.Equals(address2))
    Console.WriteLine("The two addresses are equal");
else
    Console.WriteLine("The two addresses are not equal");
// Will output "The two addresses are equal"

// Create some Uris.
let address1 = Uri "http://www.contoso.com/index.htm#search"
let address2 = Uri "http://www.contoso.com/index.htm"
if address1.Equals address2 then
    printfn "The two addresses are equal"
else
    printfn "The two addresses are not equal"
// Will output "The two addresses are equal"

' Create some Uris.
Dim address1 As New Uri("http://www.contoso.com/index.htm#search")
Dim address2 As New Uri("http://www.contoso.com/index.htm")
If address1.Equals(address2) Then
    Console.WriteLine("The two addresses are equal")
Else
    Console.WriteLine("The two addresses are not equal")
End If
' Will output "The two addresses are equal"

Keterangan

Metode Equals membandingkan dua instans tanpa memperhatikan informasi pengguna (UserInfo) dan bagian fragmen (Fragment) yang mungkin dikandungnya. Misalnya, mengingat URI http://www.contoso.com/index.htm#search dan http://user:password@www.contoso.com/index.htm, metode Equals akan mengembalikan true.

Jika satu instans Uri dibentuk dengan nama host Unicode dan parameter comparand berisi instans atau pengidentifikasi Uri yang dibentuk dengan nama host yang memiliki nama host Punycode yang setara, maka Equals mengembalikan true hanya jika dukungan International Resource Identifier (IRI) dan Internationalized Domain Name (IDN) diaktifkan. Nama punycode hanya berisi karakter ASCII dan selalu dimulai dengan awalan xn-- .

Untuk informasi selengkapnya tentang dukungan IRI, lihat bagian Keterangan untuk kelas Uri.

Nota

Dalam .NET Framework versi 1.0 dan 1.1, Query juga diabaikan.

Nota

Metode Equals dapat ditimpa dalam kelas turunan; berhati-hatilah karena entitas berbahaya dapat memodifikasi metode . Anda tidak boleh menggunakan metode ini untuk melakukan pemeriksaan keamanan kecuali Anda tahu bahwa instans ini berasal dari sumber tepercaya.