Uri.Equals Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Overload

Equals(Object)

Confronta due istanze Uri per verificare l'uguaglianza.

Equals(Object)

Origine:

Uri.cs

Confronta due istanze Uri per verificare l'uguaglianza.

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

Parametri

comparand

Object

URI o identificatore URI da confrontare con l'istanza corrente.

Restituisce

Boolean

true se le due istanze rappresentano lo stesso URI; in caso contrario, false.

Esempio

Questo esempio crea due istanze di Uri dalle stringhe e le confronta per determinare se rappresentano lo stesso valore. address1 e address2 sono uguali perché la parte Fragment viene ignorata per questo confronto. Il risultato viene scritto nella 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"

Commenti

Il metodo Equals confronta le due istanze senza considerare le informazioni utente (UserInfo) e frammento (Fragment) parti che potrebbero contenere. Ad esempio, dato che gli URI http://www.contoso.com/index.htm#search e http://user:password@www.contoso.com/index.htm, il metodo Equals restituirà true.

Se un'istanza Uri viene formata con un nome host Unicode e comparand parametro contiene un'istanza o un identificatore Uri formato con un nome host con il nome host Punycode equivalente, Equals restituisce true solo se è abilitato il supporto IRI (International Resource Identifier) e Internationalized Domain Name (IDN). I nomi punycode contengono solo caratteri ASCII e iniziano sempre con il prefisso xn- .

Per altre informazioni sul supporto IRI, vedere la sezione Osservazioni per la classe Uri.

Nota

In .NET Framework versioni 1.0 e 1.1, viene ignorato anche il Query.

Nota

Il metodo Equals può essere sottoposto a override in una classe derivata; prestare attenzione perché un'entità dannosa potrebbe modificare il metodo . Non utilizzare questo metodo per eseguire controlli di sicurezza, a meno che non si sappia che questa istanza proviene da un'origine attendibile.