Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

HttpServerUtility::UrlEncode Method (String^)

 

URL-encodes a string and returns the encoded string.

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

public:
String^ UrlEncode(
	String^ s
)

Parameters

s
Type: System::String^

The text to URL-encode.

Return Value

Type: System::String^

The URL-encoded text.

URL encoding ensures that all browsers will correctly transmit text in URL strings. Characters such as a question mark (?), ampersand (&), slash mark (/), and spaces might be truncated or corrupted by some browsers. As a result, these characters must be encoded in <a> tags or in query strings where the strings can be re-sent by a browser in a request string.

This method is a convenient way to access the HttpUtility::UrlEncode method at run time from an ASP.NET application. Internally, this method uses HttpUtility::UrlEncode to encode strings.

In the code-behind file for an ASP.NET web page, access an instance of the HttpServerUtility class through the Server property. In a class that is not in a code-behind file, use HttpContext.Current.Server to access an instance of the HttpServerUtility class.

Outside of a web application, use the WebUtility class to encode or decode values.

The following example shows how to URL-encode a value that is used as a query string value of a hyperlink. The code resides in the code-behind file for a web page. The value to encode is hard-coded in this example only to simplify the example and show the type of value you might URL-encode. Typically, you would URL-encode a value that you received from the user or the request. NextPage refers to a HyperLink control.

No code example is currently available or this language may not be supported.

The next example is similar to the previous example except it shows how to URL-encode a value from within a class that is not in the code-behind file.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Return to top
Show:
© 2017 Microsoft