HttpServerUtility.UrlEncode Method (String, TextWriter)

 

URL-encodes a string and sends the resulting output to a TextWriter output stream.

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

public void UrlEncode(
	string s,
	TextWriter output
)

Parameters

s
Type: System.String

The text string to encode.

output
Type: System.IO.TextWriter

The TextWriter output stream that contains the encoded string.

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.

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

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

The following example encodes a string for transmission by HTTP. It encodes the string named TestString, which contains the text "This is a <Test String>.", and copies it into the string named EncodedString as "This+is+a+%3cTest+String%3e.".

String TestString = "This is a <Test String>.";
StringWriter writer = new StringWriter();
Server.UrlEncode(TestString, writer);
String EncodedString = writer.ToString();

.NET Framework
Available since 1.1
Return to top
Show: