Uri.Equals Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Surcharges

Equals(Object)

Compare deux instances Uri pour l’égalité.

Equals(Object)

Source:

Uri.cs

Compare deux instances Uri pour l’égalité.

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

Paramètres

comparand

Object

URI ou identificateur d’URI à comparer à l’instance actuelle.

Retours

Boolean

true si les deux instances représentent le même URI ; sinon, false.

Exemples

Cet exemple crée deux instances Uri à partir de chaînes et les compare pour déterminer s’ils représentent la même valeur. address1 et address2 sont identiques, car la partie Fragment est ignorée pour cette comparaison. Le résultat est écrit dans la console.

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

Remarques

La méthode Equals compare les deux instances sans tenir compte des informations utilisateur (UserInfo) et des parties fragment (Fragment) qu’elles peuvent contenir. Par exemple, étant donné les URI http://www.contoso.com/index.htm#search et http://user:password@www.contoso.com/index.htm, la méthode Equals retourne true.

Si une instance Uri est formée avec un nom d’hôte Unicode et que comparand paramètre contient une instance ou un identificateur Uri formé avec un nom d’hôte ayant le nom d’hôte Punycode équivalent, Equals retourne true uniquement si la prise en charge de l’identificateur de domaine international (IRI) et du nom de domaine international (IDN) est activée. Les noms Punycode contiennent uniquement des caractères ASCII et commencent toujours par le préfixe xn- .

Pour plus d’informations sur la prise en charge de l’IRI, consultez la section Remarques pour la classe Uri.

Note

Dans les versions 1.0 et 1.1 du .NET Framework, la Query est également ignorée.

Note

La méthode Equals peut être substituée dans une classe dérivée ; utilisez la prudence en tant qu’entité malveillante peut modifier la méthode. Vous ne devez pas utiliser cette méthode pour effectuer des vérifications de sécurité, sauf si vous savez que cette instance provient d’une source approuvée.