Uri.Equals(Object) Uri.Equals(Object) Uri.Equals(Object) Uri.Equals(Object) Method

Definição

Compara duas instâncias de Uri quanto à igualdade.Compares two Uri instances for equality.

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 Object Object Object

A instância de Uri ou um identificador de URI a ser comparado à instância atual.The Uri instance or a URI identifier to compare with the current instance.

Retornos

Um valor de Boolean que é true se as duas instâncias representarem o mesmo URI. Caso contrário, false.A Boolean value that is true if the two instances represent the same URI; otherwise, false.

Exemplos

Este exemplo cria duas Uri instâncias de cadeias de caracteres e as compara para determinar se elas representam o mesmo valor.This example creates two Uri instances from strings and compares them to determine whether they represent the same value. address1e address2 são os mesmos porque a Fragment parte é ignorada para essa comparação.address1 and address2 are the same because the Fragment portion is ignored for this comparison. O resultado é gravado no console.The outcome is written to the 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.
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"

Comentários

O Equals método compara as duas instâncias sem considerar as partes de informaçõesUserInfodo usuário ()Fragmente de fragmento () que elas podem conter.The Equals method compares the two instances without regard to user information (UserInfo) and fragment (Fragment) parts that they might contain. Por exemplo, considerando os URIs http://www.contoso.com/index.htm#search e http://user:password@www.contoso.com/index.htm, o Equals método retornaria true.For example, given the URIs http://www.contoso.com/index.htm#search and http://user:password@www.contoso.com/index.htm, the Equals method would return true.

Se uma Uri instância for formada com um nome de host comparand Unicode e o Uri parâmetro contiver uma instância ou um identificador que é formado com um nome de host que tem o Equals nome true de host Punycode equivalente e, em seguida, retorna somente se o IRI (identificador de recurso internacional) e o suporte a IDN (nome de domínio internacionalizado) estiverem habilitados.If one Uri instance is formed with a Unicode host name and comparand parameter contains a Uri instance or identifier that is formed with a host name that has the equivalent Punycode host name, then Equals returns true only if International Resource Identifier (IRI) and Internationalized Domain Name (IDN) support are enabled. Os nomes Punycode contêm apenas caracteres ASCII e sempre começam com o prefixo xn--.Punycode names contain only ASCII characters and always start with the xn-- prefix.

Para obter mais informações sobre o suporte IRI, consulte a seção Comentários da classe Uri.For more information on IRI support, see the Remarks section for the Uri class.

Observação

No .NET Framework versões 1,0 e 1,1, o Query também é ignorado.In the .NET Framework versions 1.0 and 1.1, the Query is also ignored.

Observação

O Equals método pode ser substituído em uma classe derivada; tenha cuidado, pois uma entidade mal-intencionada pode modificar o método.The Equals method can be overridden in a derived class; use caution as a malicious entity could modify the method. Você não deve usar esse método para executar verificações de segurança, a menos que saiba que essa instância veio de uma fonte confiável.You should not use this method to perform security checks unless you know that this instance came from a trusted source.

Segurança

SecurityPermission
para impedir que códigos parcialmente confiáveis sejam derivados de Uri.to prevent partially trusted code from deriving from Uri. Enumeração associada: Infrastructure.Associated enumeration: Infrastructure.

Aplica-se a