UriBuilder.Query プロパティ

定義

URI に含まれているクエリ情報を取得または設定します。Gets or sets any query information included in the URI.

public:
 property System::String ^ Query { System::String ^ get(); void set(System::String ^ value); };
public string Query { get; set; }
member this.Query : string with get, set
Public Property Query As String

プロパティ値

URI に含まれているクエリ情報。The query information included in the URI.

次の例では、Query プロパティを設定します。The following example sets the Query property.

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

注釈

Query プロパティには、URI に含まれるすべてのクエリ情報が含まれています。The Query property contains any query information included in the URI. クエリ情報は、パス情報から疑問符 (?) で区切られ、URI の末尾に続きます。Query information is separated from the path information by a question mark (?) and continues to the end of the URI. 返されるクエリ情報には、先頭の疑問符が含まれます。The query information returned includes the leading question mark.

クエリ情報は、RFC 2396 に従ってエスケープされます。The query information is escaped according to RFC 2396.

メモ.NET Framework のバージョン1.0 および1.1 では、Fragment プロパティを nullを含む任意の値に設定し、Query プロパティをクリアし、Fragment プロパティを null に設定するか、プロパティをクリア String.Empty に設定します。Note In version 1.0 and 1.1 of the .NET Framework, setting the Fragment property to any value, including null, cleared the Query property, and setting the Fragment property to null or to String.Empty cleared the property. ただし、バージョン2.0 では、Fragment プロパティと Query プロパティは独立しています。In version 2.0, however, the Fragment and Query properties are independent.

メモこのプロパティには、文字列を直接追加しないでください。Note Do not append a string directly to this property. Query の長さが1より大きい場合は、プロパティ値を文字列として取得し、先頭の疑問符を削除して、新しいクエリ文字列を追加し、プロパティに結合文字列を設定します。If the length of Query is greater than 1, retrieve the property value as a string, remove the leading question mark, append the new query string, and set the property with the combined string.

適用対象

こちらもご覧ください