Uri.Equals Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Überlädt

Equals(Object)

Vergleicht zwei Uri Instanzen für Gleichheit.

Equals(Object)

Quelle:

Uri.cs

Vergleicht zwei Uri Instanzen für Gleichheit.

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

Parameter

comparand

Object

Der URI oder ein URI-Bezeichner, der mit der aktuellen Instanz verglichen werden soll.

Gibt zurück

Boolean

true, wenn die beiden Instanzen denselben URI darstellen; andernfalls false.

Beispiele

In diesem Beispiel werden zwei Uri Instanzen aus Zeichenfolgen erstellt und verglichen, um festzustellen, ob sie denselben Wert darstellen. address1 und address2 sind identisch, da der Fragment Teil für diesen Vergleich ignoriert wird. Das Ergebnis wird in die Konsole geschrieben.

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

Hinweise

Die Equals-Methode vergleicht die beiden Instanzen, ohne dass benutzerinformationen (UserInfo) und Fragmentteile (Fragment) enthalten sind, die sie enthalten können. Bei den URIs http://www.contoso.com/index.htm#search und http://user:password@www.contoso.com/index.htmwürde die Equals-Methode z. B. truezurückgeben.

Wenn eine Uri Instanz mit einem Unicode-Hostnamen gebildet wird und comparand Parameter eine Uri Instanz oder einen Bezeichner enthält, die mit einem Hostnamen mit dem entsprechenden Punycode-Hostnamen gebildet wird, gibt Equals nur true zurück, wenn international Resource Identifier (IRI) und Internationalized Domain Name (IDN)-Unterstützung aktiviert sind. Punycode-Namen enthalten nur ASCII-Zeichen und beginnen immer mit dem Xn-Präfix.

Weitere Informationen zur IRI-Unterstützung finden Sie im Abschnitt "Hinweise" für die Uri Klasse.

Anmerkung

In den .NET Framework-Versionen 1.0 und 1.1 wird auch die Query ignoriert.

Anmerkung

Die Equals-Methode kann in einer abgeleiteten Klasse überschrieben werden; Verwenden Sie Vorsicht, da eine böswillige Entität die Methode ändern könnte. Sie sollten diese Methode nicht verwenden, um Sicherheitsprüfungen durchzuführen, es sei denn, Sie wissen, dass diese Instanz von einer vertrauenswürdigen Quelle stammt.