Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
QueryString Property

WebClient.QueryString Property

Gets or sets a collection of query name/value pairs associated with the request.

Namespace:  System.Net
Assembly:  System (in System.dll)

public NameValueCollection QueryString { get; set; }

Property Value

Type: System.Collections.Specialized.NameValueCollection
A NameValueCollection that contains query name/value pairs associated with the request. If no pairs are associated with the request, the value is an empty NameValueCollection.

The QueryString property contains a NameValueCollection instance containing name/value pairs that are appended to the URI as a query string. The contents of the QueryString property are preceded by a question mark (?), and name/value pairs are separated from one another by an ampersand (&).

The following code example takes user input from the command line and builds a NameValueCollection that is assigned to the QueryString property. It then downloads the response from the server to a local file.

			string uriString = "http://www.contoso.com/search";
			// Create a new WebClient instance.
			WebClient myWebClient = new WebClient();
			// Create a new NameValueCollection instance to hold the QueryString parameters and values.
			NameValueCollection myQueryStringCollection = new NameValueCollection();
			Console.Write("Enter the word(s), separated by space character to search for in " +  uriString + ": ");
			// Read user input phrase to search for at uriString. 
			string searchPhrase = Console.ReadLine();
			if (searchPhrase.Length > 1)
				// Assign the user-defined search phrase.
				myQueryStringCollection.Add("q",searchPhrase);
			else 
				// If error, default to search for 'Microsoft'.
				myQueryStringCollection.Add("q","Microsoft");		
			// Assign auxilliary parameters required for the search.
			Console.WriteLine("Searching " + uriString + " .......");
			// Attach QueryString to the WebClient.
			myWebClient.QueryString = myQueryStringCollection;
			// Download the search results Web page into 'searchresult.htm' for inspection.
			myWebClient.DownloadFile (uriString, "searchresult.htm");
			Console.WriteLine("\nDownload of " + uriString + " was successful. Please see 'searchresult.htm' for results.");

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft