Uri.Equals Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Przeciążenia

Equals(Object)

Porównuje dwa wystąpienia Uri pod kątem równości.

Equals(Object)

Źródło:

Uri.cs

Porównuje dwa wystąpienia Uri pod kątem równości.

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

Parametry

comparand

Object

Identyfikator URI lub identyfikator URI do porównania z bieżącym wystąpieniem.

Zwraca

Boolean

true, jeśli dwa wystąpienia reprezentują ten sam identyfikator URI; w przeciwnym razie false.

Przykłady

W tym przykładzie tworzone są dwa wystąpienia Uri z ciągów i porównuje je w celu określenia, czy reprezentują tę samą wartość. address1 i address2 są takie same, ponieważ część Fragment jest ignorowana dla tego porównania. Wynik jest zapisywany w konsoli programu .

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

Uwagi

Metoda Equals porównuje dwa wystąpienia bez względu na informacje o użytkowniku (UserInfo) i fragment (Fragment) części, które mogą zawierać. Na przykład biorąc pod uwagę identyfikatory URI http://www.contoso.com/index.htm#search i http://user:password@www.contoso.com/index.htm, metoda Equals zwróci true.

Jeśli jedno wystąpienie Uri jest tworzone z nazwą hosta Unicode, a parametr comparand zawiera wystąpienie Uri lub identyfikator, który jest tworzony z nazwą hosta o równoważnej nazwie hosta Punycode, Equals zwraca true tylko wtedy, gdy obsługa międzynarodowego identyfikatora zasobu (IRI) i międzynarodowych nazw domen (IDN) jest włączona. Nazwy punycode zawierają tylko znaki ASCII i zawsze zaczynają się od prefiksu xn-.

Aby uzyskać więcej informacji na temat obsługi IRI, zobacz sekcję Uwagi dla klasy Uri.

Nuta

W programie .NET Framework w wersji 1.0 i 1.1 Query jest również ignorowany.

Nuta

Metodę Equals można zastąpić w klasie pochodnej; należy zachować ostrożność, ponieważ złośliwa jednostka może zmodyfikować metodę. Nie należy używać tej metody do przeprowadzania kontroli zabezpieczeń, chyba że wiadomo, że to wystąpienie pochodzi z zaufanego źródła.