Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

UriBuilder.Query Property

Gets or sets any query information included in the URI.

Namespace: System
Assembly: System (in system.dll)

public string Query { get; set; }
/** @property */
public String get_Query ()

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

public function get Query () : String

public function set Query (value : String)

Property Value

The query information included in the URI.

The Query property contains any query information included in the 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.

The query information is escaped according to RFC 2396.

Note   In version 1.0 and 1.1 of the .NET Framework, setting the Fragment property to any value, including a null reference (Nothing in Visual Basic), cleared the Query property, and setting the Fragment property to a null reference (Nothing in Visual Basic) or to String.Empty cleared the property. In version 2.0, however, the Fragment and Query properties are independent.

Note   Do not append a string directly to this property. 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.

The following example sets the Query property.

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; 

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

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.