HttpUtility::UrlEncode Method (String^, Encoding^)

 

Encodes a URL string using the specified encoding object.

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

public:
static String^ UrlEncode(
	String^ str,
	Encoding^ e
)

Parameters

str
Type: System::String^

The text to encode.

e
Type: System.Text::Encoding^

The Encoding object that specifies the encoding scheme.

Return Value

Type: System::String^

An encoded string.

This method can be used to encode the entire URL, including query-string values. If characters such as blanks and punctuation are passed in an HTTP stream, they might be misinterpreted at the receiving end. URL encoding converts characters that are not allowed in a URL into character-entity equivalents; URL decoding reverses the encoding. For example, when the characters < and > are embedded in a block of text to be transmitted in a URL, they are encoded as %3c and %3e.

To encode or decode values outside of a web application, use the WebUtility class.

.NET Framework
Available since 1.1
Return to top
Show: