Export (0) Print
Expand All

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)

Not applicable.

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 Server 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 Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft