UriHelper.Combine Method

Namespace

Kampute.DocToolkit.Support

Assembly

Definition

Creates a new Uri by combining the Uri with a relative URI string.

public static Uri Combine(this Uri baseUri, string relativeUri)

Uri: A new Uri that represents the combination of the base Uri and the relative URI string.

ArgumentNullException: Thrown when baseUri is null.
ArgumentException: Thrown when relativeUri attempts to navigate beyond the root directory.

This method combines the base Uri with a relative URI string according to the following rules:

Path–If the path of relativeUri starts with a forward slash, it replaces the base URI's path; otherwise, it is appended to the base URI's path.
Query–The query string of the resulting URI is a combination of the base URI's query string and the relative URI's query string.
Fragment–If relativeUri contains a fragment, it replaces the base URI's fragment; otherwise, the base URI's fragment is preserved.

There are some differences between URIs created using this method and those created using the Uri(Uri, string) constructor:

Aspect	This Method	Uri Constructor
Path handling	Appends path segments with a separator if needed. If the relative path starts with '/', it replaces the base path.	Uses URI resolution rules per RFC 3986, which can result in path segments being removed during normalization.
Query parameters	Preserves and merges query parameters from both URIs.	Query parameters in the relative URI completely replace those in the base URI.
Fragment handling	Replaces the fragment in the base URI with the fragment in the relative URI.	Fragment in relative URI always replaces any fragment in the base URI.
Relative URI base	Works with both relative and absolute base URIs.	Throws an exception when the base URI is relative.
Empty relative URI	Returns the base URI unchanged.	May still perform normalization on the base URI.