WebClient.QueryString プロパティ

.NET Framework クラス ライブラリ リファレンス

WebClient.QueryString プロパティ

要求に関連付けられているクエリの名前/値ペアのコレクションを取得または設定します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Property QueryString As
 NameValueCollection

Visual Basic (使用法)

Dim instance As WebClient
Dim value As NameValueCollection

value = instance.QueryString

instance.QueryString = value

C#

public NameValueCollection QueryString { get;
 set; }

C++

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

J#

/** @property */
public NameValueCollection get_QueryString ()

/** @property */
public void set_QueryString (NameValueCollection
 value)

JScript

public function get QueryString
 () : NameValueCollection

public function set QueryString
 (value : NameValueCollection)

プロパティ値
要求に関連付けられているクエリの名前/値ペアを格納する NameValueCollection。要求に関連付けられているペアがない場合、この値は空の NameValueCollection です。

解説

QueryString プロパティは、クエリ文字列として URI に追加される名前/値ペアを含む NameValueCollection インスタンスを格納します。QueryString プロパティの内容の前には疑問符 (?) が付き、名前/値ペアはアンパサンド (&) で区切られます。

使用例

コマンド ラインからユーザー入力を受け取り、QueryString プロパティに割り当てる NameValueCollection を作成するコード例を次に示します。その後、サーバーからローカル ファイルに応答をダウンロードします。

Visual Basic

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

C#

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

C++

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

J#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
WebClient クラス
WebClient メンバ
System.Net 名前空間