WebClient.QueryString Properti

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

Sumber:

WebClient.cs

Mendapatkan atau mengatur kumpulan pasangan nama/nilai kueri yang terkait dengan permintaan.

public:
 property System::Collections::Specialized::NameValueCollection ^ QueryString { System::Collections::Specialized::NameValueCollection ^ get(); void set(System::Collections::Specialized::NameValueCollection ^ value); };

public System.Collections.Specialized.NameValueCollection QueryString { get; set; }

member this.QueryString : System.Collections.Specialized.NameValueCollection with get, set

Public Property QueryString As NameValueCollection

Nilai Properti

NameValueCollection

NameValueCollection yang berisi pasangan nama/nilai kueri yang terkait dengan permintaan. Jika tidak ada pasangan yang terkait dengan permintaan, nilainya adalah NameValueCollectionkosong.

Contoh

Contoh kode berikut mengambil input pengguna dari baris perintah dan membangun NameValueCollection yang ditetapkan ke properti QueryString. Kemudian mengunduh respons dari server ke file lokal.

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 );

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.");

Dim uriString As String = "http://www.contoso.com/search"
' Create a new WebClient instance.
Dim myWebClient As New WebClient()
' Create a new NameValueCollection instance to hold the QueryString parameters and values.
Dim myQueryStringCollection As New NameValueCollection()
Console.Write(("Enter the word(s), separated by space characters, to search for in " + uriString + ": "))
' Read user input phrase to search in uriString.
Dim searchPhrase As String = Console.ReadLine()
If searchPhrase.Length > 1 Then
    'Assign the user-defined search phrase.
    myQueryStringCollection.Add("q", searchPhrase)
' If error, default to search 'Microsoft'.
Else
    myQueryStringCollection.Add("q", "Microsoft")
End If 
' 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((ControlChars.Cr + "Download of " + uriString + " was successful. Please see 'searchresult.htm' for results."))

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Properti QueryString berisi instans NameValueCollection yang berisi pasangan nama/nilai yang ditambahkan ke URI sebagai string kueri. Konten properti QueryString didahului oleh tanda tanya (?), dan pasangan nama/nilai dipisahkan satu sama lain dengan ampersand (&).