Uri.Equals(Object) Método

Definición

Compara dos instancias de Uri para determinar si sus valores son iguales.

public:
 override bool Equals(System::Object ^ comparand);
public override bool Equals (object comparand);
public override bool Equals (object? comparand);
override this.Equals : obj -> bool
Public Overrides Function Equals (comparand As Object) As Boolean

Parámetros

comparand
Object

El URI o identificador URI que se va a comparar con la instancia actual.

Devoluciones

Boolean

true si las dos instancias representan el mismo URI; en caso contrario, false.

Ejemplos

En este ejemplo se crean dos Uri instancias a partir de cadenas y se comparan para determinar si representan el mismo valor. address1 y address2 son los mismos porque la Fragment parte se omite para esta comparación. El resultado se escribe en la consola.

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

Comentarios

El Equals método compara las dos instancias sin tener en cuenta las partes de información del usuario (UserInfo) y fragmento (Fragment) que podrían contener. Por ejemplo, dados los URI http://www.contoso.com/index.htm#search y http://user:password@www.contoso.com/index.htm, el Equals método devolvería true.

Si una Uri instancia se forma con un nombre de host Unicode y comparand un parámetro contiene una Uri instancia o un identificador formado con un nombre de host que tiene el nombre de host punycode equivalente, Equals solo devuelve true si se habilita la compatibilidad con el identificador de recursos internacional (IRI) y el nombre de dominio internacional (IDN). Los nombres de Punycode solo contienen caracteres ASCII y siempre empiezan con el prefijo xn--.

Para obtener más información sobre la compatibilidad con IRI, vea la sección Comentarios de la Uri clase .

Nota

En las versiones 1.0 y 1.1 de .NET Framework, Query también se omite .

Nota

El Equals método se puede invalidar en una clase derivada; tenga cuidado porque una entidad malintencionada podría modificar el método. No debe usar este método para realizar comprobaciones de seguridad a menos que sepa que esta instancia procede de un origen de confianza.

Se aplica a