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 Sub UrlEncode (
	s As String,
	output As TextWriter
)

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

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

.NET Framework
Available since 1.1
Return to top
Show: