Utils.UriQueryHelper 1.0.0-alpha1

UriQuery

UriQuery is an unitility class that can be used to modify URI query strings. Can be uses with Uri or UriBuilder class objects to modify their Query property.

Usage

private const string BaseUri = "https://host.com:443/path";

[Test]
public void AddParameter()
{
    var target = new UriBuilder($"{BaseUri}?param1=value1");

    target.Query = UriQuery.Parse(target.Query).With("param2", "value2").GetQuery();

    Assert.That(target.ToString(), Is.EqualTo($"{BaseUri}?param1=value1&param2=value2"));
}

[Test]
public void OverrideExistingParameter()
{
    var target = new UriBuilder($"{BaseUri}?param1=value1");

    target.Query = UriQuery.Parse(target.Query).With("param1", "value2").GetQuery();

    Assert.That(target.ToString(), Is.EqualTo($"{BaseUri}?param1=value2"));
}

[Test]
public void AppendValueToParameter()
{
    var target = new UriBuilder($"{BaseUri}?param1=value1");

    target.Query = UriQuery.Parse(target.Query).Append("param1", "value2").GetQuery();

    Assert.That(target.ToString(), Is.EqualTo($"{BaseUri}?param1[]=value1&param1[]=value2"));
}

[Test]
public void RemoveParameter()
{
    var target = new UriBuilder($"{BaseUri}?param1=value1&param2=value2");

    target.Query = UriQuery.Parse(target.Query).Without("param1").GetQuery();

    Assert.That(target.ToString(), Is.EqualTo($"{BaseUri}?param2=value2"));
}

[Test]
public void RemoveValueFromMultiValuedParameter()
{
    var target = new UriBuilder($"{BaseUri}?param[]=value1&param[]=value2&param[]=value3");

    target.Query = UriQuery.Parse(target.Query).Without("param", "value2").GetQuery();

    Assert.That(target.ToString(), Is.EqualTo($"{BaseUri}?param[]=value1&param[]=value3"));
}

See UriQueryTests.cs file for other usage samples.