WithQuery Method (Form, String)

Url WithQuery Method (Form, String)

C# API

Initialises a new instance of the Url class using the attributes of this Url, but with query data from the specified Form object percent-encoded using the supplied list of unsafeCharacters (replacing the existing query data if present).

Namespace: Facilita.Web
Assembly: clrWebBrowser (in clrWebBrowser.dll) Version: 9.5.7.98 (1.0.0.0)

Syntax

C++

Copy to Clipboard Print

public Url WithQuery(
	Form form,
	string unsafeCharacters
)

public Url WithQuery(
	Form form,
	string unsafeCharacters
)

Parameters

form: Type: Facilita.Web Form
A collection of key/value pairs represented as a HTML form.

unsafeCharacters: Type: System String
A list of unsafe characters that will be percent-encoded in the query data of the URL.

Return Value

A new Url object which is the same as this Url but with query data from the specified form.

Remarks

The form object will be percent-encoded using the supplied list of unsafeCharacters. See UrlEncode(String) for more information about percent-encoding.

Examples

The following example demonstrates adding a Form object to an existing Url, encoding the ~ character as %7E.

C++

Copy to Clipboard Print

IpEndPoint myServer = new IpEndPoint("www.myCompany.co.uk", 8080);
Url url = new Url(Protocol.HTTP, myServer, "index.php");

Form form = response.ExtractForm("contactForm");
form.GetInputElement("sessionID").Value = "~12345";

Url url2 = url.WithQuery(form, Coder.DefaultUnsafeCharacters + "~");
// This refers to http://www.myCompany.co.uk:8080/index.php?sessionID=12345

IpEndPoint myServer = new IpEndPoint("www.myCompany.co.uk", 8080);
Url url = new Url(Protocol.HTTP, myServer, "index.php");

Form form = response.ExtractForm("contactForm");
form.GetInputElement("sessionID").Value = "~12345";

Url url2 = url.WithQuery(form, Coder.DefaultUnsafeCharacters + "~");
// This refers to http://www.myCompany.co.uk:8080/index.php?sessionID=12345