WebClient::QueryString Property
Gets or sets a collection of query name/value pairs associated with the request.
Assembly: System (in System.dll)
public: property NameValueCollection^ QueryString { NameValueCollection^ get(); void set(NameValueCollection^ value); }
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 = gcnew WebClient; // Create a new NameValueCollection instance to hold the QueryString parameters and values. NameValueCollection^ myQueryStringCollection = gcnew NameValueCollection; Console::Write( "Enter the word(s), separated by space character to search for in {0}: ", 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 {0} .......", 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 {0} was successful. Please see 'searchresult.htm' for results.", uriString );
Available since 1.1