Share via


UriBuilder.Query Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets or sets any query information included in the URI.

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

Syntax

'Declaration
Public Property Query As String
public string Query { get; set; }

Property Value

Type: System.String
The query information included in the URI.

Remarks

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 3986.

Note    In Silverlight, the Fragment and Query properties are independent. Setting the Fragment property to any value, including nulla null reference (Nothing in Visual Basic), does not clear the Query property. Setting the Fragment property to String.Empty does not clear the Query property.

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.

Examples

The following example sets the Query property.

            UriBuilder baseUri = new UriBuilder("https://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; 

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

See Also

Reference