.NET Framework Class Library
HttpUtility.UrlEncode Method (String)

Encodes a URL string.

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

Syntax

Visual Basic (Declaration)
Public Shared Function UrlEncode ( _
    str As String _
) As String
Visual Basic (Usage)
Dim str As String
Dim returnValue As String

returnValue = HttpUtility.UrlEncode(str)
C#
public static string UrlEncode (
    string str
)
C++
public:
static String^ UrlEncode (
    String^ str
)
J#
public static String UrlEncode (
    String str
)
JScript
public static function UrlEncode (
    str : String
) : String

Parameters

str

The text to encode.

Return Value

An encoded string.
Remarks

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 embedded in a block of text to be transmitted in a URL, the characters < and > are encoded as %3c and %3e.

Platforms

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

Version Information

.NET Framework

Supported in: 2.0, 1.1, 1.0
See Also

Tags :


Community Content

Paulo Morgado
Add information about the default encoding

This method uses the default encoding of utf-8.

Calling:

HttpUtility.UrlEncode("some text")

is the same as calling:

HttpUtility.UrlEncode("some text", Encoding.UTF8)
Tags :

Page view tracker