UriBuilder.Query プロパティ

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

UriBuilder.Query プロパティ

URI に含まれているクエリ情報を取得または設定します。

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

Visual Basic (宣言)

Public Property Query As
 String

Visual Basic (使用法)

Dim instance As UriBuilder
Dim value As String

value = instance.Query

instance.Query = value

C#

public string Query { get;
 set; }

C++

public:
property String^ Query {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_Query ()

/** @property */
public void set_Query (String value)

JScript

public function get Query
 () : String

public function set Query
 (value : String)

プロパティ値
URI に含まれているクエリ情報。

解説

Query プロパティには、URI 内のクエリ情報が含まれています。クエリ情報とパス情報とは疑問符 (?) で区切られており、疑問符の後から URI の最後までがクエリ情報の部分です。返されるクエリ情報には、クエリ情報の始まりを示す疑問符も含まれています。

クエリ情報は RFC 2396 に従ってエスケープされています。

メモ : バージョン 1.0 と 1.1 の .NET Framework では、Fragment プロパティをいずれかの値 (null 参照 (Visual Basic では Nothing) を含む) に設定すると、Query プロパティがクリアされ、Fragment プロパティを null 参照 (Visual Basic では Nothing) またはString.Empty に設定すると、このプロパティがクリアされます。ただし、バージョン 2.0 では、Fragment プロパティと Query プロパティは独立しています。

メモ   このプロパティに直接文字列を追加しないでください。Query の長さが 1 よりも大きい場合は、プロパティ値を文字列として取得し、先頭の疑問符を削除し、新しいクエリ文字列を追加して、連結文字列を使用してこのプロパティを設定します。

使用例

Query プロパティを設定する例を次に示します。

C#

UriBuilder baseUri = new UriBuilder("http://www.contoso.com/default.aspx?Param1=7890");
string queryToAppend = "param2=1234";

if (baseUri.Query != null && baseUri.Query.Length
 > 1)
    baseUri.Query = baseUri.Query.Substring(1) + "&" + queryToAppend;
 
else
    baseUri.Query = queryToAppend; 

C++

UriBuilder^ baseUri = gcnew UriBuilder 
    ("http://www.contoso.com/default.aspx?Param1=7890");
String^ queryToAppend = "param2=1234";
if (baseUri->Query != nullptr && baseUri->Query->Length
 > 1)
{
    baseUri->Query = baseUri->Query->Substring(1)+ "&" + queryToAppend;
}

else
{
    baseUri->Query = queryToAppend;
}

プラットフォーム

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

参照

関連項目
UriBuilder クラス
UriBuilder メンバ
System 名前空間