Uri.Compare(Uri, Uri, UriComponents, UriFormat, StringComparison) Method

Definition

Compares the specified parts of two URIs using the specified comparison rules.

public:
 static int Compare(Uri ^ uri1, Uri ^ uri2, UriComponents partsToCompare, UriFormat compareFormat, StringComparison comparisonType);
public static int Compare (Uri uri1, Uri uri2, UriComponents partsToCompare, UriFormat compareFormat, StringComparison comparisonType);
public static int Compare (Uri? uri1, Uri? uri2, UriComponents partsToCompare, UriFormat compareFormat, StringComparison comparisonType);
static member Compare : Uri * Uri * UriComponents * UriFormat * StringComparison -> int
Public Shared Function Compare (uri1 As Uri, uri2 As Uri, partsToCompare As UriComponents, compareFormat As UriFormat, comparisonType As StringComparison) As Integer

Parameters

uri1
Uri

The first URI.

uri2
Uri

The second URI.

partsToCompare
UriComponents

A bitwise combination of the UriComponents values that specifies the parts of uri1 and uri2 to compare.

compareFormat
UriFormat

One of the enumeration values that specifies the character escaping used when the URI components are compared.

comparisonType
StringComparison

One of the enumeration values that specifies the culture, case, and sort rules for the comparison.

Returns

A value that indicates the lexical relationship between the compared Uri components.

Value Meaning
Less than zero uri1 is less than uri2.
Zero uri1 equals uri2.
Greater than zero uri1 is greater than uri2.

Exceptions

comparisonType is not a valid StringComparison value.

Remarks

If both uri1 and uri2 are null, this method returns 0. When comparing URI values, a relative URI is always less than an absolute URI, and a non-null URI is always greater than a null URI. For cases where both uri1 and uri2 are not null and are both relative URIs or both absolute URIs, the String.Compare(String, String, StringComparison) method performs the comparison.

Applies to