Uri.Equals Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Sobrecargas

Equals(Object)

Compara dos instancias de Uri para obtener igualdad.

Equals(Object)

Source:

Uri.cs

Compara dos instancias de Uri para obtener igualdad.

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

Parámetros

comparand

Object

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

Devoluciones

Boolean

true si las dos instancias representan el mismo URI; de lo contrario, false.

Ejemplos

En este ejemplo se crean dos instancias de Uri a partir de cadenas y se comparan para determinar si representan el mismo valor. address1 y address2 son los mismos porque la parte Fragment 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 método Equals compara las dos instancias sin tener en cuenta la información del usuario (UserInfo) y las partes de fragmento (Fragment) que pueden contener. Por ejemplo, dados los URI http://www.contoso.com/index.htm#search y http://user:password@www.contoso.com/index.htm, el método Equals devolvería true.

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

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

Nota

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

Nota

El método Equals se puede invalidar en una clase derivada; tenga precaución ya que 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.