Uri.Equals Metoda

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Přetížení

Equals(Object)

Porovná dvě Uri instance rovnosti.

Equals(Object)

Zdroj:

Uri.cs

Porovná dvě Uri instance rovnosti.

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

Parametry

comparand

Object

Identifikátor URI nebo identifikátor URI pro porovnání s aktuální instancí.

Návraty

Boolean

true, pokud dvě instance představují stejný identifikátor URI; jinak false.

Příklady

Tento příklad vytvoří ze řetězců dvě Uri instance a porovná je, aby bylo možné určit, jestli představují stejnou hodnotu. address1 a address2 jsou stejné, protože část Fragment je pro toto porovnání ignorována. Výsledek se zapíše do konzoly.

// 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"

Poznámky

Metoda Equals porovnává dvě instance bez ohledu na informace o uživateli (UserInfo) a části fragmentu (Fragment), které mohou obsahovat. Například vzhledem k identifikátorům URI http://www.contoso.com/index.htm#search a http://user:password@www.contoso.com/index.htmby metoda Equals vrátila true.

Pokud je jedna instance Uri vytvořena s názvem hostitele Unicode a comparand parametr obsahuje Uri instanci nebo identifikátor, který je vytvořen s názvem hostitele, který má ekvivalentní název hostitele Punycode, pak Equals vrátí true pouze v případě, že je povolena podpora International Resource Identifier (IRI) a Internationalized Domain Name (IDN). Punycode names contain only ASCII characters and always start with the xn-- prefix.

Další informace o podpoře IRI naleznete v části Poznámky pro Uri třídy.

Poznámka

V rozhraní .NET Framework verze 1.0 a 1.1 se Query také ignoruje.

Poznámka

Metodu Equals lze přepsat v odvozené třídě; buďte opatrní, protože škodlivá entita by mohla tuto metodu upravit. Tuto metodu byste neměli používat k provádění kontrol zabezpečení, pokud nevíte, že tato instance pochází z důvěryhodného zdroje.